События деревьев

Ниже приведен список событий, поддерживаемых деревьями.

Событие AfterLabelEdit() происходит после завершения редактирования надписи узла, С помощью этого события можно проверить имя узла и убедиться в его правильности. Второе событие, BeforeLabelEdit(), происходит непосредственно перед началом редактирования.

Событие CollapseO происходит при свертывании ветви дерева. Для этого пользователь может дважды щелкнуть на ее корне или щелкнуть на знаке «минус» рядом с корнем ветви. Например, в процедуре этого события можно удалить свернутые объекты из дерева с целью экономии памяти.

Событие Expand() — полная противоположность Collapse(). Оно происходит в тот момент, когда пользователь развертывает ветвь дерева двойным щелчком на ее корне или щелчком на знаке «плюс» рядом с корнем. В процедуре этого события можно динамически загрузить данные в элемент для их отображения в развернутой ветви.

Событие NodeClick() — одно из важнейших событий для дерева. Оно позволяет получить информацию об узле, на котором был сделан щелчок, или выполнить любые другие функции, специфические для вашего приложения. Например, следующий фрагмент:

Private Sub tvwNodes_NodeClick(ByVal Noe As ComctlLib.Node)

MsgBox Node.FullPath

End Sub

отображает диалоговое окно с полным путем к узлу, на котором был сделан щелчок. Если в свойстве PathSeparator был задан символ \, корневой каталог — С:, а щелчок был сделан на узле Windows, то в диалоговом окне будет выведен путь С: \Windows. Событие OLECompleteDrag происходит, когда данные OLE сбрасываются на элемент или операция перетаскивания OLE отменяется.

Событие OLEDragDrop() происходит, когда на элемент сбрасываются данные OLE при свойстве OLEDropMode, установленном в 1 - Manual. Процедура события определяет, как приложение будет обрабатывать сброшенные данные. Вы можете включить в нее код, при котором элемент будет перемещать данные вместо копирования или наоборот — копировать данные вместо их перемещения. Все зависит от специфики вашего приложения.

Событие OLEDragOver происходит при протаскивании данных OLE над элементом. После того как это событие произошло, Visual Basic инициирует событие OLEGive Feed back, чтобы вы могли проверить данные и обеспечить необходимые операции обратной связи для пользователя.

Событие OLEGiveFeedback() происходит после каждого события OLEDragOver(). С его помощью элемент обеспечивает необходимую обратную связь, например изменяет вид указателя мыши и показывает, что произойдет при сбрасывании объекта. Возможны и другие варианты — например, в выделенном объекте (компонента-источника) организуются визуальные признаки, которые подсказывают, что произойдет в результате сбрасывания.

Событие OLESetData() происходит при вызове объектом-приемником метода GetData для объекта DataObject источника.

Наконец, событие OLEStartDrag() происходит, когда пользователь начинает перетаскивать данные из элемента. Если свойство OLEDragMode установлено в 1 - Automatic, элемент автоматически начинает перетаскивание. В процедуре этого события можно занести данные в объект DataObject элемента. В дальнейшем эти данные будут прочитаны элементом-приемником.