ImageGear for C and C++ on Linux v18.8 - Updated
IG_PDE_textitem_create
API Reference Guide > PDF Component API Reference > PDF Component Objects Reference > Page Editing Objects and Elements > HIG_PDE_TEXTITEM > IG_PDE_textitem_create

Creates a text item element containing a character or text run, which can be added to a PDE Text object.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_PDE_textitem_create(
        LPBYTE lpText, 
        UINT nTextLen,
        HIG_PDE_FONT hFont, 
        LPAT_PDE_GRAPHICSTATE lpGstate, 
        LPAT_PDE_TEXTSTATE lpTstate,
        LPAT_PDF_FIXEDMATRIX lpTextMatrix
        LPHIG_PDE_TEXTITEM lphTextItem
);

Arguments:

Name Type Description
lpText LPBYTE Pointer to the characters to add. 
Passing NULL for text can invalidate the text object but will not raise an error. Callers must not pass NULL for this parameter.
nTextLen UINT Length of the text, in bytes.
hFont HIG_PDE_FONT Font for the element.
lpGstate LPAT_PDE_GRAPHICSTATE Pointer to AT_PDE_GRAPHICSTATE structure with the graphics state for the element.
lpTstate LPAT_PDE_TEXTSTATE Pointer to AT_PDE_TEXTSTATE structure with text state for the element.
lpTextMatrix LPAT_PDF_FIXEDMATRIX Pointer to AT_PDF_FIXEDMATRIX that holds the matrix for the element.
lphTextItem LPHIG_PDE_TEXTITEM A text element object.

Return Value:

Error count.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

Call IG_PDE_element_release to dispose the created object when finished with it.