Aspose::Words::Style class

Style class

Представляет один встроенный или пользовательский стиль. Чтобы узнать больше, посетите статью документации Working with Styles and Themes.

class Style : public Aspose::Words::IParaAttrSource,
              public Aspose::Words::IRunAttrSource

Методы

МетодОписание
Equals(const System::SharedPtr<Aspose::Words::Style>&)Сравнивает с указанным стилем. Styles Istds сравниваются только для встроенных стилей. Значения по умолчанию стилей не включаются в сравнение. Базовый стиль, связанный стиль и стиль следующего абзаца сравниваются рекурсивно.
get_Aliases()Получает все псевдонимы этого стиля. Если у стиля нет псевдонимов, возвращается пустой массив строк.
get_AutomaticallyUpdate() constУказывает, переопределяется ли этот стиль автоматически на основе соответствующего значения.
get_BaseStyleName()Получает/устанавливает имя стиля, на котором основан этот стиль.
get_BuiltIn()True, если этот стиль является одним из встроенных стилей в MS Word.
get_Document()Получает документ‑владельца.
get_Font()Получает символьное форматирование стиля.
get_IsHeading()True, когда стиль является одним из встроенных стилей Heading.
get_IsQuickStyle() constУказывает, отображается ли этот стиль в быстрой галерее Style внутри пользовательского интерфейса MS Word.
get_LinkedStyleName()Получает/устанавливает имя Style, связанного с этим. Возвращает пустую строку, если стили не связаны.
get_List()Получает список, определяющий форматирование этого стиля списка.
get_ListFormat()Обеспечивает доступ к свойствам форматирования списка стиля абзаца.
get_Locked() constУказывает, заблокирован ли этот стиль.
get_Name() constПолучает или устанавливает имя стиля.
get_NextParagraphStyleName()Получает/устанавливает имя стиля, который будет автоматически применяться к новому абзацу, вставленному после абзаца, отформатированного указанным стилем.
get_ParagraphFormat()Получает форматирование абзаца стиля.
get_Priority() constПолучает/устанавливает целочисленное значение, представляющее приоритет сортировки стилей в панели задач Styles.
get_SemiHidden() constПолучает/устанавливает, скрывается ли стиль в галерее Стилей и на панели задач Стилей.
get_StyleIdentifier() constПолучает независимый от локали идентификатор стиля для встроенного стиля.
get_Styles() constПолучает коллекцию стилей, к которым принадлежит этот стиль.
get_Type() constПолучает тип стиля (абзацный или символьный).
get_UnhideWhenUsed() constПолучает/устанавливает, отображается ли используемый в текущем документе стиль в галерее Стилей и на панели задач Стилей. Истина, когда используемый стиль должен отображаться в галерее Стилей.
GetType() const override
Is(const System::TypeInfo&) const override
Remove()Удаляет указанный стиль из документа.
set_AutomaticallyUpdate(bool)Сеттер для Aspose::Words::Style::get_AutomaticallyUpdate.
set_BaseStyleName(const System::String&)Сеттер для Aspose::Words::Style::get_BaseStyleName.
set_IsQuickStyle(bool)Сеттер для Aspose::Words::Style::get_IsQuickStyle.
set_LinkedStyleName(const System::String&)Сеттер для Aspose::Words::Style::get_LinkedStyleName.
set_Locked(bool)Сеттер для Aspose::Words::Style::get_Locked.
set_Name(const System::String&)Сеттер для Aspose::Words::Style::get_Name.
set_NextParagraphStyleName(const System::String&)Сеттер для Aspose::Words::Style::get_NextParagraphStyleName.
set_Priority(int32_t)Сеттер для Aspose::Words::Style::get_Priority.
set_SemiHidden(bool)Сеттер для Aspose::Words::Style::get_SemiHidden.
set_UnhideWhenUsed(bool)Сеттер для Aspose::Words::Style::get_UnhideWhenUsed.
static Type()

Примеры

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

auto doc = System::MakeObject<Aspose::Words::Document>();

System::SharedPtr<Aspose::Words::Style> style = doc->get_Styles()->Add(Aspose::Words::StyleType::Paragraph, u"MyStyle");
style->get_Font()->set_Name(u"Times New Roman");
style->get_Font()->set_Size(16);
style->get_Font()->set_Color(System::Drawing::Color::get_Navy());
// Автоматически переопределить стиль.
style->set_AutomaticallyUpdate(true);

auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

// Примените один из стилей документа к абзацу, который создает DocumentBuilder.
builder->get_ParagraphFormat()->set_Style(doc->get_Styles()->idx_get(u"MyStyle"));
builder->Writeln(u"Hello world!");

System::SharedPtr<Aspose::Words::Style> firstParagraphStyle = doc->get_FirstSection()->get_Body()->get_FirstParagraph()->get_ParagraphFormat()->get_Style();

ASPOSE_ASSERT_EQ(style, firstParagraphStyle);

// Удалите наш пользовательский стиль из коллекции стилей документа.
doc->get_Styles()->idx_get(u"MyStyle")->Remove();

firstParagraphStyle = doc->get_FirstSection()->get_Body()->get_FirstParagraph()->get_ParagraphFormat()->get_Style();

// Любой текст, использующий удалённый стиль, возвращается к форматированию по умолчанию.
ASSERT_FALSE(doc->get_Styles()->LINQ_Any(static_cast<System::Func<System::SharedPtr<Aspose::Words::Style>, bool>>(static_cast<std::function<bool(System::SharedPtr<Aspose::Words::Style> s)>>([](System::SharedPtr<Aspose::Words::Style> s) -> bool
{
    return s->get_Name() == u"MyStyle";
}))));
ASSERT_EQ(u"Times New Roman", firstParagraphStyle->get_Font()->get_Name());
ASPOSE_ASSERT_EQ(12.0, firstParagraphStyle->get_Font()->get_Size());
ASSERT_EQ(System::Drawing::Color::Empty.ToArgb(), firstParagraphStyle->get_Font()->get_Color().ToArgb());

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

auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

// Создайте пользовательский абзацный стиль.
System::SharedPtr<Aspose::Words::Style> style = doc->get_Styles()->Add(Aspose::Words::StyleType::Paragraph, u"MyStyle1");
style->get_Font()->set_Size(24);
style->get_Font()->set_Name(u"Verdana");
style->get_ParagraphFormat()->set_SpaceAfter(12);

// Создайте список и убедитесь, что абзацы, использующие этот стиль, будут использовать этот список.
style->get_ListFormat()->set_List(doc->get_Lists()->Add(Aspose::Words::Lists::ListTemplate::BulletDefault));
style->get_ListFormat()->set_ListLevelNumber(0);

// Примените абзацный стиль к текущему абзацу DocumentBuilder, а затем добавьте некоторый текст.
builder->get_ParagraphFormat()->set_Style(style);
builder->Writeln(u"Hello World: MyStyle1, bulleted list.");

// Измените стиль DocumentBuilder на такой, который не содержит форматирования списка, и напишите еще один абзац.
builder->get_ParagraphFormat()->set_Style(doc->get_Styles()->idx_get(u"Normal"));
builder->Writeln(u"Hello World: Normal.");

builder->get_Document()->Save(get_ArtifactsDir() + u"Styles.ParagraphStyleBulletedList.docx");

См. также

Aspose::Words::Story class Aspose::Words::StyleCollection класс