Aspose::Words::DocumentBuilder::MoveToStructuredDocumentTag method
Contents
[
Hide
]DocumentBuilder::MoveToStructuredDocumentTag(const System::SharedPtr<Aspose::Words::Markup::StructuredDocumentTag>&, int32_t) method
Moves the cursor to the structured document tag.
void Aspose::Words::DocumentBuilder::MoveToStructuredDocumentTag(const System::SharedPtr<Aspose::Words::Markup::StructuredDocumentTag> &structuredDocumentTag, int32_t characterIndex)
| Parameter | Type | Description |
|---|---|---|
| structuredDocumentTag | const System::SharedPtr<Aspose::Words::Markup::StructuredDocumentTag>& | The structured document tag to move to. |
| characterIndex | int32_t | The index of the character inside the structured document tag. A negative value allows you to specify a position from the end of the structured document tag. Use -1 to move to the end of the structured document tag. If the structured document tag is at the block level, and you want to move the cursor to the end of its last paragraph, specify -2. |
Examples
Shows how to move cursor of DocumentBuilder inside a structured document tag.
auto doc = System::MakeObject<Aspose::Words::Document>(get_MyDir() + u"Structured document tags.docx");
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);
// There is a several ways to move the cursor:
// 1 - Move to the first character of structured document tag by index.
builder->MoveToStructuredDocumentTag(1, 1);
// 2 - Move to the first character of structured document tag by object.
auto tag = System::ExplicitCast<Aspose::Words::Markup::StructuredDocumentTag>(doc->GetChild(Aspose::Words::NodeType::StructuredDocumentTag, 2, true));
builder->MoveToStructuredDocumentTag(tag, 1);
builder->Write(u" New text.");
ASSERT_EQ(u"R New text.ichText", tag->GetText().Trim());
// 3 - Move to the end of the second structured document tag.
builder->MoveToStructuredDocumentTag(1, -1);
ASSERT_TRUE(builder->get_IsAtEndOfStructuredDocumentTag());
// Get currently selected structured document tag.
builder->get_CurrentStructuredDocumentTag()->set_Color(System::Drawing::Color::get_Green());
doc->Save(get_ArtifactsDir() + u"Document.MoveToStructuredDocumentTag.docx");
See Also
- Class StructuredDocumentTag
- Class DocumentBuilder
- Namespace Aspose::Words
- Library Aspose.Words for C++
DocumentBuilder::MoveToStructuredDocumentTag(int32_t, int32_t) method
Moves the cursor to a structured document tag in the current section.
void Aspose::Words::DocumentBuilder::MoveToStructuredDocumentTag(int32_t structuredDocumentTagIndex, int32_t characterIndex)
| Parameter | Type | Description |
|---|---|---|
| structuredDocumentTagIndex | int32_t | The index of the structured document tag to move to. |
| characterIndex | int32_t | The index of the character inside the structured document tag. A negative value allows you to specify a position from the end of the structured document tag. Use -1 to move to the end of the structured document tag. If the structured document tag is at the block level, and you want to move the cursor to the end of its last paragraph, specify -2. |
Remarks
The navigation is performed inside the current story of the current section. That is, if you moved the cursor to the primary header of the first section, then structuredDocumentTagIndex specified the index of the structured document tag inside that header of that section.
When structuredDocumentTagIndex is greater than or equal to 0, it specifies an index from the beginning of the section with 0 being the first structured document tag. When structuredDocumentTagIndex is less than 0, it specified an index from the end of the section with -1 being the last structured document tag.
Examples
Shows how to move cursor of DocumentBuilder inside a structured document tag.
auto doc = System::MakeObject<Aspose::Words::Document>(get_MyDir() + u"Structured document tags.docx");
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);
// There is a several ways to move the cursor:
// 1 - Move to the first character of structured document tag by index.
builder->MoveToStructuredDocumentTag(1, 1);
// 2 - Move to the first character of structured document tag by object.
auto tag = System::ExplicitCast<Aspose::Words::Markup::StructuredDocumentTag>(doc->GetChild(Aspose::Words::NodeType::StructuredDocumentTag, 2, true));
builder->MoveToStructuredDocumentTag(tag, 1);
builder->Write(u" New text.");
ASSERT_EQ(u"R New text.ichText", tag->GetText().Trim());
// 3 - Move to the end of the second structured document tag.
builder->MoveToStructuredDocumentTag(1, -1);
ASSERT_TRUE(builder->get_IsAtEndOfStructuredDocumentTag());
// Get currently selected structured document tag.
builder->get_CurrentStructuredDocumentTag()->set_Color(System::Drawing::Color::get_Green());
doc->Save(get_ArtifactsDir() + u"Document.MoveToStructuredDocumentTag.docx");
See Also
- Class DocumentBuilder
- Namespace Aspose::Words
- Library Aspose.Words for C++