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

Применяет указанный шаблон стиля к выделенному тексту или абзацам.

function ApplyStyleTemplate(TemplateNo: Integer;

  Recursive: Boolean=True): Boolean;

Этот метод назначает указанный шаблон стиля стилям выделенного текста или стилям выделенных абзацев. Результат зависит от значения свойства Kind шаблона стиля и от того, что выделено в документе.

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

Параметры:

TemplateNo – номер в коллекции Style.StyleTemplates или значение -1. Значение -1 означает очистку форматирования (см. ниже).

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

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

Метод работает по следующим правилам:

▪если свойство Kind указанного шаблона стиля равно rvstkText, шаблон применяется к выделенному тексту;

▪если Kind указанного шаблона стиля равно rvstkPara, шаблон применяется к выделенным абзацам; единственное исключение – шаблон стиля «Normal»;

▪если TemplateNo = -1, либо Kind указанного шаблона стиля равно rvstkParaText, либо используется шаблон стиля «Normal», результат зависит от выделения. Если ничего не выделено, выделен весь абзац или выделение охватывает несколько абзацев/ячеек, шаблон применяется к выделенным абзацам. В противном случае он применяется к выделенному тексту.

Метод сбрасывает дополнительное форматирование, аналогично вызову ApplyTextStyleTemplate или ApplyParaStyleTemplate с параметром ResetAdditionalFormatting = True.

Метод пропускает стили абзацев, имеющие флаг rvpaoStyleProtect в свойстве Options, а также стили текста, имеющие флаг rvprStyleProtect в свойстве Protection.

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

Метод очищает форматирование текста и абзаца в двух случаях:

▪если он вызван с параметром TemplateNo = -1;

▪если применяется шаблон стиля «Normal».

Результат очистки форматирования описан в разделах, посвящённых методам ApplyTextStyleTemplate и ApplyParaStyleTemplate.

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

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

См. также:

▪ChangeStyleTemplates.