## Table class Представляет таблицу в документе Word. Чтобы узнать больше, посетите статью документации [Working with Tables](https://docs.aspose.com/words/cpp/working-with-tables/). ```cpp class Table : public Aspose::Words::CompositeNode ``` ## Методы | Метод | Описание | | --- | --- | | [Accept](./accept/)(System::SharedPtr\) override | Принимает посетителя. | | [AcceptEnd](./acceptend/)(System::SharedPtr\) override | Принимает посетителя для посещения конца таблицы. | | [AcceptStart](./acceptstart/)(System::SharedPtr\) override | Принимает посетителя для посещения начала таблицы. | | [AppendChild](../../aspose.words/compositenode/appendchild/)(T) | | | [AutoFit](./autofit/)(Aspose::Words::Tables::AutoFitBehavior) | Изменяет размер таблицы и ячеек в соответствии с указанным поведением автоматической подгонки. | | [ClearBorders](./clearborders/)() | Удаляет все границы таблицы и ячеек в этой таблице. | | [ClearShading](./clearshading/)() | Удаляет всю заливку таблицы. | | [Clone](../../aspose.words/node/clone/)(bool) | Создаёт дубликат узла. | | [ConvertToHorizontallyMergedCells](./converttohorizontallymergedcells/)() | Преобразует ячейки, объединённые по ширине, в ячейки, объединённые с помощью [HorizontalMerge](../cellformat/get_horizontalmerge/). | | [EnsureMinimum](./ensureminimum/)() | Если в таблице нет строк, создаёт и добавляет одну [Row](../row/). | | [get_AbsoluteHorizontalDistance](./get_absolutehorizontaldistance/)() | Получает или задаёт абсолютную горизонтальную позицию плавающей таблицы, указанную в свойствах таблицы, в пунктах. Значение по умолчанию — 0. | | [get_AbsoluteVerticalDistance](./get_absoluteverticaldistance/)() | Получает или задаёт абсолютную вертикальную позицию плавающей таблицы, указанную в свойствах таблицы, в пунктах. Значение по умолчанию — 0. | | [get_Alignment](./get_alignment/)() | Указывает, как встроенная таблица выравнивается в документе. | | [get_AllowAutoFit](./get_allowautofit/)() | Позволяет Microsoft Word и Aspose.Words автоматически изменять размер ячеек в таблице, чтобы они соответствовали содержимому. | | [get_AllowCellSpacing](./get_allowcellspacing/)() | Получает или задаёт параметр "Allow spacing between cells". | | [get_AllowOverlap](./get_allowoverlap/)() | Определяет, разрешает ли плавающая таблица другим плавающим объектам в документе перекрывать её границы при отображении. Значение по умолчанию — **true**. | | [get_Bidi](./get_bidi/)() | Получает или задаёт, является ли эта таблица таблицей справа налево. | | [get_BottomPadding](./get_bottompadding/)() | Получает или задаёт количество пространства (в пунктах), добавляемого под содержимое ячеек. | | [get_CellSpacing](./get_cellspacing/)() | Получает или задает величину пространства (в пунктах) между ячейками. | | [get_Count](../../aspose.words/compositenode/get_count/)() | Возвращает количество непосредственных дочерних элементов этого узла. | | [get_CustomNodeId](../../aspose.words/node/get_customnodeid/)() const | Указывает пользовательский идентификатор узла. | | [get_Description](./get_description/)() | Получает или задаёт описание этой таблицы. Оно предоставляет альтернативное текстовое представление информации, содержащейся в таблице. | | [get_DistanceBottom](./get_distancebottom/)() | Получает или задаёт расстояние между нижней границей таблицы и окружающим текстом, в пунктах. | | [get_DistanceLeft](./get_distanceleft/)() | Получает или задаёт расстояние между левой границей таблицы и окружающим текстом, в пунктах. | | [get_DistanceRight](./get_distanceright/)() | Получает или задаёт расстояние между правой границей таблицы и окружающим текстом, в пунктах. | | [get_DistanceTop](./get_distancetop/)() | Получает или задаёт расстояние между верхней границей таблицы и окружающим текстом, в пунктах. | | virtual [get_Document](../../aspose.words/node/get_document/)() const | Возвращает документ, к которому принадлежит этот узел. | | [get_FirstChild](../../aspose.words/compositenode/get_firstchild/)() const | Возвращает первого дочернего узла. | | [get_FirstRow](./get_firstrow/)() | Возвращает первый узел [Row](../row/) в таблице. | | [get_HasChildNodes](../../aspose.words/compositenode/get_haschildnodes/)() | Возвращает **true**, если у этого узла есть дочерние узлы. | | [get_HorizontalAnchor](./get_horizontalanchor/)() | Получает базовый объект, от которого должно рассчитываться горизонтальное позиционирование плавающей таблицы. Значение по умолчанию — [Column](../../aspose.words.drawing/relativehorizontalposition/). | | [get_IsComposite](../../aspose.words/compositenode/get_iscomposite/)() override | Возвращает **true**, поскольку этот узел может иметь дочерние узлы. | | [get_LastChild](../../aspose.words/compositenode/get_lastchild/)() const | Возвращает последнего дочернего узла. | | [get_LastRow](./get_lastrow/)() | Возвращает последний узел [Row](../row/) в таблице. | | [get_LeftIndent](./get_leftindent/)() | Получает или задает значение, представляющее левый отступ таблицы. | | [get_LeftPadding](./get_leftpadding/)() | Получает или задает количество пространства (в пунктах), добавляемого слева от содержимого ячеек. | | [get_NextNode](../../aspose.words/node/get_nextnode/)() const | | | [get_NextSibling](../../aspose.words/node/get_nextsibling/)() | Возвращает узел, непосредственно следующий за этим узлом. | | [get_NodeType](./get_nodetype/)() const override | Возвращает [Table](../../aspose.words/nodetype/). | | [get_ParentNode](../../aspose.words/node/get_parentnode/)() | Возвращает непосредственного родителя этого узла. | | [get_PreferredWidth](./get_preferredwidth/)() | Получает или задает предпочтительную ширину таблицы. | | [get_PreviousSibling](../../aspose.words/node/get_previoussibling/)() | Возвращает узел, непосредственно предшествующий этому узлу. | | [get_PrevNode](../../aspose.words/node/get_prevnode/)() const | | | [get_Range](../../aspose.words/node/get_range/)() | Возвращает объект [Range](../../aspose.words/range/), представляющий часть документа, содержащуюся в этом узле. | | [get_RelativeHorizontalAlignment](./get_relativehorizontalalignment/)() | Получает или задает относительное горизонтальное выравнивание плавающей таблицы. | | [get_RelativeVerticalAlignment](./get_relativeverticalalignment/)() | Получает или задает относительное вертикальное выравнивание плавающей таблицы. | | [get_RightPadding](./get_rightpadding/)() | Получает или задает количество пространства (в пунктах), добавляемого справа от содержимого ячеек. | | [get_Rows](./get_rows/)() | Обеспечивает типизированный доступ к строкам таблицы. | | [get_Style](./get_style/)() | Получает или задает стиль таблицы, применяемый к этой таблице. | | [get_StyleIdentifier](./get_styleidentifier/)() | Получает или задает независимый от локали идентификатор стиля таблицы, применяемый к этой таблице. | | [get_StyleName](./get_stylename/)() | Получает или задает имя стиля таблицы, применяемого к этой таблице. | | [get_StyleOptions](./get_styleoptions/)() | Получает или задает битовые флаги, определяющие, как стиль таблицы применяется к этой таблице. | | [get_TextWrapping](./get_textwrapping/)() | Получает или задает [TextWrapping](./get_textwrapping/) для таблицы. | | [get_Title](./get_title/)() | Получает или задает заголовок этой таблицы. Он предоставляет альтернативное текстовое представление информации, содержащейся в таблице. | | [get_TopPadding](./get_toppadding/)() | Получает или задает количество пространства (в пунктах), добавляемого над содержимым ячеек. | | [get_VerticalAnchor](./get_verticalanchor/)() | Получает базовый объект, из которого должно рассчитываться вертикальное позиционирование плавающей таблицы. Значение по умолчанию — [Margin](../../aspose.words.drawing/relativeverticalposition/). | | [GetAncestor](../../aspose.words/node/getancestor/)(Aspose::Words::NodeType) | Возвращает первого предка указанного [NodeType](../../aspose.words/nodetype/). | | [GetAncestorOf](../../aspose.words/node/getancestorof/)() | | | [GetChild](../../aspose.words/compositenode/getchild/)(Aspose::Words::NodeType, int32_t, bool) | Возвращает N‑й дочерний узел, соответствующий указанному типу. | | [GetChildNodes](../../aspose.words/compositenode/getchildnodes/)(Aspose::Words::NodeType, bool) | Возвращает живую коллекцию дочерних узлов, соответствующих указанному типу. | | [GetEnumerator](../../aspose.words/compositenode/getenumerator/)() override | Обеспечивает поддержку итерации в стиле foreach по дочерним узлам этого узла. | | [GetText](../../aspose.words/compositenode/gettext/)() override | Получает текст этого узла и всех его дочерних узлов. | | [GetType](./gettype/)() const override | | | [IndexOf](../../aspose.words/compositenode/indexof/)(const System::SharedPtr\\&) | Возвращает индекс указанного дочернего узла в массиве дочерних узлов. | | [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\\&) | Получает следующий узел согласно алгоритму обхода дерева в порядке предобхода. | | static [NodeTypeToString](../../aspose.words/node/nodetypetostring/)(Aspose::Words::NodeType) | Вспомогательный метод, преобразующий значение перечисления типа узла в удобочитаемую строку. | | [PrependChild](../../aspose.words/compositenode/prependchild/)(T) | | | [PreviousPreOrder](../../aspose.words/node/previouspreorder/)(const System::SharedPtr\\&) | Получает предыдущий узел согласно алгоритму обхода дерева в порядке предобхода. | | [Remove](../../aspose.words/node/remove/)() | Удаляет себя из родительского узла. | | [RemoveAllChildren](../../aspose.words/compositenode/removeallchildren/)() | Удаляет все дочерние узлы текущего узла. | | [RemoveChild](../../aspose.words/compositenode/removechild/)(T) | | | [RemoveSmartTags](../../aspose.words/compositenode/removesmarttags/)() | Удаляет все дочерние узлы [SmartTag](../../aspose.words.markup/smarttag/) текущего узла. | | [SelectNodes](../../aspose.words/compositenode/selectnodes/)(const System::String\&) | Выбирает список узлов, соответствующих XPath-выражению. | | [SelectSingleNode](../../aspose.words/compositenode/selectsinglenode/)(const System::String\&) | Выбирает первый [Node](../../aspose.words/node/), соответствующий XPath-выражению. | | [set_AbsoluteHorizontalDistance](./set_absolutehorizontaldistance/)(double) | Сеттер для [Aspose::Words::Tables::Table::get_AbsoluteHorizontalDistance](./get_absolutehorizontaldistance/). | | [set_AbsoluteVerticalDistance](./set_absoluteverticaldistance/)(double) | Сеттер для [Aspose::Words::Tables::Table::get_AbsoluteVerticalDistance](./get_absoluteverticaldistance/). | | [set_Alignment](./set_alignment/)(Aspose::Words::Tables::TableAlignment) | Сеттер для [Aspose::Words::Tables::Table::get_Alignment](./get_alignment/). | | [set_AllowAutoFit](./set_allowautofit/)(bool) | Сеттер для [Aspose::Words::Tables::Table::get_AllowAutoFit](./get_allowautofit/). | | [set_AllowCellSpacing](./set_allowcellspacing/)(bool) | Сеттер для [Aspose::Words::Tables::Table::get_AllowCellSpacing](./get_allowcellspacing/). | | [set_Bidi](./set_bidi/)(bool) | Сеттер для [Aspose::Words::Tables::Table::get_Bidi](./get_bidi/). | | [set_BottomPadding](./set_bottompadding/)(double) | Сеттер для [Aspose::Words::Tables::Table::get_BottomPadding](./get_bottompadding/). | | [set_CellSpacing](./set_cellspacing/)(double) | Сеттер для [Aspose::Words::Tables::Table::get_CellSpacing](./get_cellspacing/). | | [set_CustomNodeId](../../aspose.words/node/set_customnodeid/)(int32_t) | Сеттер для [Aspose::Words::Node::get_CustomNodeId](../../aspose.words/node/get_customnodeid/). | | [set_Description](./set_description/)(const System::String\&) | Сеттер для [Aspose::Words::Tables::Table::get_Description](./get_description/). | | [set_DistanceBottom](./set_distancebottom/)(double) | Сеттер для [Aspose::Words::Tables::Table::get_DistanceBottom](./get_distancebottom/). | | [set_DistanceLeft](./set_distanceleft/)(double) | Сеттер для [Aspose::Words::Tables::Table::get_DistanceLeft](./get_distanceleft/). | | [set_DistanceRight](./set_distanceright/)(double) | Сеттер для [Aspose::Words::Tables::Table::get_DistanceRight](./get_distanceright/). | | [set_DistanceTop](./set_distancetop/)(double) | Сеттер для [Aspose::Words::Tables::Table::get_DistanceTop](./get_distancetop/). | | [set_HorizontalAnchor](./set_horizontalanchor/)(Aspose::Words::Drawing::RelativeHorizontalPosition) | Сеттер для [Aspose::Words::Tables::Table::get_HorizontalAnchor](./get_horizontalanchor/). | | [set_LeftIndent](./set_leftindent/)(double) | Сеттер для [Aspose::Words::Tables::Table::get_LeftIndent](./get_leftindent/). | | [set_LeftPadding](./set_leftpadding/)(double) | Сеттер для [Aspose::Words::Tables::Table::get_LeftPadding](./get_leftpadding/). | | [set_NextNode](../../aspose.words/node/set_nextnode/)(const System::SharedPtr\\&) | | | [set_PreferredWidth](./set_preferredwidth/)(const System::SharedPtr\\&) | Сеттер для [Aspose::Words::Tables::Table::get_PreferredWidth](./get_preferredwidth/). | | [set_PrevNode](../../aspose.words/node/set_prevnode/)(const System::SharedPtr\\&) | | | [set_RelativeHorizontalAlignment](./set_relativehorizontalalignment/)(Aspose::Words::Drawing::HorizontalAlignment) | Сеттер для [Aspose::Words::Tables::Table::get_RelativeHorizontalAlignment](./get_relativehorizontalalignment/). | | [set_RelativeVerticalAlignment](./set_relativeverticalalignment/)(Aspose::Words::Drawing::VerticalAlignment) | Сеттер для [Aspose::Words::Tables::Table::get_RelativeVerticalAlignment](./get_relativeverticalalignment/). | | [set_RightPadding](./set_rightpadding/)(double) | Сеттер для [Aspose::Words::Tables::Table::get_RightPadding](./get_rightpadding/). | | [set_Style](./set_style/)(const System::SharedPtr\\&) | Сеттер для [Aspose::Words::Tables::Table::get_Style](./get_style/). | | [set_StyleIdentifier](./set_styleidentifier/)(Aspose::Words::StyleIdentifier) | Сеттер для [Aspose::Words::Tables::Table::get_StyleIdentifier](./get_styleidentifier/). | | [set_StyleName](./set_stylename/)(const System::String\&) | Сеттер для [Aspose::Words::Tables::Table::get_StyleName](./get_stylename/). | | [set_StyleOptions](./set_styleoptions/)(Aspose::Words::Tables::TableStyleOptions) | Сеттер для [Aspose::Words::Tables::Table::get_StyleOptions](./get_styleoptions/). | | [set_TextWrapping](./set_textwrapping/)(Aspose::Words::Tables::TextWrapping) | Сеттер для [Aspose::Words::Tables::Table::get_TextWrapping](./get_textwrapping/). | | [set_Title](./set_title/)(const System::String\&) | Сеттер для [Aspose::Words::Tables::Table::get_Title](./get_title/). | | [set_TopPadding](./set_toppadding/)(double) | Сеттер для [Aspose::Words::Tables::Table::get_TopPadding](./get_toppadding/). | | [set_VerticalAnchor](./set_verticalanchor/)(Aspose::Words::Drawing::RelativeVerticalPosition) | Сеттер для [Aspose::Words::Tables::Table::get_VerticalAnchor](./get_verticalanchor/). | | [SetBorder](./setborder/)(Aspose::Words::BorderType, Aspose::Words::LineStyle, double, System::Drawing::Color, bool) | Устанавливает указанную границу таблицы с заданным стилем линии, шириной и цветом. | | [SetBorders](./setborders/)(Aspose::Words::LineStyle, double, System::Drawing::Color) | Устанавливает все границы таблицы с заданным стилем линии, шириной и цветом. | | [SetParent](../../aspose.words/node/setparent/)(const System::SharedPtr\\&) | | | [SetShading](./setshading/)(Aspose::Words::TextureIndex, System::Drawing::Color, System::Drawing::Color) | Устанавливает затенение таблицы на указанные значения. | | [SetTemplateWeakPtr](../../aspose.words/compositenode/settemplateweakptr/)(uint32_t) override | | | [Table](./table/)(const System::SharedPtr\\&) | Инициализирует новый экземпляр класса [Table](./). | | [ToString](../../aspose.words/node/tostring/)(Aspose::Words::SaveFormat) | Экспортирует содержимое узла в строку в указанном формате. | | [ToString](../../aspose.words/node/tostring/)(const System::SharedPtr\\&) | Экспортирует содержимое узла в строку, используя указанные параметры сохранения. | | static [Type](./type/)() | | ## Примечания [Table](./) is a block-level node and can be a child of classes derived from [Story](../../aspose.words/story/) or [InlineStory](../../aspose.words/inlinestory/). [Table](./) can contain one or more [Row](../row/) nodes. Минимальная корректная таблица должна содержать как минимум одну [Row](../row/). ## Примеры Показывает, как построить отформатированную таблицу 2x2. ```cpp auto doc = System::MakeObject(); auto builder = System::MakeObject(doc); System::SharedPtr table = builder->StartTable(); builder->InsertCell(); builder->get_CellFormat()->set_VerticalAlignment(Aspose::Words::Tables::CellVerticalAlignment::Center); builder->Write(u"Row 1, cell 1."); builder->InsertCell(); builder->Write(u"Row 1, cell 2."); builder->EndRow(); // Во время построения таблицы документный построитель применит текущие значения свойств RowFormat/CellFormat. // к текущей строке/ячейке, в которой находится курсор, и к любым новым строкам/ячейкам при их создании. ASSERT_EQ(Aspose::Words::Tables::CellVerticalAlignment::Center, table->get_Rows()->idx_get(0)->get_Cells()->idx_get(0)->get_CellFormat()->get_VerticalAlignment()); ASSERT_EQ(Aspose::Words::Tables::CellVerticalAlignment::Center, table->get_Rows()->idx_get(0)->get_Cells()->idx_get(1)->get_CellFormat()->get_VerticalAlignment()); builder->InsertCell(); builder->get_RowFormat()->set_Height(100); builder->get_RowFormat()->set_HeightRule(Aspose::Words::HeightRule::Exactly); builder->get_CellFormat()->set_Orientation(Aspose::Words::TextOrientation::Upward); builder->Write(u"Row 2, cell 1."); builder->InsertCell(); builder->get_CellFormat()->set_Orientation(Aspose::Words::TextOrientation::Downward); builder->Write(u"Row 2, cell 2."); builder->EndRow(); builder->EndTable(); // Ранее добавленные строки и ячейки не подвергаются ретроспективному изменению из‑за изменений форматирования построителя. ASPOSE_ASSERT_EQ(0, table->get_Rows()->idx_get(0)->get_RowFormat()->get_Height()); ASSERT_EQ(Aspose::Words::HeightRule::Auto, table->get_Rows()->idx_get(0)->get_RowFormat()->get_HeightRule()); ASPOSE_ASSERT_EQ(100, table->get_Rows()->idx_get(1)->get_RowFormat()->get_Height()); ASSERT_EQ(Aspose::Words::HeightRule::Exactly, table->get_Rows()->idx_get(1)->get_RowFormat()->get_HeightRule()); ASSERT_EQ(Aspose::Words::TextOrientation::Upward, table->get_Rows()->idx_get(1)->get_Cells()->idx_get(0)->get_CellFormat()->get_Orientation()); ASSERT_EQ(Aspose::Words::TextOrientation::Downward, table->get_Rows()->idx_get(1)->get_Cells()->idx_get(1)->get_CellFormat()->get_Orientation()); doc->Save(get_ArtifactsDir() + u"DocumentBuilder.BuildTable.docx"); ``` Показывает, как создать таблицу. ```cpp auto doc = System::MakeObject(); auto table = System::MakeObject(doc); doc->get_FirstSection()->get_Body()->AppendChild>(table); // Таблицы содержат строки, которые содержат ячейки, которые могут иметь абзацы // с типичными элементами, такими как фрагменты, фигуры и даже другие таблицы. // Вызов метода "EnsureMinimum" у таблицы гарантирует, что // у таблицы будет как минимум одна строка, ячейка и абзац. auto firstRow = System::MakeObject(doc); table->AppendChild>(firstRow); auto firstCell = System::MakeObject(doc); firstRow->AppendChild>(firstCell); auto paragraph = System::MakeObject(doc); firstCell->AppendChild>(paragraph); // Добавьте текст в первую ячейку первой строки таблицы. auto run = System::MakeObject(doc, u"Hello world!"); paragraph->AppendChild>(run); doc->Save(get_ArtifactsDir() + u"Table.CreateTable.docx"); ``` Показывает, как пройтись по всем таблицам в документе и вывести содержимое каждой ячейки. ```cpp auto doc = System::MakeObject(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(); // Мы можем использовать метод "ToArray" для коллекции строк, чтобы клонировать её в массив. 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(); // Мы можем использовать метод "ToArray" для коллекции ячеек, чтобы клонировать её в массив. 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(Aspose::Words::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; } ``` ## См. также * Class [CompositeNode](../../aspose.words/compositenode/) * Namespace [Aspose::Words::Tables](../) * Library [Aspose.Words for C++](../../)