Aspose::Words::Tables::PreferredWidth class
Содержание
[
Скрывать
]PreferredWidth class
Представляет значение и его единицу измерения, используемые для указания предпочтительной ширины таблицы или ячейки. Чтобы узнать больше, посетите статью документации Working with Tables.
class PreferredWidth : public System::Object
Методы
| Метод | Описание |
|---|---|
| static Auto() | Возвращает экземпляр, представляющий значение "предпочтительная ширина не указана". |
| Equals(const System::SharedPtr<Aspose::Words::Tables::PreferredWidth>&) | Определяет, равно ли значение указанного PreferredWidth текущему PreferredWidth. |
| Equals(System::SharedPtr<System::Object>) override | Определяет, равен ли указанный объект по значению текущему объекту. |
| static FromPercent(double) | Метод создания, который возвращает новый экземпляр, представляющий предпочтительную ширину, заданную в процентах. |
| static FromPoints(double) | Метод создания, который возвращает новый экземпляр, представляющий предпочтительную ширину, заданную в пунктах. |
| get_Type() const | Получает единицу измерения, используемую для этого значения предпочтительной ширины. |
| get_Value() const | Получает значение предпочтительной ширины. Единица измерения указывается в свойстве Type. |
| GetHashCode() const override | Служит хеш-функцией для этого типа. |
| GetType() const override | |
| Is(const System::TypeInfo&) const override | |
| ToString() const override | Возвращает удобочитаемую строку, отображающую значение этого объекта. |
| static Type() |
Примечания
Preferred width can be specified as a percentage, number of points or a special “none/auto” value.
Экземпляры этого класса неизменяемы.
Примеры
Показывает, как установить таблицу для автоматической подгонки до 50% ширины страницы.
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"Cell #1");
builder->InsertCell();
builder->Write(u"Cell #2");
builder->InsertCell();
builder->Write(u"Cell #3");
table->set_PreferredWidth(Aspose::Words::Tables::PreferredWidth::FromPercent(50));
doc->Save(get_ArtifactsDir() + u"DocumentBuilder.InsertTableWithPreferredWidth.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();
// Существует два способа применения класса "PreferredWidth" к ячейкам таблицы.
// 1 - Установить абсолютную предпочтительную ширину в пунктах:
builder->InsertCell();
builder->get_CellFormat()->set_PreferredWidth(Aspose::Words::Tables::PreferredWidth::FromPoints(40));
builder->get_CellFormat()->get_Shading()->set_BackgroundPatternColor(System::Drawing::Color::get_LightYellow());
builder->Writeln(System::String::Format(u"Cell with a width of {0}.", builder->get_CellFormat()->get_PreferredWidth()));
// 2 - Установить относительную предпочтительную ширину в процентах от ширины таблицы:
builder->InsertCell();
builder->get_CellFormat()->set_PreferredWidth(Aspose::Words::Tables::PreferredWidth::FromPercent(20));
builder->get_CellFormat()->get_Shading()->set_BackgroundPatternColor(System::Drawing::Color::get_LightBlue());
builder->Writeln(System::String::Format(u"Cell with a width of {0}.", builder->get_CellFormat()->get_PreferredWidth()));
builder->InsertCell();
// Ячейка без указанной предпочтительной ширины займет оставшееся доступное пространство.
builder->get_CellFormat()->set_PreferredWidth(Aspose::Words::Tables::PreferredWidth::Auto());
// Каждая конфигурация свойства "PreferredWidth" создает новый объект.
ASSERT_NE(System::ObjectExt::GetHashCode(table->get_FirstRow()->get_Cells()->idx_get(1)->get_CellFormat()->get_PreferredWidth()), System::ObjectExt::GetHashCode(builder->get_CellFormat()->get_PreferredWidth()));
builder->get_CellFormat()->get_Shading()->set_BackgroundPatternColor(System::Drawing::Color::get_LightGreen());
builder->Writeln(u"Automatically sized cell.");
doc->Save(get_ArtifactsDir() + u"DocumentBuilder.InsertCellsWithPreferredWidths.docx");
См. также
- Namespace Aspose::Words::Tables
- Library Aspose.Words for C++
