typedef struct _t_PDEClip *PDEClip; ASBool PDEClipEnumProc(IN PDEElement elem, IN void *clientData); elem | IN/OUT The PDEElement currently being enumerated.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDEClipFlattenedEnumElems().
|
Note: This method increments the reference count of pdeElement.
void PDEClipAddElem(IN PDEClip clip, IN ASInt32 addAfterIndex, /* kPDEBeforeFirst */ IN PDEElement pdeElement); clip | IN/OUT The clip path to which an element is added.
|
addAfterIndex | IN/OUT The index after which to add
pdeElement. Use kPDEBeforeFirst to insert an element at the beginning of the clip object. |
pdeElement | IN/OUT The element added, which may be a PDEPath, a PDEText, a PDEContainer, a PDEGroup, or a PDEPlace object.
|
Makes a deep copy of a PDEClip object.
Call PDERelease() to dispose of the returned clip object when finished with it.
It raises an exception if it is unable to allocate memory.
PDEClip PDEClipCopy(IN PDEClip srcClip); srcClip | IN/OUT The clipping path to copy.
|
srcClip. Creates an empty clip object. This represents a clipping object that has no effect on elements that refer to it.
Call PDERelease() to dispose of the returned clip object when finished with it.
It raises an exception if it is unable to allocate memory.
PDEClip PDEClipCreate(void); ASBool PDEClipFlattenedEnumElems(IN PDEClip clip, IN PDEClipEnumProc enumProc, IN void *enumProcClientData); clip | The PDEClip to enumerate.
|
enumProc | Called with each flattened element. Enumeration continues until all elements have been enumerated, or until
enumProc returns false. |
enumProcClientData | A pointer to user-supplied data to pass to
enumProc each time it is called. |
Note: This method does not change the reference count of the returned PDEElement.
PDEElement PDEClipGetElem(IN PDEClip clip, IN ASInt32 index); clip | IN/OUT The clip object from which an element is obtained.
|
index | IN/OUT The index of the element to get from
clip. |
Gets the number of top-level elements in a clip object. Top-level elements may be a path or charpath, a marked content container or place, or a group.
Paths are represented as PDEPath objects; charpaths are represented as PDEText objects.
Note: PDEGroup is not a persistent object. You cannot save to PDF and re-get group objects.
ASInt32 PDEClipGetNumElems(IN PDEClip clip); clip | IN/OUT The clip object to examine.
|
clip contains PDEGroup objects, this method returns the top-level PDEPath, PDEText, PDEContainer, PDEGroup, or PDEPlace object. Use PDEClipFlattenedEnumElems() to see only the PDEPath and PDEText objects. Note: This method decrements the reference count of each of the elements.
void PDEClipRemoveElems(IN PDEClip clip, IN ASInt32 index, IN ASInt32 count); clip | IN/OUT The clip object from which an element is removed.
|
index | IN/OUT The first element to remove.
|
count | IN/OUT The number of elements to remove.
|