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");

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