<< Нажмите, чтобы показать Содержание >> TRVStyleTemplate Свойства   Методы

Шаблон стиля текста и абзаца.  Фактически, этот класс представляет собой настоящий именованный стиль, подобный стилям текстовых процессоров, таких как MS Word. Этот класс не влияет на отображение текста и абзацев напрямую, но он управляет изменениями свойств объектов TFontInfo и TParaInfo.

Это класс элементов в коллекции TRVStyle.StyleTemplates. Класс самой коллекции – TRVStyleTemplateCollection.

Модуль [VCL/FMX] RVStyle / fmxRVStyle.

Синтаксис

TRVStyleTemplate = class(TCollectionItem)

Иерархия

TObject

TPersistent

TCollectionItem

Основные свойства

▪Kind – тип шаблона стиля (задаёт его применимость к абзацам и к тексту);

▪Name – уникальное имя;

▪Id – уникальный идентификатор;

▪TextStyle, ValidTextProperties – свойства текста;

▪ParaStyle, ValidParaProperties – свойства абзаца;

▪ParentId – ссылка на родительский шаблон стиля;

▪NextId – ссылка на шаблон стиля для следующих абзацев;

▪QuickAccess указывает желательность наличия быстрого доступа к этому шаблону стиля в интерфейсе пользователя приложения.

В каждом конкретном шаблоне определены только свойства текста и абзаца, перечисленные в ValidTextProperties и ValidParaProperties. Если у шаблона стиля есть родительский (ParentId), остальные свойства берутся у родителя (далее родителя родителя, и дальше по цепочке, пока не дойдёт до шаблона стиля без родителя).

Если шаблон стиля применён к абзацу, оставшиеся свойства имеют значения по умолчанию.

Если шаблон стиля применён к тексту, оставшиеся свойства берутся у шаблона стиля, применённого к абзацу. Если такого нет, они имеют значения по умолчанию.

Основные методы

▪UpdateModifiedTextStyleProperties заполняет список свойств стиля текста, значения которых были изменены после применения к нему шаблона(ов) стиля;

▪UpdateModifiedParaStyleProperties заполняет список свойств стиля абзаца, значения которых были изменены после применения к нему шаблона стиля;

▪ApplyToTextStyle применяет шаблон(ы) стиля к стилю текста;

▪ApplyToParaStyle применяет шаблон стиля к стилю абзаца.

Связи

Каждый шаблон стиля имеет два свойства с уникальными значениями: Id и Name.

Id доступно только для чтения, назначается автоматически, и коллекция обеспечивает его уникальность.

Name назначается пользователем, и вы как программист должны обеспечить уникальность этого имени.

Связи из TextStyles, ParaStyles, а также между элементами StyleTemplates выполняются через свойство Id.

Name используется при объединении шаблонов стилей из двух разных документов.

В отличие от элементов TRVStyle.TextStyles и TRVStyle.ParaStyles, на шаблоны стилей никогда не ссылаются по их номеру в коллекции, за исключением номеров элементов, возвращаемых при поиске по имени или идентификатору, а также методов редактора, применяющих стиль к выделенному фрагменту.

См. также

▪Стили и шаблоны стилей.