<< Нажмите, чтобы показать Содержание >> TCustomRichViewEdit.OnOleDrop [VCL and LCL]

Событие перетаскивания OLE (drag&drop). Происходит, когда пользователь завершает перетаскивание данных в редактор. Позволяет вставить данные в нестандартном формате.

type

  TRVOleDropEvent = procedure (Sender: TCustomRichView;

    const DataObject: IDataObject; Shift: TShiftState; X, Y: Integer;

    PossibleDropEffects: TRVOleDropEffects;

    var DropEffect: TRVOleDropEffect; var DoDefault: Boolean) of object;

property OnOleDrop: TRVOleDropEvent;

Это низкоуровневое событие. Не используйте его, если вы не знакомы с OLE drag&drop.

Первоначально будет вызвано событие OnOleDragEnter, оно происходит когда пользователь перемещает указатель мыши в редактор во время перетаскивания. После этого, событие OnOleDragOver вызывается, когда пользователь перемещает указатель мыши в пределах окна редактора. Перетаскивание завершится либо вызовом данного события (успешно), либо вызовом OnOleDragLeave (операция отменена или указатель мыши покинул редактор).

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

DataObject – перетаскиваемые данные (IDataObject определён в модуле ActiveX).

Shift – состояние клавиатуры.

PossibleDropEffects – список возможных операций, множество из rvdeCopy, rvdeMove, rvdeLink (копировать, переместить, копировать как ссылку).

DropEffect – операция, которую бы выбрал редактор.

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

DropEffect – операция, которую вы совершили с перетаскиваемыми данными (одна из PossibleDropEffects, или rvdeNone если вы не хотите принимать эти данные). Если вы указали rvdeMove, это вызовет удаление данных из их исходного положения. Значение этого параметра используется только в том случае, если вы присвоили DoDefault = False; в противном случае редактор выполняет стандартную обработку. Если в обработчике этого события вы вставили какие-либо данные в редактор, после завершения события они автоматически выделяются.

Ограничение: при перетаскивании данных из того же редактора он сам решает, следует переместить или скопировать данные, и игнорирует значение DropEffect.

 

Это событие вызывается между событий OnBeforeOleDrop и OnAfterOleDrop.

 

См. также события:

▪OnOleDragEnter;

▪OnOleDragOver;

▪OnOleDragLeave;

▪OnDropFiles.

См. также:

▪Перетаскивание данных;

▪Как сделать однострочный редактор простого текста.