CellFormat

CellFormat class

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

public class CellFormat

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

Имя Описание
Borders { get; } Получает набор границ ячейки.
BottomPadding { get; set; } Возвращает или задает количество места (в пунктах) для добавления под содержимым ячейки.
FitText { get; set; } Если true, текст помещается в ячейку, каждый абзац сжимается до ширины ячейки.
HorizontalMerge { get; set; } Указывает, как ячейка объединяется по горизонтали с другими ячейками в строке.
LeftPadding { get; set; } Возвращает или задает количество места (в пунктах), которое нужно добавить слева от содержимого ячейки.
Orientation { get; set; } Возвращает или задает ориентацию текста в ячейке таблицы.
PreferredWidth { get; set; } Возвращает или задает предпочтительную ширину ячейки.
RightPadding { get; set; } Возвращает или задает количество места (в пунктах), которое нужно добавить справа от содержимого ячейки.
Shading { get; } Возвращает объект Shading, который ссылается на форматирование затенения для ячейки.
TopPadding { get; set; } Возвращает или задает количество места (в пунктах) для добавления над содержимым ячейки.
VerticalAlignment { get; set; } Возвращает или задает вертикальное выравнивание текста в ячейке.
VerticalMerge { get; set; } Указывает, как ячейка объединяется с другими ячейками по вертикали.
Width { get; set; } Получает ширину ячейки в пунктах.
WrapText { get; set; } Если true, перенос текста для ячейки.

Методы

Имя Описание
ClearFormatting() Восстанавливает форматирование ячейки по умолчанию. Не изменяет ширину ячейки.
SetPaddings(double, double, double, double) Устанавливает количество места (в пунктах) для добавления слева/сверху/справа/снизу содержимого ячейки.

Примеры

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

Document doc = new Document(MyDir + "Tables.docx");
Table table = doc.FirstSection.Body.Tables[0];
Cell firstCell = table.FirstRow.FirstCell;

// Используйте свойство CellFormat ячейки, чтобы установить форматирование, которое изменяет внешний вид этой ячейки.
firstCell.CellFormat.Width = 30;
firstCell.CellFormat.Orientation = TextOrientation.Downward;
firstCell.CellFormat.Shading.ForegroundPatternColor = Color.LightGreen;

doc.Save(ArtifactsDir + "Table.CellFormat.docx");

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

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

Table table = builder.StartTable();
builder.InsertCell();
builder.Write("City");
builder.InsertCell();
builder.Write("Country");
builder.EndRow();
builder.InsertCell();
builder.Write("London");
builder.InsertCell();
builder.Write("U.K.");
builder.EndTable();

// Используйте свойство "RowFormat" первой строки, чтобы изменить форматирование
// содержимого всех ячеек в этой строке.
RowFormat rowFormat = table.FirstRow.RowFormat;
rowFormat.Height = 25;
rowFormat.Borders[BorderType.Bottom].Color = Color.Red;

// Используйте свойство «CellFormat» первой ячейки в последней строке, чтобы изменить форматирование содержимого этой ячейки.
CellFormat cellFormat = table.LastRow.FirstCell.CellFormat;
cellFormat.Width = 100;
cellFormat.Shading.BackgroundPatternColor = Color.Orange;

doc.Save(ArtifactsDir + "Table.RowCellFormat.docx");

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

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

builder.StartTable();

// Установка параметров форматирования таблицы для конструктора документов
// применит их к каждой строке и ячейке, которые мы добавляем вместе с ней.
builder.ParagraphFormat.Alignment = ParagraphAlignment.Center;

builder.CellFormat.ClearFormatting();
builder.CellFormat.Width = 150;
builder.CellFormat.VerticalAlignment = CellVerticalAlignment.Center;
builder.CellFormat.Shading.BackgroundPatternColor = Color.GreenYellow;
builder.CellFormat.WrapText = false;
builder.CellFormat.FitText = true;

builder.RowFormat.ClearFormatting();
builder.RowFormat.HeightRule = HeightRule.Exactly;
builder.RowFormat.Height = 50;
builder.RowFormat.Borders.LineStyle = LineStyle.Engrave3D;
builder.RowFormat.Borders.Color = Color.Orange;

builder.InsertCell();
builder.Write("Row 1, Col 1");

builder.InsertCell();
builder.Write("Row 1, Col 2");
builder.EndRow();

// Изменение форматирования применит его к текущей ячейке,
// и любые новые ячейки, которые мы впоследствии создадим с помощью конструктора.
// Это не повлияет на ячейки, которые мы добавили ранее.
builder.CellFormat.Shading.ClearFormatting();

builder.InsertCell();
builder.Write("Row 2, Col 1");

builder.InsertCell();
builder.Write("Row 2, Col 2");

builder.EndRow();

// Увеличиваем высоту строки, чтобы она соответствовала вертикальному тексту.
builder.InsertCell();
builder.RowFormat.Height = 150;
builder.CellFormat.Orientation = TextOrientation.Upward;
builder.Write("Row 3, Col 1");

builder.InsertCell();
builder.CellFormat.Orientation = TextOrientation.Downward;
builder.Write("Row 3, Col 2");

builder.EndRow();
builder.EndTable();

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

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

CellCollection CellMerge