Интерфейс 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

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

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

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

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