Aspose::Words::Font class

Font class

Содержит атрибуты шрифта (название шрифта, размер шрифта, цвет и т.д.) для объекта. Чтобы узнать больше, посетите статью документации Working with Fonts.

class Font : public Aspose::Words::IBorderAttrSource,
             public Aspose::Words::IShadingAttrSource,
             public Aspose::Words::Drawing::Core::IFillable

Методы

МетодОписание
ClearFormatting()Сбрасывает форматирование шрифта к значениям по умолчанию.
get_AllCaps()Истина, если шрифт отформатирован как все заглавные буквы.
get_AutoColor()Возвращает текущий вычисленный цвет текста (чёрный или белый), используемый для «auto color». Если цвет не «auto», то возвращает Color.
get_Bidi()Указывает, должны ли содержимое этого фрагмента иметь свойства справа налево.
get_Bold()True, если шрифт оформлен как полужирный.
get_BoldBi()Истина, если текст справа налево отформатирован полужирным.
get_Border()Возвращает объект Border, который задаёт границу для шрифта.
get_Color()Получает или задаёт цвет шрифта.
get_ComplexScript()Указывает, следует ли рассматривать содержимое этого фрагмента как текст сложного сценария независимо от их значений Unicode при определении форматирования этого фрагмента.
get_DoubleStrikeThrough()Истина, если шрифт отформатирован как двойное зачеркивание.
get_Emboss()Истина, если шрифт отформатирован как рельефный.
get_EmphasisMark()Получает или задаёт знак акцента, применяемый к этому форматированию.
get_Engrave()Истина, если шрифт отформатирован как гравированный.
get_Fill()Получает формат заполнения для Font.
get_Hidden()Истина, если шрифт отформатирован как скрытый текст.
get_HighlightColor()Получает или задаёт цвет выделения (маркер).
get_Italic()True, если шрифт оформлен курсивом.
get_ItalicBi()Истина, если текст справа налево отформатирован курсивом.
get_Kerning()Получает или задаёт размер шрифта, с которого начинается кернинг.
get_LineSpacing()Возвращает межстрочный интервал этого шрифта (в пунктах).
get_LocaleId()Получает или задаёт идентификатор локали (язык) отформатированных символов.
get_LocaleIdBi()Получает или задаёт идентификатор локали (язык) отформатированных символов справа налево.
get_LocaleIdFarEast()Получает или задаёт идентификатор локали (язык) отформатированных азиатских символов.
get_Name()Получает или задаёт название шрифта.
get_NameAscii()Возвращает или задаёт шрифт, используемый для латинского текста (символы с кодами от 0 (ноль) до 127).
get_NameBi()Возвращает или задаёт название шрифта в документе на языке с направлением справа налево.
get_NameFarEast()Возвращает или задаёт название восточноазиатского шрифта.
get_NameOther()Возвращает или задает шрифт, используемый для символов с кодами от 128 до 255.
get_NoProofing()Истина, когда отформатированные символы не подлежат проверке орфографии.
get_NumberSpacing()Получает или задает тип интервала цифры, отображаемой.
get_Outline()Истина, если шрифт отформатирован как контур.
get_Position()Получает или задает позицию текста (в пунктах) относительно базовой линии. Положительное число поднимает текст, а отрицательное опускает его.
get_Scaling()Получает или задает масштабирование ширины символов в процентах.
get_Shading()Возвращает объект Shading, который ссылается на форматирование затенения для шрифта.
get_Shadow()Истина, если шрифт отформатирован как с тенью.
get_Size()Получает или задает размер шрифта в пунктах.
get_SizeBi()Получает или задает размер шрифта в пунктах, используемый в документе с направлением справа налево.
get_SmallCaps()Истина, если шрифт отформатирован как малые заглавные буквы.
get_SnapToGrid()Указывает, следует ли текущему шрифту использовать настройки сетки документа «символов в строке» при размещении.
get_Spacing()Возвращает или задает интервал (в пунктах) между символами.
get_StrikeThrough()Истина, если шрифт отформатирован как перечёркнутый текст.
get_Style()Получает или задает стиль символов, применяемый к этому форматированию.
get_StyleIdentifier()Получает или задает независимый от локали идентификатор стиля символов, применяемый к этому форматированию.
get_StyleName()Получает или задает имя стиля символов, применяемого к этому форматированию.
get_Subscript()Истина, если шрифт отформатирован как нижний индекс.
get_Superscript()Истина, если шрифт отформатирован как верхний индекс.
get_TextEffect()Получает или задает эффект анимации шрифта.
get_ThemeColor()Получает или задает цвет темы в применяемой цветовой схеме, связанной с этим объектом Font.
get_ThemeFont()Получает или задает шрифт темы в применяемой схеме шрифтов, связанной с этим объектом Font.
get_ThemeFontAscii()Получает или задает шрифт темы, используемый для латинского текста (символы с кодами от 0 (ноль) до 127) в применяемой схеме шрифтов, связанной с этим объектом Font.
get_ThemeFontBi()Получает или задает шрифт темы в применяемой схеме шрифтов, связанной с этим объектом Font в документе с языком справа налево.
get_ThemeFontFarEast()Получает или задает восточноазиатский шрифт темы в применяемой схеме шрифтов, связанной с этим объектом Font.
get_ThemeFontOther()Получает или задает шрифт темы, используемый для символов с кодами от 128 до 255 в применяемой схеме шрифтов, связанной с этим объектом Font.
get_TintAndShade()Получает или задаёт двойное значение, которое осветляет или затемняет цвет.
get_Underline()Получает или задает тип подчеркивания, применяемого к шрифту.
get_UnderlineColor()Получает или задает цвет подчеркивания, применяемого к шрифту.
GetType() const override
HasDmlEffect(Aspose::Words::TextDmlEffect)Проверяет, применён ли конкретный эффект текста DrawingML.
Is(const System::TypeInfo&) const override
set_AllCaps(bool)Сеттер для Aspose::Words::Font::get_AllCaps.
set_Bidi(bool)Сеттер для Aspose::Words::Font::get_Bidi.
set_Bold(bool)Сеттер для Aspose::Words::Font::get_Bold.
set_BoldBi(bool)Сеттер для Aspose::Words::Font::get_BoldBi.
set_Color(System::Drawing::Color)Сеттер для Aspose::Words::Font::get_Color.
set_ComplexScript(bool)Сеттер для Aspose::Words::Font::get_ComplexScript.
set_DoubleStrikeThrough(bool)Сеттер для Aspose::Words::Font::get_DoubleStrikeThrough.
set_Emboss(bool)Сеттер для Aspose::Words::Font::get_Emboss.
set_EmphasisMark(Aspose::Words::EmphasisMark)Сеттер для Aspose::Words::Font::get_EmphasisMark.
set_Engrave(bool)Сеттер для Aspose::Words::Font::get_Engrave.
set_Hidden(bool)Сеттер для Aspose::Words::Font::get_Hidden.
set_HighlightColor(System::Drawing::Color)Сеттер для Aspose::Words::Font::get_HighlightColor.
set_Italic(bool)Сеттер для Aspose::Words::Font::get_Italic.
set_ItalicBi(bool)Сеттер для Aspose::Words::Font::get_ItalicBi.
set_Kerning(double)Сеттер для Aspose::Words::Font::get_Kerning.
set_LocaleId(int32_t)Сеттер для Aspose::Words::Font::get_LocaleId.
set_LocaleIdBi(int32_t)Сеттер для Aspose::Words::Font::get_LocaleIdBi.
set_LocaleIdFarEast(int32_t)Сеттер для Aspose::Words::Font::get_LocaleIdFarEast.
set_Name(const System::String&)Сеттер для Aspose::Words::Font::get_Name.
set_NameAscii(const System::String&)Сеттер для Aspose::Words::Font::get_NameAscii.
set_NameBi(const System::String&)Сеттер для Aspose::Words::Font::get_NameBi.
set_NameFarEast(const System::String&)Сеттер для Aspose::Words::Font::get_NameFarEast.
set_NameOther(const System::String&)Сеттер для Aspose::Words::Font::get_NameOther.
set_NoProofing(bool)Сеттер для Aspose::Words::Font::get_NoProofing.
set_NumberSpacing(Aspose::Words::NumSpacing)Сеттер для Aspose::Words::Font::get_NumberSpacing.
set_Outline(bool)Сеттер для Aspose::Words::Font::get_Outline.
set_Position(double)Сеттер для Aspose::Words::Font::get_Position.
set_Scaling(int32_t)Сеттер для Aspose::Words::Font::get_Scaling.
set_Shadow(bool)Сеттер для Aspose::Words::Font::get_Shadow.
set_Size(double)Сеттер для Aspose::Words::Font::get_Size.
set_SizeBi(double)Сеттер для Aspose::Words::Font::get_SizeBi.
set_SmallCaps(bool)Сеттер для Aspose::Words::Font::get_SmallCaps.
set_SnapToGrid(bool)Указывает, следует ли текущему шрифту использовать настройки сетки документа «символов в строке» при размещении.
set_Spacing(double)Сеттер для Aspose::Words::Font::get_Spacing.
set_StrikeThrough(bool)Сеттер для Aspose::Words::Font::get_StrikeThrough.
set_Style(const System::SharedPtr<Aspose::Words::Style>&)Сеттер для Aspose::Words::Font::get_Style.
set_StyleIdentifier(Aspose::Words::StyleIdentifier)Сеттер для Aspose::Words::Font::get_StyleIdentifier.
set_StyleName(const System::String&)Сеттер для Aspose::Words::Font::get_StyleName.
set_Subscript(bool)Сеттер для Aspose::Words::Font::get_Subscript.
set_Superscript(bool)Сеттер для Aspose::Words::Font::get_Superscript.
set_TextEffect(Aspose::Words::TextEffect)Сеттер для Aspose::Words::Font::get_TextEffect.
set_ThemeColor(Aspose::Words::Themes::ThemeColor)Сеттер для Aspose::Words::Font::get_ThemeColor.
set_ThemeFont(Aspose::Words::Themes::ThemeFont)Сеттер для Aspose::Words::Font::get_ThemeFont.
set_ThemeFontAscii(Aspose::Words::Themes::ThemeFont)Сеттер для Aspose::Words::Font::get_ThemeFontAscii.
set_ThemeFontBi(Aspose::Words::Themes::ThemeFont)Сеттер для Aspose::Words::Font::get_ThemeFontBi.
set_ThemeFontFarEast(Aspose::Words::Themes::ThemeFont)Сеттер для Aspose::Words::Font::get_ThemeFontFarEast.
set_ThemeFontOther(Aspose::Words::Themes::ThemeFont)Сеттер для Aspose::Words::Font::get_ThemeFontOther.
set_TintAndShade(double)Сеттер для Aspose::Words::Font::get_TintAndShade.
set_Underline(Aspose::Words::Underline)Сеттер для Aspose::Words::Font::get_Underline.
set_UnderlineColor(System::Drawing::Color)Сеттер для Aspose::Words::Font::get_UnderlineColor.
static Type()

Примечания

Вы не создаёте экземпляры класса Font напрямую. Вы просто используете Font для доступа к свойствам шрифта различных объектов, таких как Run, Paragraph, Style, DocumentBuilder.

Примеры

Показывает, как вставить строку, окружённую границей, в документ.

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

builder->get_Font()->get_Border()->set_Color(System::Drawing::Color::get_Green());
builder->get_Font()->get_Border()->set_LineWidth(2.5);
builder->get_Font()->get_Border()->set_LineStyle(Aspose::Words::LineStyle::DashDotStroker);

builder->Write(u"Text surrounded by green border.");

doc->Save(get_ArtifactsDir() + u"Border.FontBorder.docx");

Показывает, как форматировать run текста, используя его свойство font.

auto doc = System::MakeObject<Aspose::Words::Document>();
auto run = System::MakeObject<Aspose::Words::Run>(doc, u"Hello world!");

System::SharedPtr<Aspose::Words::Font> font = run->get_Font();
font->set_Name(u"Courier New");
font->set_Size(36);
font->set_HighlightColor(System::Drawing::Color::get_Yellow());

doc->get_FirstSection()->get_Body()->get_FirstParagraph()->AppendChild<System::SharedPtr<Aspose::Words::Run>>(run);
doc->Save(get_ArtifactsDir() + u"Font.CreateFormattedRun.docx");

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

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::FileFormatUtil класс Класс Aspose::Words::FontSubstitutionWarningInfo