## Run class Представляет последовательность символов с одинаковым форматированием шрифта. Чтобы узнать больше, посетите статью документации [Programming with Documents](https://docs.aspose.com/words/cpp/programming-with-documents/). ```cpp class Run : public Aspose::Words::Inline ``` ## Методы | Метод | Описание | | --- | --- | | [Accept](./accept/)(System::SharedPtr\) override | Принимает посетителя. | | [Clone](../node/clone/)(bool) | Создаёт дубликат узла. | | [get_CustomNodeId](../node/get_customnodeid/)() const | Указывает пользовательский идентификатор узла. | | virtual [get_Document](../node/get_document/)() const | Возвращает документ, к которому принадлежит этот узел. | | [get_Font](../inline/get_font/)() | Предоставляет доступ к форматированию шрифта этого объекта. | | virtual [get_IsComposite](../node/get_iscomposite/)() | Возвращает **true**, если этот узел может содержать другие узлы. | | [get_IsDeleteRevision](../inline/get_isdeleterevision/)() | Возвращает true, если этот объект был удалён в Microsoft Word при включённом отслеживании изменений. | | [get_IsFormatRevision](../inline/get_isformatrevision/)() | Возвращает true, если форматирование объекта было изменено в Microsoft Word при включённом отслеживании изменений. | | [get_IsInsertRevision](../inline/get_isinsertrevision/)() | Возвращает true, если этот объект был вставлен в Microsoft Word при включённом отслеживании изменений. | | [get_IsMoveFromRevision](../inline/get_ismovefromrevision/)() | Возвращает **true**, если этот объект был перемещён (удалён) в Microsoft Word при включённом отслеживании изменений. | | [get_IsMoveToRevision](../inline/get_ismovetorevision/)() | Возвращает **true**, если этот объект был перемещён (вставлен) в Microsoft Word при включённом отслеживании изменений. | | [get_IsPhoneticGuide](./get_isphoneticguide/)() | Возвращает логическое значение, указывающее, является ли прогон фонетическим руководством. | | [get_NextNode](../node/get_nextnode/)() const | | | [get_NextSibling](../node/get_nextsibling/)() | Возвращает узел, непосредственно следующий за этим узлом. | | [get_NodeType](./get_nodetype/)() const override | Возвращает [Run](../nodetype/). | | [get_ParentNode](../node/get_parentnode/)() | Возвращает непосредственного родителя этого узла. | | [get_ParentParagraph](../inline/get_parentparagraph/)() | Получает родительский [Paragraph](../paragraph/) этого узла. | | [get_PhoneticGuide](./get_phoneticguide/)() | Возвращает объект [PhoneticGuide](./get_phoneticguide/). | | [get_PreviousSibling](../node/get_previoussibling/)() | Возвращает узел, непосредственно предшествующий этому узлу. | | [get_PrevNode](../node/get_prevnode/)() const | | | [get_Range](../node/get_range/)() | Возвращает объект [Range](../range/), представляющий часть документа, содержащуюся в этом узле. | | [get_Text](./get_text/)() const | Получает или задает текст прогона. | | [GetAncestor](../node/getancestor/)(Aspose::Words::NodeType) | Получает первого предка указанного [NodeType](../nodetype/). | | [GetAncestorOf](../node/getancestorof/)() | | | [GetText](./gettext/)() override | Получает текст прогона. | | [GetType](./gettype/)() const override | | | [Is](./is/)(const System::TypeInfo\&) const override | | | [IsAncestorNode](../node/isancestornode/)(const System::SharedPtr\\&) | | | [NextPreOrder](../node/nextpreorder/)(const System::SharedPtr\\&) | Получает следующий узел согласно алгоритму обхода дерева в порядке предобхода. | | static [NodeTypeToString](../node/nodetypetostring/)(Aspose::Words::NodeType) | Вспомогательный метод, преобразующий значение перечисления типа узла в удобочитаемую строку. | | [PreviousPreOrder](../node/previouspreorder/)(const System::SharedPtr\\&) | Получает предыдущий узел согласно алгоритму обхода дерева в порядке предобхода. | | [Remove](../node/remove/)() | Удаляет себя из родительского узла. | | [Run](./run/)(const System::SharedPtr\\&) | Инициализирует новый экземпляр класса [Run](./). | | [Run](./run/)(const System::SharedPtr\\&, const System::String\&) | Инициализирует новый экземпляр класса **Run**. | | [set_CustomNodeId](../node/set_customnodeid/)(int32_t) | Сеттер для [Aspose::Words::Node::get_CustomNodeId](../node/get_customnodeid/). | | [set_NextNode](../node/set_nextnode/)(const System::SharedPtr\\&) | | | [set_PrevNode](../node/set_prevnode/)(const System::SharedPtr\\&) | | | [set_Text](./set_text/)(const System::String\&) | Сеттер для [Aspose::Words::Run::get_Text](./get_text/). | | [SetParent](../node/setparent/)(const System::SharedPtr\\&) | | | [ToString](../node/tostring/)(Aspose::Words::SaveFormat) | Экспортирует содержимое узла в строку в указанном формате. | | [ToString](../node/tostring/)(const System::SharedPtr\\&) | Экспортирует содержимое узла в строку, используя указанные параметры сохранения. | | static [Type](./type/)() | | ## Примечания Весь текст документа хранится в run'ах. [Run](./) can only be a child of [Paragraph](../paragraph/) or inline [StructuredDocumentTag](../../aspose.words.markup/structureddocumenttag/). ## Примеры Показывает, как форматировать run текста, используя его свойство font. ```cpp auto doc = System::MakeObject(); auto run = System::MakeObject(doc, u"Hello world!"); System::SharedPtr font = run->get_Font(); font->set_Name(u"Courier New"); font->set_Size(36); font->set_HighlightColor(System::Drawing::Color::get_Yellow()); doc->get_FirstSection()->get_Body()->get_FirstParagraph()->AppendChild>(run); doc->Save(get_ArtifactsDir() + u"Font.CreateFormattedRun.docx"); ``` Показывает, как добавить, обновить и удалить дочерние узлы в коллекции дочерних элементов [CompositeNode](../compositenode/). ```cpp auto doc = System::MakeObject(); // Пустой документ по умолчанию содержит один абзац. ASSERT_EQ(1, doc->get_FirstSection()->get_Body()->get_Paragraphs()->get_Count()); // Составные узлы, такие как наш абзац, могут содержать другие составные и встроенные узлы в качестве дочерних. System::SharedPtr paragraph = doc->get_FirstSection()->get_Body()->get_FirstParagraph(); auto paragraphText = System::MakeObject(doc, u"Initial text. "); paragraph->AppendChild>(paragraphText); // Создайте ещё три узла run. auto run1 = System::MakeObject(doc, u"Run 1. "); auto run2 = System::MakeObject(doc, u"Run 2. "); auto run3 = System::MakeObject(doc, u"Run 3. "); // Тело документа не будет отображать эти run'ы, пока мы не вставим их в составной узел // который сам является частью дерева узлов документа, как мы сделали с первым run. // Мы можем определить, где будет находиться текстовое содержимое узлов, которые мы вставляем // в документе, указав место вставки относительно другого узла в абзаце. ASSERT_EQ(u"Initial text.", paragraph->GetText().Trim()); // Вставьте второй run в абзац перед начальным run. paragraph->InsertBefore>(run2, paragraphText); ASSERT_EQ(u"Run 2. Initial text.", paragraph->GetText().Trim()); // Вставьте третий run после начального run. paragraph->InsertAfter>(run3, paragraphText); ASSERT_EQ(u"Run 2. Initial text. Run 3.", paragraph->GetText().Trim()); // Вставьте первый run в начало коллекции дочерних узлов абзаца. paragraph->PrependChild>(run1); ASSERT_EQ(u"Run 1. Run 2. Initial text. Run 3.", paragraph->GetText().Trim()); ASSERT_EQ(4, paragraph->GetChildNodes(Aspose::Words::NodeType::Any, true)->get_Count()); // Мы можем изменить содержимое run, редактируя и удаляя существующие дочерние узлы. (System::ExplicitCast(paragraph->GetChildNodes(Aspose::Words::NodeType::Run, true)->idx_get(1)))->set_Text(u"Updated run 2. "); paragraph->GetChildNodes(Aspose::Words::NodeType::Run, true)->Remove(paragraphText); ASSERT_EQ(u"Run 1. Updated run 2. Run 3.", paragraph->GetText().Trim()); ASSERT_EQ(3, paragraph->GetChildNodes(Aspose::Words::NodeType::Any, true)->get_Count()); ``` Показывает, как вручную построить документ Aspose.Words. ```cpp auto doc = System::MakeObject(); // Пустой документ содержит один раздел, одно тело и один абзац. // Вызовите метод "RemoveAllChildren", чтобы удалить все эти узлы, // и в результате получите узел документа без дочерних элементов. doc->RemoveAllChildren(); // У этого документа теперь нет составных дочерних узлов, к которым мы могли бы добавить содержимое. // Если мы захотим отредактировать его, нам потребуется заново заполнить его коллекцию узлов. // Сначала создайте новый раздел, а затем добавьте его как дочерний элемент к корневому узлу документа. auto section = System::MakeObject(doc); doc->AppendChild>(section); // Установите некоторые свойства разметки страницы для раздела. section->get_PageSetup()->set_SectionStart(Aspose::Words::SectionStart::NewPage); section->get_PageSetup()->set_PaperSize(Aspose::Words::PaperSize::Letter); // Разделу требуется тело, которое будет содержать и отображать всё его содержимое // на странице между заголовком и нижним колонтитулом раздела. auto body = System::MakeObject(doc); section->AppendChild>(body); // Создайте абзац, задайте некоторые свойства форматирования и затем добавьте его как дочерний элемент к телу. auto para = System::MakeObject(doc); para->get_ParagraphFormat()->set_StyleName(u"Heading 1"); para->get_ParagraphFormat()->set_Alignment(Aspose::Words::ParagraphAlignment::Center); body->AppendChild>(para); // Наконец, добавьте некоторое содержимое в документ. Создайте объект Run, // задайте его внешний вид и содержимое, а затем добавьте его как дочерний элемент к абзацу. auto run = System::MakeObject(doc); run->set_Text(u"Hello World!"); run->get_Font()->set_Color(System::Drawing::Color::get_Red()); para->AppendChild>(run); ASSERT_EQ(u"Hello World!", doc->GetText().Trim()); doc->Save(get_ArtifactsDir() + u"Section.CreateManually.docx"); ``` ## См. также * Class [Inline](../inline/) * Namespace [Aspose::Words](../) * Library [Aspose.Words for C++](../../)