Note: The write functions in the PDSEdit API are not available in Adobe Reader.
typedef PDEContainer PDSMC; typedef CosObj PDSMCR; | |
The size of this data structure.
| |
The MCID of the content kid in question.
| |
The stream object containing the marked content in question.
| |
The object owning the stream, as defined by the StmOwn key in an OBJR.
| |
The page on which the marked content is drawn, whether directly as part of page content or indirectly by being in a Form XObject or annotation drawn on that page.
| |
|
Note: This method cannot access marked content inside a Form XObject.
void PDSMCGetInfo(CosObj containingObj, PDSMC mc, PDSMCInfoP info); containingObj | The CosObj containing the MC whose information is obtained. For marked content on a page, this is the Cos object representing the page. For marked content elsewhere, this is the stream in which the marked content resides.
|
mc | The marked content whose information is obtained.
|
info | (Filled by the method) A pointer to a structure that the method fills with information about
containingObj. |
is raised if an error is found in the PDF file. It will also raise the error if the PDSMC passed to it is not in the structure tree.
|
PDEContainer PDSMCGetPDEContainer(PDSMC mc); mc | The marked content whose container is obtained.
|
void PDSMCGetParent(IN CosObj containingObj, IN PDSMC mc, OUT PDSElement *parent); containingObj | The CosObj containing the MC whose parent is obtained. For marked content on a page, this is the Cos object representing the page. For marked content elsewhere, this is the stream in which the marked content resides.
|
mc | The marked content whose parent is obtained.
|
parent | (Filled by the method) The parent element of
containingObj. |
is raised if an error is found in the PDF file. It will also raise the error if the PDSMC passed to it is not in the structure tree.
|
ASBool PDSMCIDGetParent(ASInt32 mcid, CosObj containingObj, PDSElement *parent); mcid | The identifier (MCID) of the marked content whose parent is obtained.
|
containingObj | The CosObj containing the marked content whose parent is obtained. For marked content on a page, this is the Cos object representing the page. For marked content elsewhere, this is the stream in which the marked content resides.
|
parent | (Filled by the method) The parent element of
containingObj. |
is raised if an error is found in the PDF file. It will also raise the error if the PDSMC passed to it is not in the structure tree.
|
Creates a reference handle to a piece of marked content that can be used to associate the content with structure. The handle can persist beyond the lifetime of the marked contents, allowing greater flexibility about when structure information can be created.
This may raise various exceptions.
Note: This must be called before placing the container within the content stream that owns it.
Note: The handle will persist until PDSMCRefDestroy is called.
Note: All values in the PDSMCInfo object apart from mcid are currently ignored.
PDSMCRef PDSMCRefCreate(IN PDEElement container, IN CosDoc cosDoc, IN ASInt32 mcid); container | The marked content to create a reference for. It must be either a PDEContainer or PDEBeginContainer.
|
cosDoc | The document within which the reference will be used.
|
mcid | The mcid to set for the container.
|