ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / ARTGUI Component API Reference / ARTGUI Component Functions Reference / ART_GUI_property_sheet_query
In This Topic
    ART_GUI_property_sheet_query
    In This Topic

    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.