IG_gctrl_item

This function sets the value to global control parameter.

Please see Global Control Parameters for a list of all the corresponding types to use.

Declaration:

	Copy Code
AT_ERRCODE ACCUAPI IG_gctrl_item_set( LPCHAR CtrlID, AT_MODE nValueType, LPVOID lpValue, DWORD dwValueSize, LPCHAR lpTextInfo );

Arguments:

Name	Type	Description
CtrlID	LPCHAR	IN: The name of global control parameter in form "<GRPNAME>.<Param name>".
nValueType	AT_MODE	IN: The type of global control parameter value. Constant of kind AM_TID_...
lpValue	LPVOID	IN: Pointer to global control parameter value data.
dwValueSize	DWORD	IN: Size of global control parameter value data (size of buffer lpValue)
lpTextInfo	LPCHAR	IN: Text description of global control parameter value.

Return Value:

Return value is a code of last error or NULL if success.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

None

Remarks:

If parameter with given name ControlID does not exist, then it is added. If control parameter with given value exists and callback function for it is not NULL then callback is called exactly after value is changed by this function. If lpTextInfo is not NULL, then previous value of this field is changed to new value, but if NULL then it is not changed.

See also the section Working with Global Control Parameters.