ImageGear for C and C++ on Linux v19.10 - Updated
IG_PDE_text_get_quad
API Reference Guide > PDF Component API Reference > PDF Component Objects Reference > Page Editing Objects and Elements > HIG_PDE_TEXT > IG_PDE_text_get_quad

Gets the quad bounding the specified text run or character.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_PDE_text_get_quad(
        HIG_PDE_TEXT hText,
        UINT nFlags,
        UINT nIndex,
        LPAT_PDF_FIXEDQUAD lpQuad 
);

Arguments:

Name Type Description
hText HIG_PDE_TEXT Text object containing a character or text run whose text is examined.
nFlags UINT enumIGPDETextFlags value that specifies whether index refers to the character offset from the beginning of the text object or the index of the text run in the text object. Must be either:
  • IG_PDE_TEXT_CHAR - for a text character
  • IG_PDE_TEXT_RUN - for a text run
In addition, if the IG_PDE_TEXT_GET_BOUNDS flag is set, this function uses the font descriptor's FontBBox, which is the smallest rectangle that encloses all characters in the font. The advance portion is based on the x-coordinates of the left and right sides of FontBBox and the advance width.
nIndex UINT Index of the character or text run in the text object.
lpQuad LPAT_PDF_FIXEDQUAD Pointer to AT_PDF_FIXEDQUAD that bounds the specified character or text run.

Return Value:

Error count.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

The advance portion of the quad is based on the left side bearing and advance width.