Aspose::Words::Tables::CellFormat class

CellFormat class

Представляет всё форматирование ячейки таблицы. Чтобы узнать больше, посетите статью документации Working with Tables.

class CellFormat : public Aspose::Words::IBorderAttrSource,
                   public Aspose::Words::IShadingAttrSource

Методы

МетодОписание
ClearFormatting()Сбрасывает форматирование ячейки к значениям по умолчанию. Не изменяет ширину ячейки.
get_Borders()Получает коллекцию границ ячейки.
get_BottomPadding()Возвращает или задает количество пространства (в пунктах), добавляемое ниже содержимого ячейки.
get_FitText()Если true, помещает текст в ячейку, сжимая каждый абзац до ширины ячейки.
get_HideMark()Возвращает видимость маркера ячейки.
get_HorizontalMerge()Указывает, как ячейка объединяется горизонтально с другими ячейками в строке.
get_LeftPadding()Возвращает или задает количество пространства (в пунктах), добавляемое слева от содержимого ячейки.
get_Orientation()Возвращает или задает ориентацию текста в ячейке таблицы.
get_PreferredWidth()Возвращает или задает предпочтительную ширину ячейки.
get_RightPadding()Возвращает или задает количество пространства (в пунктах), добавляемое справа от содержимого ячейки.
get_Shading()Возвращает объект Shading, который относится к форматированию затенения ячейки.
get_TopPadding()Возвращает или задает количество пространства (в пунктах), добавляемое выше содержимого ячейки.
get_VerticalAlignment()Возвращает или задает вертикальное выравнивание текста в ячейке.
get_VerticalMerge()Указывает, как ячейка объединяется с другими ячейками по вертикали.
get_Width()Получает ширину ячейки в пунктах.
get_WrapText()Если true, переносить текст в ячейке.
GetType() const override
Is(const System::TypeInfo&) const override
set_BottomPadding(double)Сеттер для Aspose::Words::Tables::CellFormat::get_BottomPadding.
set_FitText(bool)Сеттер для Aspose::Words::Tables::CellFormat::get_FitText.
set_HideMark(bool)Устанавливает видимость метки ячейки.
set_HorizontalMerge(Aspose::Words::Tables::CellMerge)Сеттер для Aspose::Words::Tables::CellFormat::get_HorizontalMerge.
set_LeftPadding(double)Сеттер для Aspose::Words::Tables::CellFormat::get_LeftPadding.
set_Orientation(Aspose::Words::TextOrientation)Сеттер для Aspose::Words::Tables::CellFormat::get_Orientation.
set_PreferredWidth(const System::SharedPtr<Aspose::Words::Tables::PreferredWidth>&)Сеттер для Aspose::Words::Tables::CellFormat::get_PreferredWidth.
set_RightPadding(double)Сеттер для Aspose::Words::Tables::CellFormat::get_RightPadding.
set_TopPadding(double)Сеттер для Aspose::Words::Tables::CellFormat::get_TopPadding.
set_VerticalAlignment(Aspose::Words::Tables::CellVerticalAlignment)Сеттер для Aspose::Words::Tables::CellFormat::get_VerticalAlignment.
set_VerticalMerge(Aspose::Words::Tables::CellMerge)Сеттер для Aspose::Words::Tables::CellFormat::get_VerticalMerge.
set_Width(double)Сеттер для Aspose::Words::Tables::CellFormat::get_Width.
set_WrapText(bool)Сеттер для Aspose::Words::Tables::CellFormat::get_WrapText.
SetPaddings(double, double, double, double)Устанавливает количество пространства (в пунктах), добавляемого слева/сверху/справа/снизу к содержимому ячейки.
static Type()

Примеры

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

auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

builder->StartTable();

// Установка параметров форматирования таблицы для DocumentBuilder
// будет применять их к каждой строке и ячейке, которые мы добавляем с его помощью.
builder->get_ParagraphFormat()->set_Alignment(Aspose::Words::ParagraphAlignment::Center);

builder->get_CellFormat()->ClearFormatting();
builder->get_CellFormat()->set_Width(150);
builder->get_CellFormat()->set_VerticalAlignment(Aspose::Words::Tables::CellVerticalAlignment::Center);
builder->get_CellFormat()->get_Shading()->set_BackgroundPatternColor(System::Drawing::Color::get_GreenYellow());
builder->get_CellFormat()->set_WrapText(false);
builder->get_CellFormat()->set_FitText(true);

builder->get_RowFormat()->ClearFormatting();
builder->get_RowFormat()->set_HeightRule(Aspose::Words::HeightRule::Exactly);
builder->get_RowFormat()->set_Height(50);
builder->get_RowFormat()->get_Borders()->set_LineStyle(Aspose::Words::LineStyle::Engrave3D);
builder->get_RowFormat()->get_Borders()->set_Color(System::Drawing::Color::get_Orange());

builder->InsertCell();
builder->Write(u"Row 1, Col 1");

builder->InsertCell();
builder->Write(u"Row 1, Col 2");
builder->EndRow();

// Изменение форматирования будет применено к текущей ячейке,
// и к любым новым ячейкам, которые мы создаём с помощью билдера позже.
// Это не повлияет на ячейки, которые мы добавили ранее.
builder->get_CellFormat()->get_Shading()->ClearFormatting();

builder->InsertCell();
builder->Write(u"Row 2, Col 1");

builder->InsertCell();
builder->Write(u"Row 2, Col 2");

builder->EndRow();

// Увеличьте высоту строки, чтобы разместить вертикальный текст.
builder->InsertCell();
builder->get_RowFormat()->set_Height(150);
builder->get_CellFormat()->set_Orientation(Aspose::Words::TextOrientation::Upward);
builder->Write(u"Row 3, Col 1");

builder->InsertCell();
builder->get_CellFormat()->set_Orientation(Aspose::Words::TextOrientation::Downward);
builder->Write(u"Row 3, Col 2");

builder->EndRow();
builder->EndTable();

doc->Save(get_ArtifactsDir() + u"DocumentBuilder.InsertTable.docx");

Показывает, как изменить формат строк и ячеек в таблице.

auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

System::SharedPtr<Aspose::Words::Tables::Table> table = builder->StartTable();
builder->InsertCell();
builder->Write(u"City");
builder->InsertCell();
builder->Write(u"Country");
builder->EndRow();
builder->InsertCell();
builder->Write(u"London");
builder->InsertCell();
builder->Write(u"U.K.");
builder->EndTable();

// Используйте свойство "RowFormat" первой строки, чтобы изменить форматирование
// содержимого всех ячеек в этой строке.
System::SharedPtr<Aspose::Words::Tables::RowFormat> rowFormat = table->get_FirstRow()->get_RowFormat();
rowFormat->set_Height(25);
rowFormat->get_Borders()->idx_get(Aspose::Words::BorderType::Bottom)->set_Color(System::Drawing::Color::get_Red());

// Используйте свойство "CellFormat" первой ячейки в последней строке, чтобы изменить форматирование содержимого этой ячейки.
System::SharedPtr<Aspose::Words::Tables::CellFormat> cellFormat = table->get_LastRow()->get_FirstCell()->get_CellFormat();
cellFormat->set_Width(100);
cellFormat->get_Shading()->set_BackgroundPatternColor(System::Drawing::Color::get_Orange());

doc->Save(get_ArtifactsDir() + u"Table.RowCellFormat.docx");

Показывает, как изменить форматирование ячейки таблицы.

auto doc = System::MakeObject<Aspose::Words::Document>(get_MyDir() + u"Tables.docx");
System::SharedPtr<Aspose::Words::Tables::Table> table = doc->get_FirstSection()->get_Body()->get_Tables()->idx_get(0);
System::SharedPtr<Aspose::Words::Tables::Cell> firstCell = table->get_FirstRow()->get_FirstCell();

// Используйте свойство "CellFormat" ячейки, чтобы задать форматирование, изменяющее внешний вид этой ячейки.
firstCell->get_CellFormat()->set_Width(30);
firstCell->get_CellFormat()->set_Orientation(Aspose::Words::TextOrientation::Downward);
firstCell->get_CellFormat()->get_Shading()->set_ForegroundPatternColor(System::Drawing::Color::get_LightGreen());

doc->Save(get_ArtifactsDir() + u"Table.CellFormat.docx");

См. также

Aspose::Words::Tables::CellCollection класс Aspose::Words::Tables::PreferredWidth class