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

Gets the graphics state information for an element.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_PDE_element_get_gstate(
        HIG_PDE_ELEMENT hElement,
        LPAT_PDE_GRAPHICSTATE lpGstate
);

Arguments:

Name Type Description
hElement HIG_PDE_ELEMENT An element whose graphics state is obtained.
lpGstate LPAT_PDE_GRAPHICSTATE Pointer to AT_PDE_GRAPHICSTATE structure that contains graphics state information for hElement. This graphics state information may contain PDE objects for color spaces or an ExtGState. They are not acquired by this function. 
For a PDE Image, only the ExtGState value is used for images. For indexed images, the fill color space and values are categorized in the PDE Image object.

Return Value:

Error count.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

This function is only valid for PDE Form, PDE Image, PDE Path, and PDE Shading elements.

Non-NULL objects in the graphic state, such as the fill and stroke color spaces, have their reference counts incremented by this function. Be sure to release these non-NULL objects when disposing of lpGstate.