Интерфейс ITextFont (tom.h)

Доступ к атрибутам диапазона форматированного текста текстовой модели (TOM) осуществляется через пару двойных интерфейсов : ITextFont и ITextPara.

Наследование

Интерфейс ITextFont наследуется от интерфейса IUnknown . ITextFont также имеет следующие типы элементов:

Методы

Интерфейс ITextFont содержит следующие методы.

 
ITextFont::CanChange

Определяет, можно ли изменить шрифт.
ITextFont::GetAllCaps

Возвращает значение, указывая, являются ли все символы прописными.
ITextFont::GetAnimation

Возвращает тип анимации.
ITextFont::GetBackColor

Получает цвет фона текста (выделения).
ITextFont::GetBold

Возвращает значение, определяющее, выделены ли символы полужирным шрифтом.
ITextFont::GetDuplicate

Возвращает дубликат этого объекта текстового шрифта.
ITextFont::GetEmboss

Возвращает значение, указывая, имеют ли символы тиснением.
ITextFont::GetEngrave

Возвращает значение, указывая, отображаются ли символы в виде отпечатанных символов.
ITextFont::GetForeColor

Возвращает цвет переднего плана или текста.
ITextFont::GetHidden

Возвращает значение, указывая, скрыты ли символы.
ITextFont::GetItalic

Возвращает значение, указывая, имеют ли символы курсив.
ITextFont::GetKerning

Возвращает минимальный размер шрифта, при котором выполняется кернинг.
ITextFont::GetLanguageID

Возвращает идентификатор языка или код языка (LCID).
ITextFont::GetName

Возвращает имя шрифта.
ITextFont::GetOutline

Возвращает значение, указывая, отображаются ли символы в виде контурных символов.
ITextFont::GetPosition

Возвращает величину смещения символов по вертикали относительно базового плана.
ITextFont::GetProtected

Возвращает значение, определяющее, защищены ли символы от попыток их изменения.
ITextFont::GetShadow

Возвращает значение, указываемое на отображение символов в виде затенения.
ITextFont::GetSize

Возвращает размер шрифта. (ITextFont.GetSize)
ITextFont::GetSmallCaps

Возвращает значение, указывая, имеют ли символы мелкие прописные буквы.
ITextFont::GetSpacing

Возвращает объем горизонтального интервала между символами.
ITextFont::GetStrikeThrough

Возвращает значение, указываемое, отображаются ли символы горизонтальной линией по центру.
ITextFont::GetStyle

Возвращает дескриптор стиля символов в диапазоне.
ITextFont::GetSubscript

Возвращает значение, указываемое, отображаются ли символы как подстрочные.
ITextFont::GetSuperscript

Возвращает значение, указываемое, отображаются ли символы как надстрочные.
ITextFont::GetUnderline

Возвращает тип подчеркивания для символов в диапазоне.
ITextFont::GetWeight

Возвращает вес шрифта для символов в диапазоне.
ITextFont::IsEqual

Определяет, имеет ли объект текстового шрифта те же свойства, что и указанный объект текстового шрифта. (ITextFont.IsEqual)
ITextFont::Reset

Сбрасывает форматирование символов до указанных значений.
ITextFont::SetAllCaps

Задает значение, указывая, являются ли все символы прописными.
ITextFont::SetAnimation

Задает тип анимации.
ITextFont::SetBackColor

Задает цвет фона.
ITextFont::SetBold

Задает, являются ли символы полужирными.
ITextFont::SetDuplicate

Задает форматирование символов путем копирования другого объекта текстового шрифта.
ITextFont::SetEmboss

Задает, будут ли символы тиснением.
ITextFont::SetEngrave

Задает, отображаются ли символы как отпечатанные символы.
ITextFont::SetForeColor

Задает цвет переднего плана (текста).
ITextFont::SetHidden

Задает значение, указывая, скрыты ли символы.
ITextFont::SetItalic

Задает, являются ли символы курсивом.
ITextFont::SetKerning

Задает минимальный размер шрифта, при котором выполняется кернинг.
ITextFont::SetLanguageID

Задает идентификатор языка или код языка (LCID).
ITextFont::SetName

Задает имя шрифта.
ITextFont::SetOutline

Задает, будут ли символы отображаться в виде контурных символов.
ITextFont::SetPosition

Задает величину смещения символов по вертикали относительно базового плана.
ITextFont::SetProtected

Задает, защищены ли символы от попыток их изменения.
ITextFont::SetShadow

Задает, отображаются ли символы как затеняемые символы.
ITextFont::SetSize

Задает размер шрифта.
ITextFont::SetSmallCaps

Задает, будут ли символы мелкими прописными буквами.
ITextFont::SetSpacing

Задает интервал между символами по горизонтали.
ITextFont::SetStrikeThrough

Задает, отображаются ли символы горизонтальной линией по центру.
ITextFont::SetStyle

Задает дескриптор стиля символов в диапазоне.
ITextFont::SetSubscript

Задает, отображаются ли символы как подстрочные.
ITextFont::SetSuperscript

Задает, отображаются ли символы как надстрочные.
ITextFont::SetUnderline

Задает тип подчеркивания для символов в диапазоне.
ITextFont::SetWeight

Задает вес шрифта для символов в диапазоне.

Комментарии

Интерфейсы ITextFont и ITextPara инкапсулируют функциональные возможности диалоговых окон "Шрифт и Абзац" microsoft Word соответственно. Оба интерфейса включают свойство-дубликат (Значение), которое может возвращать дубликаты атрибутов в объекте диапазона или передавать набор атрибутов в диапазон. Таким образом, они действуют как программируемые художники формата. Например, можно перенести все атрибуты из диапазона r1 в диапазон r2, за исключением выделения полужирного шрифта r2 и размера шрифта 12 точек с помощью следующей подпрограммы.

Sub AttributeCopy(r1 As ITextRange, r2 As ITextRange)
    Dim tf As ITextFont
    tf = r1.Font                ' Value is the default property    
    tf.Bold = tomTrue           ' You can make some modifications
    tf.Size = 12
    tf.Animation = tomSparkleText
    r2.Font = tf                ' Apply font attributes all at once
End Sub

Аналогичный пример, написанный на C++, см. в разделе SetFont .

Интерфейс атрибута ITextFont представляет традиционный способ настройки свойств microsoft Visual Basic для приложений (VBA) и предоставляет требуемую нотацию VBA.

ITextFont использует тип tomBool для атрибутов форматированного текста с двоичными состояниями. Дополнительные сведения см. в разделе Тип tomBool.

Элемент управления многофункциональным редактированием может принимать и возвращать все свойства ITextFont без изменений, то есть без изменений, как с помощью TOM, так и с помощью преобразователей форматов RTF. Однако он не может отображать свойства шрифта All Caps, Animation, Embossed, Imprint, Shadow, Small Caps, Hidden, Kerning, Outline и Style.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header tom.h

См. также раздел

Основные понятия

Текстовая объектная модель

Использование текстовой объектной модели