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.