ImageGear Professional DLL v17.1 for Windows Accusoft
ART_GUI_text_overflow_check
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > ARTGUI Component API Reference > ARTGUI Component Functions Reference > ART_GUI_text_overflow_check

Glossary Item Box

This function checks the mark with text overflowed.

Declaration:

  Copy Code
AT_ERRCOUNT ART_GUI_text_overflow_check( 
        HIGEAR hIGear, 
        DWORD dwGrpID,
        HWND hWnd, 
        ART_MARK_INDEX hMarkIndex,
        LPAT_RECT lprcPreferableBounds,
        LPDWORD lpdwOverflowedTextLength
);

Arguments:

hIGear HIGEAR handle to the image.
dwGrpID Identifier of group.
hWnd Windows handle to the image window to draw marks.
hMarkIndex Identifier of the mark.
lprcPreferableBounds Returns preferable mark bounds to draw whole mark text (cut to clip bounds).
lpdwOverflowed TextLength Returns the length of overflowed text (the last NULL is not included) or 0.

Return Value:

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

Supported Raster Image Formats:

All pixel formats supported by ImageGear Professional.

Sample:

Annotation

Example:

See example for LPFNIG_ART_TEXTOVERFLOWNOTIFYFUNC callback function.

Remarks:

It can be applied for ART_MARK_TYPED_TEXT, ART_MARK_ATTACH_A_NOTE and ART_MARK_TEXT_FROM_FILE marks only. If the mark has overflowed text the lpdwOverflowedTextLength returns the number of overflowed text characters. Otherwise it returns 0.

The lprcPreferableBounds returns rectangle of mark bounds enough to draw the whole text. It is made by expanding the mark bounds in direction the drawn text (from top to bottom direction) is cut to the image window clip bounds.

©2012. Accusoft Corporation. All Rights Reserved.