ImageGear for C and C++ on Windows v19.1 - Updated
LPFNIG_ART_POSTCREATENOTIFYFUNC
API Reference Guide > ART Component API Reference > ART Component Callback Functions Reference > LPFNIG_ART_POSTCREATENOTIFYFUNC

This callback function is called just before a mark is displayed.

Declaration:

 
Copy Code
typedef BOOL (ACCUAPI *LPFNIG_ART_POSTREATENOTIFYFUNC)(
        HIGEAR hIGear, 
        LPVOID lpPrivate, 
        ART_MARK_INDEX hMarkIndex, 
        LPART_MARK_ATTRIBUTES lpMarkAttr
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle of an image.
lpPrivate LPVOID A far pointer to the private callback data.
hMarkIndex ART_MARK_INDEX The index number (identifier) for the new mark.
lpMarkAttr LPART_MARK_ATTRIBUTES A far pointer to an ART-defined attribute structure of type ART_MARK_ATTRIBUTES. This can be used to override the default mark attributes before the new created mark is displayed.

Return Value:

Returns TRUE - the mark attributes are changed; FALSE - no change.

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

Sample:

None

Remarks:

The MarkIndex passed into the callback is the MarkIndex of the created mark. This callback function gives the developer an opportunity to change any default named blocks or the mark attributes of the mark that is just created.

The callback for "Post create" occurs just after the end user draws the mark. For example, if the user draws a line, LPFNIG_ART_POSTCREATENOTIFYFUNC is called when the right mouse button is released and when the mark and all mark named blocks are created.

In order to use this callback, it must be registered with ART using the function ART_callback_register().