ConditionalStyle

ConditionalStyle class

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

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

public sealed class ConditionalStyle

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

ИмяОписание
Borders { get; }Получает коллекцию границ ячеек по умолчанию для условного стиля.
BottomPadding { get; set; }Получает или задает объем пространства (в пунктах), добавляемого под содержимым ячеек таблицы.
Font { get; }Получает форматирование символов условного стиля.
LeftPadding { get; set; }Получает или задает объем места (в пунктах), добавляемый слева от содержимого ячеек таблицы.
ParagraphFormat { get; }Получает форматирование абзаца условного стиля.
RightPadding { get; set; }Получает или задает объем места (в пунктах), добавляемый справа от содержимого ячеек таблицы.
Shading { get; }ПолучаетShading объект, который ссылается на форматирование штриховки для этого условного стиля.
TopPadding { get; set; }Получает или задает объем пространства (в пунктах), добавляемого над содержимым ячеек таблицы.
Type { get; }Получает область таблицы, к которой относится этот условный стиль.

Методы

ИмяОписание
ClearFormatting()Очищает форматирование этого условного стиля.
override Equals(object)Сравнивает этот условный стиль с указанным объектом.
override GetHashCode()Вычисляет хеш-код для этого объекта.

Примеры

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

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.EndRow();
builder.InsertCell();
builder.Write("Cell 3");
builder.InsertCell();
builder.Write("Cell 4");
builder.EndTable();

// Создаем собственный стиль таблицы.
TableStyle tableStyle = (TableStyle)doc.Styles.Add(StyleType.Table, "MyTableStyle1");

// Условные стили — это изменения форматирования, которые затрагивают только некоторые ячейки таблицы
// на основе предиката, например, ячеек в последней строке.
// Ниже приведены три способа доступа к условным стилям табличного стиля из коллекции «ConditionalStyles».
// 1 - По типу стиля:
tableStyle.ConditionalStyles[ConditionalStyleType.FirstRow].Shading.BackgroundPatternColor = Color.AliceBlue;

// 2 - По индексу:
tableStyle.ConditionalStyles[0].Borders.Color = Color.Black;
tableStyle.ConditionalStyles[0].Borders.LineStyle = LineStyle.DotDash;
Assert.AreEqual(ConditionalStyleType.FirstRow, tableStyle.ConditionalStyles[0].Type);

// 3 - Как свойство:
tableStyle.ConditionalStyles.FirstRow.ParagraphFormat.Alignment = ParagraphAlignment.Center;

// Применяем отступы и форматирование текста к условным стилям.
tableStyle.ConditionalStyles.LastRow.BottomPadding = 10;
tableStyle.ConditionalStyles.LastRow.LeftPadding = 10;
tableStyle.ConditionalStyles.LastRow.RightPadding = 10;
tableStyle.ConditionalStyles.LastRow.TopPadding = 10;
tableStyle.ConditionalStyles.LastColumn.Font.Bold = true;

// Перечислить все возможные условия стиля.
using (IEnumerator<ConditionalStyle> enumerator = tableStyle.ConditionalStyles.GetEnumerator())
{
    while (enumerator.MoveNext())
    {
        ConditionalStyle currentStyle = enumerator.Current;
        if (currentStyle != null) Console.WriteLine(currentStyle.Type);
    }
}

// Применяем к таблице пользовательский стиль, содержащий все условные стили.
table.Style = tableStyle;

// Наш стиль по умолчанию применяет некоторые условные стили.
Assert.AreEqual(TableStyleOptions.FirstRow | TableStyleOptions.FirstColumn | TableStyleOptions.RowBands, 
    table.StyleOptions);

// Нам нужно будет самостоятельно включить все остальные стили через свойство StyleOptions.
table.StyleOptions = table.StyleOptions | TableStyleOptions.LastRow | TableStyleOptions.LastColumn;

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

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