PreferredWidth

PreferredWidth class

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

Чтобы узнать больше, посетитеРабота с таблицами документальная статья.

public sealed class PreferredWidth

Характеристики

ИмяОписание
Type { get; }Получает единицу измерения, используемую для этого предпочтительного значения ширины.
Value { get; }Получает предпочтительное значение ширины. Единица измерения указана вType свойство.

Методы

ИмяОписание
static FromPercent(double)Метод создания, который возвращает новый экземпляр, представляющий предпочтительную ширину, указанную в процентах.
static FromPoints(double)Метод создания, который возвращает новый экземпляр, представляющий предпочтительную ширину, указанную с использованием ряда точек.
override Equals(object)Определяет, равен ли указанный объект по значению текущему объекту.
Equals(PreferredWidth)Определяет, является ли указанныйPreferredWidth равен по значению текущемуPreferredWidth .
override GetHashCode()Служит хэш-функцией для этого типа.
override ToString()Возвращает удобную для пользователя строку, отображающую значение этого объекта.

Поля

ИмяОписание
static readonly AutoВозвращает экземпляр, представляющий значение «предпочтительная ширина не указана».

Примечания

Предпочтительную ширину можно указать в процентах, количестве точек или в виде специального значения «нет/авто».

Экземпляры этого класса неизменяемы.

Примеры

Показывает, как настроить автоматическое подгонку таблицы под ширину страницы (50%).

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Table table = builder.StartTable();
builder.InsertCell();
builder.Write("Cell #1");
builder.InsertCell();
builder.Write("Cell #2");
builder.InsertCell();
builder.Write("Cell #3");

table.PreferredWidth = PreferredWidth.FromPercent(50);

doc.Save(ArtifactsDir + "DocumentBuilder.InsertTableWithPreferredWidth.docx");

Показывает, как установить предпочтительную ширину ячеек таблицы.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Table table = builder.StartTable();

// Существует два способа применения класса «PreferredWidth» к ячейкам таблицы.
// 1 — Установить абсолютную предпочтительную ширину на основе точек:
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPoints(40);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightYellow;
builder.Writeln($"Cell with a width of {builder.CellFormat.PreferredWidth}.");

// 2 - Установить относительную предпочтительную ширину на основе процента от ширины таблицы:
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPercent(20);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightBlue;
builder.Writeln($"Cell with a width of {builder.CellFormat.PreferredWidth}.");

builder.InsertCell();

// Ячейка, для которой не указана предпочтительная ширина, займет оставшееся доступное пространство.
builder.CellFormat.PreferredWidth = PreferredWidth.Auto;

// Каждая конфигурация свойства «PreferredWidth» создает новый объект.
Assert.AreNotEqual(table.FirstRow.Cells[1].CellFormat.PreferredWidth.GetHashCode(),
    builder.CellFormat.PreferredWidth.GetHashCode());

builder.CellFormat.Shading.BackgroundPatternColor = Color.LightGreen;
builder.Writeln("Automatically sized cell.");

doc.Save(ArtifactsDir + "DocumentBuilder.InsertCellsWithPreferredWidths.docx");

Смотрите также

CellVerticalAlignment Enum PreferredWidthType Enum