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");
Смотрите также
- пространство имен Aspose.Words.Tables
- сборка Aspose.Words