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

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

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

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

Методы

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

ITextPara::AddTab Добавляет вкладку с перемещением tbPos с типом tbAlign и стилем лидера tbLeader.
ITextPara::CanChange Определяет, можно ли изменить форматирование абзаца.
ITextPara::ClearAllTabs Очищает все вкладки, возвращая их к равным местам с интервалом между вкладками по умолчанию.
ITextPara::D eleteTab Удаляет вкладку с указанным смещением.
ITextPara::GetAlignment Извлекает текущее значение выравнивания абзаца.
ITextPara::GetDuplicate Создает дубликат указанного объекта формата абзаца. Свойство дубликата является свойством по умолчанию объекта ITextPara.
ITextPara::GetFirstLineIndent Извлекает значение, используемое для отступа первой строки абзаца относительно отступа слева. Левый отступ является отступом для всех строк абзаца, кроме первой строки.
ITextPara::GetHyphenation Определяет, включено ли автоматическое расстановка переносов для диапазона.
ITextPara::GetKeepTogether Определяет, разрешены ли разрывы страниц в абзацах.
ITextPara::GetKeepWithNext Определяет, разрешены ли разрывы страниц между абзацами в диапазоне.
ITextPara::GetLeftIndent Извлекает расстояние, используемое для отступа всех строк, кроме первой строки абзаца. Расстояние относительно левого поля.
ITextPara::GetLineSpacing Извлекает значение междустрочного интервала для текстового диапазона.
ITextPara::GetLineSpacingRule Извлекает правило междустрочного интервала для текстового диапазона.
ITextPara::GetListAlignment Извлекает тип выравнивания, используемый для маркированных и нумерованных списков.
ITextPara::GetListLevelIndex Извлекает индекс уровня списка, используемый с абзацами.
ITextPara::GetListStart Извлекает начальное значение или код последовательности нумерирования списка.
ITextPara::GetListTab Извлекает параметр вкладки списка, который представляет собой расстояние между отступом первой строки и текстом в первой строке. Нумерованный или маркированный текст имеет отступ по левому краю, по центру или по правому краю.
ITextPara::GetListType Извлекает тип нумерирования для использования с абзацами.
ITextPara::GetNoLineNumber Определяет, включена ли нумерирование абзаца.
ITextPara::GetPageBreakBefore Определяет, должен ли каждый абзац в диапазоне начинаться с новой страницы.
ITextPara::GetRightIndent Извлекает размер отступа правого поля абзаца.
ITextPara::GetSpaceAfter Извлекает объем вертикального пространства под абзацем.
ITextPara::GetSpaceBefore Извлекает объем вертикального пространства над абзацем.
ITextPara::GetStyle Извлекает дескриптор стиля для абзацев в указанном диапазоне.
ITextPara::GetTab Извлекает параметры вкладки (смещение, выравнивание и стиль лидера) для указанной вкладки.
ITextPara::GetTabCount Извлекает число вкладок.
ITextPara::GetWidowControl Извлекает состояние управления вдовой и потерянной для абзацев в диапазоне.
ITextPara::IsEqual Определяет, имеет ли текущий диапазон те же свойства, что и указанный диапазон.
ITextPara::Reset Сбрасывает форматирование абзаца на выбор значений по умолчанию.
ITextPara::SetAlignment Задает выравнивание абзаца.
ITextPara::SetDuplicate Задает форматирование для существующего абзаца путем копирования заданного формата.
ITextPara::SetHyphenation Управляет переносом абзацев в диапазоне.
ITextPara::SetIndents Задает отступ первой строки, левый отступ и правый отступ для абзаца.
ITextPara::SetKeepTogether Определяет, разрешены ли разрывы страниц в абзаце в диапазоне.
ITextPara::SetKeepWithNext Определяет, разрешены ли разрывы страниц между абзацами в диапазоне.
ITextPara::SetLineSpacing Задает правило междустрочного интервала абзаца и междустрочный интервал для абзаца.
ITextPara::SetListAlignment Задает выравнивание маркированного или нумерованного текста, используемого для абзацев.
ITextPara::SetListLevelIndex Задает индекс уровня списка, используемый для абзацев.
ITextPara::SetListStart Задает начальное число или значение Юникода для нумерованного списка.
ITextPara::SetListTab Задает параметр вкладки списка, который представляет собой расстояние между первым отступом и началом текста в первой строке.
ITextPara::SetListType Задает тип списка, используемого для абзацев.
ITextPara::SetNoLineNumber Определяет, следует ли подавлять нумерацию строк абзацев в диапазоне.
ITextPara::SetPageBreakBefore Определяет, есть ли разрыв страницы перед каждым абзацем в диапазоне.
ITextPara::SetRightIndent Задает правое поле абзаца.
ITextPara::SetSpaceAfter Задает размер пробела после абзаца.
ITextPara::SetSpaceBefore Задает размер пробела перед абзацем.
ITextPara::SetStyle Задает стиль абзаца для абзацев в диапазоне.
ITextPara::SetWidowControl Контролирует подавление вдов и сирот.

Комментарии

Интерфейсы ITextFont и ITextPara инкапсулируют функциональные возможности диалоговых окон Формат шрифта и абзаца Microsoft Word соответственно. Оба интерфейса содержат свойство duplicate (Value), которое может возвращать дубликаты атрибутов в объекте диапазона или передавать набор атрибутов в диапазон. Таким образом, они действуют как программируемые художники формата. Например, можно перенести все атрибуты из диапазона 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 .

Интерфейс ITextPara инкапсулирует диалоговое окно Word Абзац. Все измерения задаются в точках с плавающей запятой. Элемент управления с расширенным редактированием может принимать и возвращать все свойства ITextPara без изменений (т. е. без изменений) как с помощью TOM, так и с помощью преобразователей форматов RTF. Однако следующие свойства не влияют на то, что отображает элемент управления:

• DoNotHyphen
• KeepTogether
• KeepWithNext
• LineSpacing
• LineSpacingRule
• NoLineNumber
• PageBreakBefore
• Выравнивание табуляции
• Стили вкладок (кроме tomAlignLeft и tomSpaces)
• Style WidowControl

Требования

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

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

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

IDispatch

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

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