|
<< Нажмите, чтобы показать Содержание >> 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, если он произвёл изменения в документе.
Тип метода:
редактирование документа
См. также: