## Row class Represents a table row. To learn more, visit the [Working with Tables](https://docs.aspose.com/words/cpp/working-with-tables/) documentation article. ```cpp class Row : public Aspose::Words::CompositeNode, public IRowAttrSource, public Revisions::ITrackableNode ``` ## Methods | Method | Description | | --- | --- | | [Accept](./accept/)(System::SharedPtr\) override | Accepts a visitor. | | [AcceptEnd](./acceptend/)(System::SharedPtr\) override | Accepts a visitor for visiting the end of the row. | | [AcceptStart](./acceptstart/)(System::SharedPtr\) override | Accepts a visitor for visiting the start of the row. | | [AppendChild](../../aspose.words/compositenode/appendchild/)(T) | | | [Clone](../../aspose.words/node/clone/)(bool) | Creates a duplicate of the node. | | [EnsureMinimum](./ensureminimum/)() | If the [Row](./) has no cells, creates and appends one [Cell](../cell/). | | [get_Cells](./get_cells/)() | Provides typed access to the [Cell](../cell/) child nodes of the row. | | [get_Count](../../aspose.words/compositenode/get_count/)() | Gets the number of immediate children of this node. | | [get_CustomNodeId](../../aspose.words/node/get_customnodeid/)() const | Specifies custom node identifier. | | virtual [get_Document](../../aspose.words/node/get_document/)() const | Gets the document to which this node belongs. | | [get_FirstCell](./get_firstcell/)() | Returns the first [Cell](../cell/) in the row. | | [get_FirstChild](../../aspose.words/compositenode/get_firstchild/)() const | Gets the first child of the node. | | [get_HasChildNodes](../../aspose.words/compositenode/get_haschildnodes/)() | Returns **true** if this node has any child nodes. | | [get_Hidden](./get_hidden/)() | Gets or sets a flag indicating whether this row is hidden or not. | | [get_IsComposite](../../aspose.words/compositenode/get_iscomposite/)() override | Returns **true** as this node can have child nodes. | | [get_IsFirstRow](./get_isfirstrow/)() | True if this is the first row in a table; false otherwise. | | [get_IsLastRow](./get_islastrow/)() | True if this is the last row in a table; false otherwise. | | [get_LastCell](./get_lastcell/)() | Returns the last [Cell](../cell/) in the row. | | [get_LastChild](../../aspose.words/compositenode/get_lastchild/)() const | Gets the last child of the node. | | [get_NextNode](../../aspose.words/node/get_nextnode/)() const | | | [get_NextRow](./get_nextrow/)() | Gets the next [Row](./) node. | | [get_NextSibling](../../aspose.words/node/get_nextsibling/)() | Gets the node immediately following this node. | | [get_NodeType](./get_nodetype/)() const override | Returns [Row](../../aspose.words/nodetype/). | | [get_ParentNode](../../aspose.words/node/get_parentnode/)() | Gets the immediate parent of this node. | | [get_ParentTable](./get_parenttable/)() | Returns the immediate parent table of the row. | | [get_PreviousRow](./get_previousrow/)() | Gets the previous [Row](./) node. | | [get_PreviousSibling](../../aspose.words/node/get_previoussibling/)() | Gets the node immediately preceding this node. | | [get_PrevNode](../../aspose.words/node/get_prevnode/)() const | | | [get_Range](../../aspose.words/node/get_range/)() | Returns a [Range](../../aspose.words/range/) object that represents the portion of a document that is contained in this node. | | [get_RowFormat](./get_rowformat/)() | Provides access to the formatting properties of the row. | | [GetAncestor](../../aspose.words/node/getancestor/)(Aspose::Words::NodeType) | Gets the first ancestor of the specified [NodeType](../../aspose.words/nodetype/). | | [GetAncestorOf](../../aspose.words/node/getancestorof/)() | | | [GetChild](../../aspose.words/compositenode/getchild/)(Aspose::Words::NodeType, int32_t, bool) | Returns an Nth child node that matches the specified type. | | [GetChildNodes](../../aspose.words/compositenode/getchildnodes/)(Aspose::Words::NodeType, bool) | Returns a live collection of child nodes that match the specified type. | | [GetEnumerator](../../aspose.words/compositenode/getenumerator/)() override | Provides support for the for each style iteration over the child nodes of this node. | | [GetText](./gettext/)() override | Gets the text of all cells in this row including the end of row character. | | [GetType](./gettype/)() const override | | | [IndexOf](../../aspose.words/compositenode/indexof/)(const System::SharedPtr\\&) | Returns the index of the specified child node in the child node array. | | [InsertAfter](../../aspose.words/compositenode/insertafter/)(T, const System::SharedPtr\\&) | | | [InsertBefore](../../aspose.words/compositenode/insertbefore/)(T, const System::SharedPtr\\&) | | | [Is](./is/)(const System::TypeInfo\&) const override | | | [IsAncestorNode](../../aspose.words/node/isancestornode/)(const System::SharedPtr\\&) | | | [NextPreOrder](../../aspose.words/node/nextpreorder/)(const System::SharedPtr\\&) | Gets next node according to the pre-order tree traversal algorithm. | | static [NodeTypeToString](../../aspose.words/node/nodetypetostring/)(Aspose::Words::NodeType) | A utility method that converts a node type enum value into a user friendly string. | | [PrependChild](../../aspose.words/compositenode/prependchild/)(T) | | | [PreviousPreOrder](../../aspose.words/node/previouspreorder/)(const System::SharedPtr\\&) | Gets the previous node according to the pre-order tree traversal algorithm. | | [Remove](../../aspose.words/node/remove/)() | Removes itself from the parent. | | [RemoveAllChildren](../../aspose.words/compositenode/removeallchildren/)() | Removes all the child nodes of the current node. | | [RemoveChild](../../aspose.words/compositenode/removechild/)(T) | | | [RemoveSmartTags](../../aspose.words/compositenode/removesmarttags/)() | Removes all [SmartTag](../../aspose.words.markup/smarttag/) descendant nodes of the current node. | | [Row](./row/)(const System::SharedPtr\\&) | Initializes a new instance of the [Row](./) class. | | [SelectNodes](../../aspose.words/compositenode/selectnodes/)(const System::String\&) | Selects a list of nodes matching the XPath expression. | | [SelectSingleNode](../../aspose.words/compositenode/selectsinglenode/)(const System::String\&) | Selects the first [Node](../../aspose.words/node/) that matches the XPath expression. | | [set_CustomNodeId](../../aspose.words/node/set_customnodeid/)(int32_t) | Setter for [Aspose::Words::Node::get_CustomNodeId](../../aspose.words/node/get_customnodeid/). | | [set_Hidden](./set_hidden/)(bool) | Setter for [Aspose::Words::Tables::Row::get_Hidden](./get_hidden/). | | [set_NextNode](../../aspose.words/node/set_nextnode/)(const System::SharedPtr\\&) | | | [set_PrevNode](../../aspose.words/node/set_prevnode/)(const System::SharedPtr\\&) | | | [SetParent](../../aspose.words/node/setparent/)(const System::SharedPtr\\&) | | | [ToString](../../aspose.words/node/tostring/)(Aspose::Words::SaveFormat) | Exports the content of the node into a string in the specified format. | | [ToString](../../aspose.words/node/tostring/)(const System::SharedPtr\\&) | Exports the content of the node into a string using the specified save options. | | static [Type](./type/)() | | ## Remarks [Row](./) can only be a child of a [Table](../table/). [Row](./) can contain one or more [Cell](../cell/) nodes. A minimal valid row needs to have at least one [Cell](../cell/). ## Examples Shows how to create a table. ```cpp auto doc = System::MakeObject(); auto table = System::MakeObject(doc); doc->get_FirstSection()->get_Body()->AppendChild>(table); // Tables contain rows, which contain cells, which may have paragraphs // with typical elements such as runs, shapes, and even other tables. // Calling the "EnsureMinimum" method on a table will ensure that // the table has at least one row, cell, and paragraph. auto firstRow = System::MakeObject(doc); table->AppendChild>(firstRow); auto firstCell = System::MakeObject(doc); firstRow->AppendChild>(firstCell); auto paragraph = System::MakeObject(doc); firstCell->AppendChild>(paragraph); // Add text to the first cell in the first row of the table. auto run = System::MakeObject(doc, u"Hello world!"); paragraph->AppendChild>(run); doc->Save(get_ArtifactsDir() + u"Table.CreateTable.docx"); ``` Shows how to iterate through all tables in the document and print the contents of each cell. ```cpp auto doc = System::MakeObject(System::String(get_MyDir() + u"Tables.docx")); System::SharedPtr tables = doc->get_FirstSection()->get_Body()->get_Tables(); ASSERT_EQ(2, tables->ToArray()->get_Length()); for (int32_t i = 0; i < tables->get_Count(); i++) { std::cout << System::String::Format(u"Start of Table {0}", i) << std::endl; System::SharedPtr rows = tables->idx_get(i)->get_Rows(); // We can use the "ToArray" method on a row collection to clone it into an array. ASPOSE_ASSERT_EQ(rows, rows->ToArray()); ASPOSE_ASSERT_NS(rows, rows->ToArray()); for (int32_t j = 0; j < rows->get_Count(); j++) { std::cout << System::String::Format(u"\tStart of Row {0}", j) << std::endl; System::SharedPtr cells = rows->idx_get(j)->get_Cells(); // We can use the "ToArray" method on a cell collection to clone it into an array. ASPOSE_ASSERT_EQ(cells, cells->ToArray()); ASPOSE_ASSERT_NS(cells, cells->ToArray()); for (int32_t k = 0; k < cells->get_Count(); k++) { System::String cellText = cells->idx_get(k)->ToString(SaveFormat::Text).Trim(); std::cout << System::String::Format(u"\t\tContents of Cell:{0} = \"{1}\"", k, cellText) << std::endl; } std::cout << System::String::Format(u"\tEnd of Row {0}", j) << std::endl; } std::cout << System::String::Format(u"End of Table {0}\n", i) << std::endl; } ``` ## See Also * Class [CompositeNode](../../aspose.words/compositenode/) * Namespace [Aspose::Words::Tables](../) * Library [Aspose.Words for C++](../../)