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

Происходит при чтении компонентов из файла или потока RVF, если компоненты были сохранены без их содержимого.

type

  TRVFControlNeededEvent =

    procedure(Sender: TCustomRichView; Name: TRVUnicodeString;

      const Tag: TRVTag; var ctrl: TControl) of object;

 

property OnRVFControlNeeded: TRVFControlNeededEvent;

По умолчанию значения всех опубликованных (published) свойств компонентов сохраняются в документах RVF.

Если исключить rvfoSaveControlsBody из RVFOptions, свойства компонента не будут сохранены. Будут сохранены только имя элемента (значение, возвращаемое GetItemText) и тег (значение, возвращаемое GetItemTag). Эти значения позволяют идентифицировать компонент при загрузке. При чтении таких RVF-файлов для каждого компонента вызывается OnRVFControlNeeded.

Входные параметры:

Name – имя элемента документа (это значение, возвращаемое GetItemTextW; не следует путать со свойством Name компонента, см. типы элементов документа).

Tag – тег элемента документа (это значение, возвращаемое GetItemTag; не следует путать со свойством Tag компонента, см теги элементов документа).

Выходной параметр:

ctrl – компонент для вставки в документ. Создайте этот компонент в обработчике события. Не освобождайте память под него (TRichView освободит её, когда будет нужно).

 

См. также:

▪Обзор RVF, содержит пример.