ImageGear for C and C++ on Linux v18.8 - Updated
IG_gctrl_item_get
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Global Control Parameter Functions > IG_gctrl_item_get

This function returns all information about global control parameter identified by name CtrlID.

Declaration:

 
Copy Code
AT_BOOL  ACCUAPI  IG_gctrl_item_get(
        LPCHAR CtrlID,
        LPAT_MODE lpnValType,
        LPVOID lpValue,
        DWORD dwValSize,
        LPDWORD lpdwValSize,
        LPCHAR lpTextInfo,
        DWORD dwTextBufSize,
        LPDWORD lpdwTextInfoSize
);

Arguments:

Name Type Description
CtrlID LPCHAR IN: The name of global control parameter.
lpnValType LPAT_MODE OUT: The type of global control parameter value.
lpValue LPVOID OUT: Buffer where to copy control parameter value.
dwValSize DWORD IN: Size of lpValue buffer in bytes.
lpdwValSize LPDWORD OUT: Actual size of parameter value in bytes.
lpTextInfo LPCHAR OUT: Buffer where to copy text description of global control parameter.
dwTextBufSize DWORD IN: Size of lpTextInfo buffer in bytes.
lpdwTextInfoSize LPDWORD OUT: Actual size of the text description of parameter.

Return Value:

TRUE if global parameter with given name is found; FALSE if it does not exist.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

Returns TRUE if parameter with given name is found, and FALSE if parameter with given name does not exist.

See also the section Working with Global Control Parameters.