C++
Publisher calls the HrBeginStructNode method to specify the start of a document-
structure node for content that encompasses multiple complete pages in the document.
Document-structure nodes for elements of the document that reside entirely within a
page (for example, paragraphs) are embedded by Publisher in the enhanced metafile
(EMF) itself using the DocExComment_BeginStructNode and
DocExComment_EndStructNode structures. For more information about document-
structure nodes, see the sections HrAddPageFromEmf and
DocExComment_BeginStructNode in this article.
C++
The idNodeParent parameter specifies the ID of the node that is the parent of the node
being passed to the add-in. If this parameter is 0, the node is located under the root of
the document-structure tree. Multiple sibling nodes may be located under the root. If
this parameter is -1, the node is located under the currently open node, that is, under
the last node specified by HrBeginStructNode that has not been closed by a call to
HrEndStructNode.
The iSortOrder parameter specifies the sort order of the structure node among its
siblings. No two nodes can have the same sort order. However, the set of integers that
constitute the sort order need not be contiguous. A value of -1 indicates that the sibling
sort order is the same order in which the nodes appear in the EMF comments.
The pnode parameter points to an MSODOCEXSTRUCTNODE structure, which has the
following declaration:
C++
void EnableCancel(
    IMsoDocExCancel* pdec
);
HrBeginStructNode
HRESULT HrBeginStructNode(
    int idNodeParent, 
    int iSortOrder, 
    const MSODOCEXSTRUCTNODE* pnode, 
    BOOL fNoEndNode
);