ImageGear for C and C++ on Windows v19.6 - Updated
IG_PDE_clip_get_element_count
API Reference Guide > PDF Component API Reference > PDF Component Objects Reference > Page Editing Objects and Elements > HIG_PDE_CLIP > IG_PDE_clip_get_element_count

Gets the number of top-level elements in a clip object.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_PDE_clip_get_element_count(
        HIG_PDE_CLIP hClip,
        LPUINT lpnCount
);

Arguments:

Name Type Description
hClip HIG_PDE_CLIP The clip object to examine.
lpnCount LPUINT Number of path and charpath elements in clip. If clip contains PDE Groups, this function returns the top-level PDE Path, PDE Text, PDE Container, PDE Group, or PDE Place object. Use IG_PDE_clip_enumerate_elements to see only the PDE Path and PDE Text objects. 
PDEGroup is not a persistent object. You cannot save to PDF and re-get group objects.

Return Value:

Error count.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

Top-level elements may be a path or char-path, a marked content container or place, or a group.

Paths are represented as PDE Path objects; char-paths are represented as PDE Text objects.