OnDragStart

OnDragStart

Udalosť OnDragStart


Deklarácia

ENTRY OnDragStart(IN INT _refId) ; akcie END OnDragStart

Parametre

_refId

Referenčná premenná zdrojového grafického objektu.

Popis

Udalosť je generovaná v prípade, keď užívateľ stlačí ľavé tlačidlo myši a začne ťahať zvolený objekt. V rámci obsluhy tejto udalosti, je nutné sa na základe označeného obsahu rozhodnúť, či sa bude operácia Drag vykonávať alebo nie. V prípade vykonávania je nutné najskôr pripraviť dáta, ktoré sa budú prenášať.
Pomocou funkcií:
- %HI_GetBrowserMultiselect
- %HI_GetSelectedItem
- %HI_GetItemText

je možné zistiť aktuálne označené prvky v jednotlivých grafických objektoch, pomocou ktorých je možné sa rozhodnúť, či sa bude operácia Drag vykonávať.
Ak áno, je nutné pripraviť potrebné dáta pomocou funkcií:
- %SetDragDataText
- %SetDragDataFileList
- %SetDragDataIPS

a následne zavolať funkciu %HI_DoDragDrop.

V prípade, že v obsluhe tejto udalosti nebude táto funkcia zavolaná, operácia Drag sa nevykoná.

Príklad

ENTRY OnDragStart (IN INT _refID) ; vytvorenie dát pre D&D, napr. len text %SetDragDataText (0, "Textová hodnota") ; zahájenie Drag&Drop %HI_DoDragDrop ( _refId) END OnDragStart

Súvisiace stránky:

Obsluha udalosti
Udalosti