TCustomRichViewEdit.ApplyTextStyleTemplate

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

TCustomRichViewEdit.ApplyTextStyleTemplate

Применяет указанный шаблон стиля к стилю текста выделенных элементов документа (текстовых элементов, табуляций, текстовых меток и к элементов, унаследованным от текстовых меток).

function ApplyTextStyleTemplate(TemplateNo: Integer; 

  ResetAdditionalFormatting: Boolean;

  Recursive: Boolean=True): Boolean;

Этот метод назначает указанный шаблон стиля стилям текста выделенных элементов документа.

При этом метод не меняет свойства элементов существующих стилей текста; метод меняет ссылки на стили текста у элементов так, чтобы они указывали на стили с нужными свойствами; при необходимости добавляются новые стили.

Параметры:

TemplateNo номер в коллекции Style.StyleTemplates -1. Значение -1 означает очистку форматирования (см. ниже). Шаблон стиля должен иметь Kind = rvstkParaText или rvstkText. Исключением является шаблон стиля «Normal»: его применение также очищает форматирование текста, но ResetAdditionalFormatting принимается во внимание.

ResetAdditionalFormatting если равно True, применяются все свойства указанного шаблона стиля. Если равно False, изменяются только «неизменённые» свойства (см. ниже). Этот параметр игнорируется, если TemplateNo = -1.

Если Recursive = False, метод не меняет содержимого ячеек выделенных таблиц (за исключением случая выделения нескольких ячеек в одной таблице).

Если UseStyleTemplates = False и TemplateNo >= 0, метод не выполняет никаких действий.

Метод пропускает элементы, использующие текстовые стили, в свойстве Protection которых установлена опция rvprStyleProtect.

Очистка форматирования

Очистка форматирования означает сброс всех атрибутов текста к значениям по умолчанию. Если назначен шаблон стиля абзаца (ParaStyleTemplateId), то значения по умолчанию определяет он.

Для гиперссылок (то есть текстовых стилей с Jump = True) выполняется специальная обработка: если существует шаблон стиля «Hyperlink», он применяется. Иными словами, метод работает так же, как применение этого шаблона с параметром ResetAdditionalFormatting = True.

Если UseStyleTemplates = False и TemplateNo < 0, результат будет таким же, как при вызове ApplyTextStyle(0).

Изменённые свойства

Свойства текстового стиля считаются изменёнными, если их значения отличаются от значений соответствующих свойств шаблонов стиля, на которые ссылаются свойства StyleTemplateId и ParaStyleTemplateId. Если ни один из этих шаблонов стиля не назначен, свойства считаются изменёнными, если их значения отличаются от значений по умолчанию.

Свойство ModifiedProperties методом не используется — он самостоятельно определяет, какие свойства являются изменёнными.

 

Метод возвращает True, если он произвёл изменения в документе.

Тип метода: editstyle редактирование документа

См. также:

ApplyParaStyleTemplate;

ApplyStyleConversion;

ApplyTextStyle.