ImageGear for C and C++ on Windows v19.1 - Updated
ART_GUI_property_sheet_query
API Reference Guide > ARTGUI Component API Reference > ARTGUI Component Functions Reference > ART_GUI_property_sheet_query

This function reads the settings of the property sheet referenced by hPropertySheet, and is called when the user clicks OK.

Declaration:

 
Copy Code
BOOL FAR PASCAL ART_GUI_property_sheet_query(
        HARTPROPSHEET hPropertySheet,
        AT_MODE fQueryFlags, 
        LPART_MARK_ATTRIBUTES lpMarkAttr, 
        const LPART_BLOCK_NAME lpBlockName, 
        LPVOID lpBlockData, 
        LPDWORD lpBlockSize
);

Arguments:

Name Type Description
hPropertySheet HARTPROPSHEET ART handle to the Property Sheet.
fQueryFlags AT_MODE Query flags.
lpMarkAttr LPART_MARK_ATTRIBUTES Attributes return.
lpBlockName const LPART_BLOCK_NAME Named block name.
lpBlockData LPVOID Block Data return, or NULL.
lpBlockSize LPDWORD Block size return.

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

Annotation

Remarks:

fQueryFlags is a bit flag that queries ART_MARK_ATTRIBUTES structure and one or more named blocks. When changes are made to the property sheet that reflect properties stored in the ART_MARK_ATTRIBUTES structure, call ART_mark_modify() to update the structure. If changes were made to a named block, call ART_mark_block_create() to overwrite the old data with the new data.