## Run class Represents a run of characters with the same font formatting. To learn more, visit the [Programming with Documents](https://docs.aspose.com/words/cpp/programming-with-documents/) documentation article. ```cpp class Run : public Aspose::Words::Inline ``` ## Methods | Method | Description | | --- | --- | | [Accept](./accept/)(System::SharedPtr\) override | Accepts a visitor. | | [Clone](../node/clone/)(bool) | Creates a duplicate of the node. | | [get_CustomNodeId](../node/get_customnodeid/)() const | Specifies custom node identifier. | | virtual [get_Document](../node/get_document/)() const | Gets the document to which this node belongs. | | [get_Font](../inline/get_font/)() | Provides access to the font formatting of this object. | | virtual [get_IsComposite](../node/get_iscomposite/)() | Returns **true** if this node can contain other nodes. | | [get_IsDeleteRevision](../inline/get_isdeleterevision/)() | Returns true if this object was deleted in Microsoft Word while change tracking was enabled. | | [get_IsFormatRevision](../inline/get_isformatrevision/)() | Returns true if formatting of the object was changed in Microsoft Word while change tracking was enabled. | | [get_IsInsertRevision](../inline/get_isinsertrevision/)() | Returns true if this object was inserted in Microsoft Word while change tracking was enabled. | | [get_IsMoveFromRevision](../inline/get_ismovefromrevision/)() | Returns **true** if this object was moved (deleted) in Microsoft Word while change tracking was enabled. | | [get_IsMoveToRevision](../inline/get_ismovetorevision/)() | Returns **true** if this object was moved (inserted) in Microsoft Word while change tracking was enabled. | | [get_IsPhoneticGuide](./get_isphoneticguide/)() | Gets a boolean value indicating either the run is a phonetic guide. | | [get_NextNode](../node/get_nextnode/)() const | | | [get_NextSibling](../node/get_nextsibling/)() | Gets the node immediately following this node. | | [get_NodeType](./get_nodetype/)() const override | Returns [Run](../nodetype/). | | [get_ParentNode](../node/get_parentnode/)() | Gets the immediate parent of this node. | | [get_ParentParagraph](../inline/get_parentparagraph/)() | Retrieves the parent [Paragraph](../paragraph/) of this node. | | [get_PhoneticGuide](./get_phoneticguide/)() | Gets a [PhoneticGuide](./get_phoneticguide/) object. | | [get_PreviousSibling](../node/get_previoussibling/)() | Gets the node immediately preceding this node. | | [get_PrevNode](../node/get_prevnode/)() const | | | [get_Range](../node/get_range/)() | Returns a [Range](../range/) object that represents the portion of a document that is contained in this node. | | [get_Text](./get_text/)() const | Gets or sets the text of the run. | | [GetAncestor](../node/getancestor/)(Aspose::Words::NodeType) | Gets the first ancestor of the specified [NodeType](../nodetype/). | | [GetAncestorOf](../node/getancestorof/)() | | | [GetText](./gettext/)() override | Gets the text of the run. | | [GetType](./gettype/)() const override | | | [Is](./is/)(const System::TypeInfo\&) const override | | | [IsAncestorNode](../node/isancestornode/)(const System::SharedPtr\\&) | | | [NextPreOrder](../node/nextpreorder/)(const System::SharedPtr\\&) | Gets next node according to the pre-order tree traversal algorithm. | | static [NodeTypeToString](../node/nodetypetostring/)(Aspose::Words::NodeType) | A utility method that converts a node type enum value into a user friendly string. | | [PreviousPreOrder](../node/previouspreorder/)(const System::SharedPtr\\&) | Gets the previous node according to the pre-order tree traversal algorithm. | | [Remove](../node/remove/)() | Removes itself from the parent. | | [Run](./run/)(const System::SharedPtr\\&) | Initializes a new instance of the [Run](./) class. | | [Run](./run/)(const System::SharedPtr\\&, const System::String\&) | Initializes a new instance of the **Run** class. | | [set_CustomNodeId](../node/set_customnodeid/)(int32_t) | Setter for [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\&) | Setter for [Aspose::Words::Run::get_Text](./get_text/). | | [SetParent](../node/setparent/)(const System::SharedPtr\\&) | | | [ToString](../node/tostring/)(Aspose::Words::SaveFormat) | Exports the content of the node into a string in the specified format. | | [ToString](../node/tostring/)(const System::SharedPtr\\&) | Exports the content of the node into a string using the specified save options. | | static [Type](./type/)() | | ## Remarks All text of the document is stored in runs of text. [Run](./) can only be a child of [Paragraph](../paragraph/) or inline [StructuredDocumentTag](../../aspose.words.markup/structureddocumenttag/). ## Examples Shows how to format a run of text using its font property. ```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"); ``` Shows how to add, update and delete child nodes in a [CompositeNode](../compositenode/)'s collection of children. ```cpp auto doc = System::MakeObject(); // An empty document, by default, has one paragraph. ASSERT_EQ(1, doc->get_FirstSection()->get_Body()->get_Paragraphs()->get_Count()); // Composite nodes such as our paragraph can contain other composite and inline nodes as children. System::SharedPtr paragraph = doc->get_FirstSection()->get_Body()->get_FirstParagraph(); auto paragraphText = System::MakeObject(doc, u"Initial text. "); paragraph->AppendChild>(paragraphText); // Create three more run nodes. auto run1 = System::MakeObject(doc, u"Run 1. "); auto run2 = System::MakeObject(doc, u"Run 2. "); auto run3 = System::MakeObject(doc, u"Run 3. "); // The document body will not display these runs until we insert them into a composite node // that itself is a part of the document's node tree, as we did with the first run. // We can determine where the text contents of nodes that we insert // appears in the document by specifying an insertion location relative to another node in the paragraph. ASSERT_EQ(u"Initial text.", paragraph->GetText().Trim()); // Insert the second run into the paragraph in front of the initial run. paragraph->InsertBefore>(run2, paragraphText); ASSERT_EQ(u"Run 2. Initial text.", paragraph->GetText().Trim()); // Insert the third run after the initial run. paragraph->InsertAfter>(run3, paragraphText); ASSERT_EQ(u"Run 2. Initial text. Run 3.", paragraph->GetText().Trim()); // Insert the first run to the start of the paragraph's child nodes collection. paragraph->PrependChild>(run1); ASSERT_EQ(u"Run 1. Run 2. Initial text. Run 3.", paragraph->GetText().Trim()); ASSERT_EQ(4, paragraph->GetChildNodes(NodeType::Any, true)->get_Count()); // We can modify the contents of the run by editing and deleting existing child nodes. (System::ExplicitCast(paragraph->GetChildNodes(NodeType::Run, true)->idx_get(1)))->set_Text(u"Updated run 2. "); paragraph->GetChildNodes(NodeType::Run, true)->Remove(paragraphText); ASSERT_EQ(u"Run 1. Updated run 2. Run 3.", paragraph->GetText().Trim()); ASSERT_EQ(3, paragraph->GetChildNodes(NodeType::Any, true)->get_Count()); ``` Shows how to construct an Aspose.Words document by hand. ```cpp auto doc = System::MakeObject(); // A blank document contains one section, one body and one paragraph. // Call the "RemoveAllChildren" method to remove all those nodes, // and end up with a document node with no children. doc->RemoveAllChildren(); // This document now has no composite child nodes that we can add content to. // If we wish to edit it, we will need to repopulate its node collection. // First, create a new section, and then append it as a child to the root document node. auto section = System::MakeObject(doc); doc->AppendChild>(section); // Set some page setup properties for the section. section->get_PageSetup()->set_SectionStart(SectionStart::NewPage); section->get_PageSetup()->set_PaperSize(PaperSize::Letter); // A section needs a body, which will contain and display all its contents // on the page between the section's header and footer. auto body = System::MakeObject(doc); section->AppendChild>(body); // Create a paragraph, set some formatting properties, and then append it as a child to the body. auto para = System::MakeObject(doc); para->get_ParagraphFormat()->set_StyleName(u"Heading 1"); para->get_ParagraphFormat()->set_Alignment(ParagraphAlignment::Center); body->AppendChild>(para); // Finally, add some content to do the document. Create a run, // set its appearance and contents, and then append it as a child to the paragraph. 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"); ``` ## See Also * Class [Inline](../inline/) * Namespace [Aspose::Words](../) * Library [Aspose.Words for C++](../../)