CellFormat

CellFormat class

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

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

public class CellFormat

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

ИмяОписание
Borders { get; }Получает коллекцию границ ячейки.
BottomPadding { get; set; }Возвращает или задает размер пространства (в пунктах), добавляемого под содержимым ячейки.
FitText { get; set; }Еслиистинный , вписывает текст в ячейку, сжимая каждый абзац до ширины ячейки.
HideMark { get; set; }Возвращает или задает видимость метки ячейки.
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; }Еслиистинный , перенос текста для ячейки.

Методы

ИмяОписание
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 Class CellMerge Enum