This callback operates similar to the LPFNIG_ART_DRAWNOTIFYFUNC callback.
Declaration:
Copy Code | |
---|---|
typedef BOOL (ACCUAPI *LPFNIG_ART_OVERRIDEDRAWNOTIFYFUNC)( HIGEAR hIGear, DWORD dwGrpID, LPVOID lpPrivate, HDC hDC, AT_MODE nWhen, ART_MARK_INDEX hMarkIndex, const LPART_MARK_ATTRIBUTES lpMarkAttr, const LPAT_RECT lprcClip, const LPAT_RECT lprcBounds, AT_MODE nOrientation ); |
Arguments:
hIGear | HIGEAR handle to the image. |
dwGrpID | Identifier of group. |
lpPrivate | A far pointer that takes private callback data. |
hDC | Windows handle to the drawing device. |
nWhen | Before or after image. |
hMarkIndex | Index for the mark. |
lpMarkAttr | Set to the ART_MARK_ATTRIBUTES structure of the mark to draw. |
lprcClip | Set to the AT_RECT coordinates of the clipping rectangle. |
lprcBounds | The scaled bounds of the mark. |
nOrientation | The orientation of the mark. Set to an AT_MODE constant (defined in Gear.h) that begins with IG_ROTATE_ . |
Return Value:
Returns FALSE if the callback did not handle the drawing of the mark, and the library did.
Supported Raster Image Formats:
All pixel formats supported by ImageGear Professional.
Sample:
None
Remarks:
This callback is called for known marks, instead of user-defined marks. The purpose of this callback is to let the developer draw the standard marks, instead of letting the library do it.
All of the parameters are the same as LPFNIG_ART_DRAWNOTIFYFUNC. The return value is different. When this callback returns TRUE, it means that the library does not draw the mark. When it returns FALSE, the callback did not handle the drawing of the mark and the library draws the mark. This callback can be used to draw all mark types or just a few marks. The developer can check the dwType field of the lpMarkAttr parameter to determine if they want to draw this type of mark, or let the library handle it.
Finally the nOrientation parameter tells the callback how to orient the mark when drawn. Possible values include IG_ROTATE_0, IG_ROTATE_90, IG_ROTATE_180 and IG_ROTATE_270.
In order to use this callback, it must be registered with ART using the function ART_callback_register(). |