This class allows to compute page numbers of document nodes.
When you create a LayoutCollector and specify a Document document object to attach to, the collector will record mapping of document nodes to layout objects when the document is formatted into pages.
You will be able to find out on which page a particular document node (e.g. run, paragraph or table cell) is located by using the GetStartPageIndex(), GetEndPageIndex() and GetNumPagesSpanned() methods. These methods automatically build page layout model of the document and update fields if required.
When you no longer need to collect layout information, it is best to set the Document property to null to avoid unnecessary collection of more layout mappings.
Shows how to see the the ranges of pages that a node spans.
#include <Aspose.Words.Cpp/Layout/LayoutCollector.h>
Public Member Functions | |
LayoutCollector (SharedPtr< Document > doc) | |
Initializes an instance of this class. More... | |
void | Clear () |
Clears all collected layout data. Call this method after document was manually updated, or layout was rebuilt. More... | |
SharedPtr< Document > | get_Document () const |
Gets or sets the document this collector instance is attached to. More... | |
int32_t | GetEndPageIndex (SharedPtr< Node > node) |
Gets 1-based index of the page where node ends. Returns 0 if node cannot be mapped to a page. More... | |
SharedPtr< Object > | GetEntity (SharedPtr< Node > node) |
Returns an opaque position of the LayoutEnumerator which corresponds to the specified node. You can use returned value as an argument to Current given the document being enumerated and the document of the node are the same. More... | |
int32_t | GetNumPagesSpanned (SharedPtr< Node > node) |
Gets number of pages the specified node spans. 0 if node is within a single page. This is the same as GetEndPageIndex() - GetStartPageIndex(). More... | |
int32_t | GetStartPageIndex (SharedPtr< Node > node) |
Gets 1-based index of the page where node begins. Returns 0 if node cannot be mapped to a page. More... | |
virtual const TypeInfo & | GetType () const override |
virtual bool | Is (const TypeInfo &target) const override |
void | set_Document (SharedPtr< Document > value) |
Setter for get_Document. More... | |
Static Public Member Functions | |
static const TypeInfo & | Type () |
Aspose::Words::Layout::LayoutCollector::LayoutCollector | ( | System::SharedPtr< Aspose::Words::Document > | doc | ) |
Initializes an instance of this class.
doc | The document to which this collector instance will be attached to. |
Shows how to see the the ranges of pages that a node spans.
void Aspose::Words::Layout::LayoutCollector::Clear | ( | ) |
Clears all collected layout data. Call this method after document was manually updated, or layout was rebuilt.
Shows how to see the the ranges of pages that a node spans.
System::SharedPtr<Aspose::Words::Document> Aspose::Words::Layout::LayoutCollector::get_Document | ( | ) | const |
Gets or sets the document this collector instance is attached to.
Shows how to see the the ranges of pages that a node spans.
int32_t Aspose::Words::Layout::LayoutCollector::GetEndPageIndex | ( | System::SharedPtr< Aspose::Words::Node > | node | ) |
Gets 1-based index of the page where node ends. Returns 0 if node cannot be mapped to a page.
Shows how to see the the ranges of pages that a node spans.
System::SharedPtr<System::Object> Aspose::Words::Layout::LayoutCollector::GetEntity | ( | System::SharedPtr< Aspose::Words::Node > | node | ) |
Returns an opaque position of the LayoutEnumerator which corresponds to the specified node. You can use returned value as an argument to Current given the document being enumerated and the document of the node are the same.
This method works for only Paragraph nodes, as well as indivisible inline nodes, e.g. BookmarkStart or Shape. It doesn't work for Run, CellRow or Table nodes, and nodes within header/footer.
Note that the entity returned for a Paragraph node is a paragraph break span. Use the appropriate method to ascend to the parent line
If you need to navigate to a Run of text then you can insert bookmark right before it and then navigate to the bookmark instead.
If you need to navigate to a Cell node then you can move to a Paragraph node in this cell and then ascend to a parent entity. The same approach can be used for Row and Table nodes.
Shows how to see the the ranges of pages that a node spans.
int32_t Aspose::Words::Layout::LayoutCollector::GetNumPagesSpanned | ( | System::SharedPtr< Aspose::Words::Node > | node | ) |
Gets number of pages the specified node spans. 0 if node is within a single page. This is the same as GetEndPageIndex() - GetStartPageIndex().
Shows how to see the the ranges of pages that a node spans.
int32_t Aspose::Words::Layout::LayoutCollector::GetStartPageIndex | ( | System::SharedPtr< Aspose::Words::Node > | node | ) |
Gets 1-based index of the page where node begins. Returns 0 if node cannot be mapped to a page.
Shows how to see the the ranges of pages that a node spans.
|
overridevirtual |
Reimplemented from System::Object.
|
overridevirtual |
Reimplemented from System::Object.
void Aspose::Words::Layout::LayoutCollector::set_Document | ( | System::SharedPtr< Aspose::Words::Document > | value | ) |
|
static |