Aspose::Words::DocumentBuilder::MoveToStructuredDocumentTag метод

DocumentBuilder::MoveToStructuredDocumentTag(const System::SharedPtr<Aspose::Words::Markup::StructuredDocumentTag>&, int32_t) method

Перемещает курсор к структурному тегу документа.

void Aspose::Words::DocumentBuilder::MoveToStructuredDocumentTag(const System::SharedPtr<Aspose::Words::Markup::StructuredDocumentTag> &structuredDocumentTag, int32_t characterIndex)
ПараметрТипОписание
structuredDocumentTagconst System::SharedPtr<Aspose::Words::Markup::StructuredDocumentTag>&Структурный тег документа, к которому нужно переместиться.
characterIndexint32_tИндекс символа внутри структурного тега документа. Отрицательное значение позволяет указать позицию от конца структурного тега документа. Используйте -1, чтобы переместиться в конец структурного тега документа. Если структурный тег документа находится на уровне блока и вы хотите переместить курсор в конец его последнего абзаца, укажите -2.

Примеры

Показывает, как переместить курсор DocumentBuilder внутри структурного тега документа.

auto doc = System::MakeObject<Aspose::Words::Document>(get_MyDir() + u"Structured document tags.docx");
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

// Существует несколько способов перемещения курсора:
// 1 -  Перейти к первому символу структурированного тега документа по индексу.
builder->MoveToStructuredDocumentTag(1, 1);

// 2 -  Перейти к первому символу структурированного тега документа по объекту.
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 -  Перейти к концу второго структурированного тега документа.
builder->MoveToStructuredDocumentTag(1, -1);
ASSERT_TRUE(builder->get_IsAtEndOfStructuredDocumentTag());

// Получить текущий выбранный структурированный тег документа.
builder->get_CurrentStructuredDocumentTag()->set_Color(System::Drawing::Color::get_Green());

doc->Save(get_ArtifactsDir() + u"Document.MoveToStructuredDocumentTag.docx");

См. также

DocumentBuilder::MoveToStructuredDocumentTag(int32_t, int32_t) method

Перемещает курсор к структурному тегу документа в текущем разделе.

void Aspose::Words::DocumentBuilder::MoveToStructuredDocumentTag(int32_t structuredDocumentTagIndex, int32_t characterIndex)
ПараметрТипОписание
structuredDocumentTagIndexint32_tИндекс структурированного тега документа, к которому нужно переместиться.
characterIndexint32_tИндекс символа внутри структурного тега документа. Отрицательное значение позволяет указать позицию от конца структурного тега документа. Используйте -1, чтобы переместиться в конец структурного тега документа. Если структурный тег документа находится на уровне блока и вы хотите переместить курсор в конец его последнего абзаца, укажите -2.

Примечания

Навигация выполняется внутри текущей истории текущего раздела. То есть, если вы переместили курсор к основному заголовку первого раздела, то structuredDocumentTagIndex указывает индекс структурированного тега документа внутри этого заголовка данного раздела.

Когда structuredDocumentTagIndex больше или равен 0, он указывает индекс от начала раздела, где 0 — первый структурированный тег документа. Когда structuredDocumentTagIndex меньше 0, он указывает индекс от конца раздела, где -1 — последний структурированный тег документа.

Примеры

Показывает, как переместить курсор DocumentBuilder внутри структурного тега документа.

auto doc = System::MakeObject<Aspose::Words::Document>(get_MyDir() + u"Structured document tags.docx");
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

// Существует несколько способов перемещения курсора:
// 1 -  Перейти к первому символу структурированного тега документа по индексу.
builder->MoveToStructuredDocumentTag(1, 1);

// 2 -  Перейти к первому символу структурированного тега документа по объекту.
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 -  Перейти к концу второго структурированного тега документа.
builder->MoveToStructuredDocumentTag(1, -1);
ASSERT_TRUE(builder->get_IsAtEndOfStructuredDocumentTag());

// Получить текущий выбранный структурированный тег документа.
builder->get_CurrentStructuredDocumentTag()->set_Color(System::Drawing::Color::get_Green());

doc->Save(get_ArtifactsDir() + u"Document.MoveToStructuredDocumentTag.docx");

См. также

Aspose::Words::DocumentBuilder::MoveToSection method Aspose::Words::DocumentBuilder::PopFont метод