PA_SetAdvancedProperties

version 2003

PA_SetAdvancedProperties (params; data; dataSize)

Parameter	Type		Description
params	PA_PluginParameters		Parameters received in PluginMain
data	void*		Pointer to advanced properties data
dataSize	long		Data size in bytes

The routine PA_SetAdvancedProperties tells 4th Dimension to "link" the advanced properties to that particular area. This way, the advanced properties can be retrieved from eAE_AreaInit at Runtime.

params is the PA_PluginParameters the plug-in received in its PluginMain routine.

data is a pointer to the memory block that holds the advanced properties.

dataSize is the data size in bytes.

This routine must be called when PA_GetAreaEvent returns eAE_EditAdvancedProperties. Otherwise, it does nothing and PA_GetLastError returns eER_BadEventCall.

Area event eAE_EditAdvancedProperties will be followed by the eAE_DisposeAdvancedProperties to tell the area to release the data buffer given to 4D.

See the complete sample in Create and use an external area.

Create and use an external area, PA_GetAdvancedProperties, PA_GetAdvancedPropertiesToDispose, PA_SetAdvancedPropertiesEditable.

Use PA_GetLastError to see if an error occurred (eER_BadEventCall).