|
<< Нажмите, чтобы показать Содержание >> TCustomRichViewEdit.ApplyParaStyleTemplate |
Применяет указанный шаблон стиля к выделенным абзацам.
function ApplyParaStyleTemplate(TemplateNo: Integer;
ResetAdditionalFormatting: Boolean;
Recursive: Boolean=True): Boolean;
Этот метод назначает указанный шаблон стиля стилям выделенных абзацев (при этом метод не меняет свойства элементов существующих стилей абзаца; метод меняет ссылки на стили абзацев у элементов так, чтобы они указывали на стили с нужными свойствами; при необходимости добавляются новые стили).
Параметры:
TemplateNo – номер в коллекции Style.StyleTemplates или значение -1. Значение -1 означает очистку форматирования (см. ниже). Шаблон стиля должен иметь значение Kind = rvstkParaText или rvstkPara.
ResetAdditionalFormatting – если равно True, применяются все свойства указанного шаблона стиля. Если равно False, изменяются только «неизменённые» свойства (см. ниже). Этот параметр игнорируется, если TemplateNo = -1.
Если Recursive = False, метод не меняет содержимого ячеек выделенных таблиц (за исключением случая выделения нескольких ячеек в одной таблице).
Если UseStyleTemplates = False и TemplateNo >= 0, метод не выполняет никаких действий.
Метод пропускает абзацы, использующие стили, в свойстве Options которых установлена опция rvpaoStyleProtect.
Метод возвращает True, если он произвёл изменения в документе.
Очистка форматирования
Очистка форматирования выполняется следующим образом.
Если существует шаблон стиля «Normal», метод работает так же, как применение этого шаблона с параметром ResetAdditionalFormatting = True.
Если шаблон «Normal» отсутствует, метод сбрасывает все свойства стилей абзацев к значениям по умолчанию и устанавливает StyleTemplateId = -1.
Если UseStyleTemplates = False и TemplateNo < 0, результат будет таким же, как при вызове ApplyParaStyle(0).
Изменённые свойства
Свойства стиля абзаца считаются изменёнными, если их значения отличаются от значений соответствующих свойств текущего шаблона стиля, на который ссылается свойство StyleTemplateId.
Если шаблон стиля не назначен, свойство считается изменённым, если его значение отличается от значения по умолчанию.
Свойство ModifiedProperties методом не используется – он самостоятельно определяет, какие свойства являются изменёнными.
Тип метода:
редактирование документа
См. также: