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

Методы компонента TRichView

TRichView имеет 3 группы методов для изменения документа:

1.добавление элементов в конец документа (возможно, из файла или потока);

2.изменение элемента документа с указанным номером;

3.загрузка из файла или потока.

Примеры методов первой группы: AddNL, AddPicture, LoadRTF.

Примеры методов второй группы SetPictureInfo, SetItemText.

Примеры методов третьей группы: LoadRVF, LoadRTFFromStream.

Все эти методы обладают следующими характеристиками:

▪они не требуют, чтобы документ был отформатирован (форматирование – это подготовка документа к показу).

▪даже если документ был отформатирован до вызова такого метода, он становится неотформатированным после.

Вам нужно вызвать метод Format (или FormatTail), чтобы показать документ, который был создан или изменён таким образом.

Ячейки таблицы имеют такие же методы.

Эти методы не приостанавливают поток проверки орфографии (кроме методов группы 3), и это может привести к ошибкам. Перед вызовом этих методов убедитесь, что проверка орфографии не запущена (вызвав методы Clear или ClearLiveSpellingResults).

Методы компонента TRichViewEdit

TRichViewEdit имеет следующие группы методов для изменения документа:

1.все методы TRichView;

2.методы вставки элементов в позицию каретки
(методы Insert***, такие как InsertText, InsertPicture);

3.методы изменения свойств элемента в позиции каретки
(методы SetCurrent***, такие как SetCurrentPictureInfo, SetCurrentItemText);

4.расширенный набор методов изменения свойств элемента с указанным номером
(методы Set***Ed, такие как SetPictureInfoEd, SetItemTextEd).

Методы первой группы называются в справке методами быстрого изменения документа, методы групп 2-4 называются методами редактирования документов.

Все эти методы (кроме методы группы 1, унаследованные от TRichView) обладают следующими характеристиками:

▪документ должен быть отформатирован перед их вызовом;

▪методы автоматически форматируют изменённую часть документа;

▪если документ находится в режиме только для чтения, они не делают ничего; также они учитывают защиту текста и абзацев;

▪они вызывают событие OnChange;

▪они могут быть вызваны во время работы фоновой проверки орфографии;

▪изменения могут быть отменены и возвращены.

Основное применение методов группы 1 в редакторе – генерация новых документов с нуля (после вызова Clear).

Основное применение других методов – выполнение команд пользователя. Их не следует использовать для генерации новых документов (поскольку каждый такой метод обновляет документ, может вызывать нежелательное мерцание и работает значительно медленнее).

Важно: Не следует вызывать методы группы 1 и методы групп 2-4 вперемешку! Методы, унаследованные от TRichView, не обновляют буферы отмены и возврата, и результаты команд отмены и возврата операций будут непредсказуемыми!

Единственное применение методов группы 1 – это генерация нового документа в следующей последовательности:

1.Clear; (этот метод также очищает буферы отмены и возврата операций);

2.Вызов одного или нескольких методов группы 1;

3.Format (после того, как документ отформатирован, можно вызывать методы групп 2-4)

См. также: Отмена операций над таблицами.