Style

Style class

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

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

public class Style

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

ИмяОписание
Aliases { get; }Получает все псевдонимы этого стиля. Если у стиля нет псевдонимов, то возвращается пустой массив строк.
AutomaticallyUpdate { get; set; }Указывает, будет ли этот стиль автоматически переопределяться на основе соответствующего значения.
BaseStyleName { get; set; }Получает/задает имя стиля, на котором основан этот стиль.
BuiltIn { get; }Истина, если этот стиль является одним из встроенных стилей в MS Word.
Document { get; }Получает документ владельца.
Font { get; }Получает форматирование символов стиля.
IsHeading { get; }Истинно, когда стиль является одним из встроенных стилей заголовков.
IsQuickStyle { get; set; }Указывает, отображается ли этот стиль в галерее быстрых стилей в пользовательском интерфейсе MS Word.
LinkedStyleName { get; set; }Получает/устанавливает имяStyle связан с этим. Возвращает пустую строку, если ни один стиль не связан.
List { get; }Получает список, определяющий форматирование этого стиля списка.
ListFormat { get; }Предоставляет доступ к свойствам форматирования списка стиля абзаца.
Locked { get; set; }Указывает, заблокирован ли этот стиль.
Name { get; set; }Получает или задает имя стиля.
NextParagraphStyleName { get; set; }Возвращает/задает имя стиля, который будет автоматически применен к новому абзацу, вставленному после абзаца a , отформатированного с использованием указанного стиля.
ParagraphFormat { get; }Получает форматирование абзаца стиля.
Priority { get; set; }Возвращает/задает целочисленное значение, представляющее приоритет сортировки стилей на панели задач «Стили».
SemiHidden { get; set; }Возвращает/задает, будет ли стиль скрыт из галереи стилей и из панели задач «Стили».
StyleIdentifier { get; }Получает независимый от локали идентификатор стиля для встроенного стиля.
Styles { get; }Получает коллекцию стилей, к которой принадлежит этот стиль.
Type { get; }Получает тип стиля (абзац или символ).
UnhideWhenUsed { get; set; }Возвращает/задает, отображается ли стиль, используемый в текущем документе, из галереи стилей и из панели задач «Стили». True, когда используемый стиль должен отображаться в галерее стилей.

Методы

ИмяОписание
Equals(Style)Сравнивает с указанным стилем. Сравниваются только стили Istds для встроенных стилей. Стили по умолчанию не включаются в сравнение. Базовый стиль, связанный стиль и стиль следующего абзаца сравниваются рекурсивно.
Remove()Удаляет указанный стиль из документа.

Примеры

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

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

// Создать пользовательский стиль абзаца.
Style style = doc.Styles.Add(StyleType.Paragraph, "MyStyle1");
style.Font.Size = 24;
style.Font.Name = "Verdana";
style.ParagraphFormat.SpaceAfter = 12;

// Создайте список и убедитесь, что абзацы, использующие этот стиль, будут использовать этот список.
style.ListFormat.List = doc.Lists.Add(ListTemplate.BulletDefault);
style.ListFormat.ListLevelNumber = 0;

// Применяем стиль абзаца к текущему абзацу конструктора документа, а затем добавляем текст.
builder.ParagraphFormat.Style = style;
builder.Writeln("Hello World: MyStyle1, bulleted list.");

// Измените стиль конструктора документов на такой, который не имеет форматирования списка, и напишите еще один абзац.
builder.ParagraphFormat.Style = doc.Styles["Normal"];
builder.Writeln("Hello World: Normal.");

builder.Document.Save(ArtifactsDir + "Styles.ParagraphStyleBulletedList.docx");

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

Document doc = new Document();

Style style = doc.Styles.Add(StyleType.Paragraph, "MyStyle");
style.Font.Name = "Times New Roman";
style.Font.Size = 16;
style.Font.Color = Color.Navy;
// Автоматически переопределить стиль.
style.AutomaticallyUpdate = true;

DocumentBuilder builder = new DocumentBuilder(doc);

// Применить один из стилей документа к абзацу, создаваемому конструктором документа.
builder.ParagraphFormat.Style = doc.Styles["MyStyle"];
builder.Writeln("Hello world!");

Style firstParagraphStyle = doc.FirstSection.Body.FirstParagraph.ParagraphFormat.Style;

Assert.AreEqual(style, firstParagraphStyle);

// Удаляем наш пользовательский стиль из коллекции стилей документа.
doc.Styles["MyStyle"].Remove();

firstParagraphStyle = doc.FirstSection.Body.FirstParagraph.ParagraphFormat.Style;

// Любой текст, в котором использовался удаленный стиль, возвращается к форматированию по умолчанию.
Assert.False(doc.Styles.Any(s => s.Name == "MyStyle"));
Assert.AreEqual("Times New Roman", firstParagraphStyle.Font.Name);
Assert.AreEqual(12.0d, firstParagraphStyle.Font.Size);
Assert.AreEqual(Color.Empty.ToArgb(), firstParagraphStyle.Font.Color.ToArgb());

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

StoryType Enum StyleCollection Class