QG_SetDragSignatures

QG_SetDragSignatures(areaRef; dragSignatures):errorCode
areaRef Longint QGrid area reference
dragSignatures Array string Drag signatures
error Longint Error result

Specifies the signatures that are emitted when the user starts a drag from the grid area.

Parameter areaRef is the QGrid area reference. If areaRef is not a valid QGrid area reference, qg_paramErr error is returned.

Array parameter dragSignatures specifies the string signatures that will be emitted from the grid area during a drag. Any string up to 31 characters in length could serve as a drag signature.

These string signatures are matched against the drop signatures of the target grid area (the same applies for dragging inside the source grid area). At least one drag and one drop signature must match to allow dragging and dropping between the two grids (and even inside the same grid).

 

Notes:

Example

ARRAY STRING(31;$emittedDragTypes;3)
 
$emittedDragTypes{1}:="tomato_drag"
$emittedDragTypes{2}:="potato_drag"
$emittedDragTypes{3}:="banana_drag"
 
$err:=QG_SetDragSignatures ($sourceArea;$emittedDragTypes)
If ($err # qg_noErr)
  ` Handle the error
End if
 

Related commands

QG_GetDragSignatures Returns the signatures that are allowed to be dragged from a grid area
QG_SetDropSignatures Configures a grid area to allow dropping
QG_SetEventHandler Installs an event handler method for a QGrid area

QGrid © Escape
Generated by QDoc 2.8 on Thu, Oct 8, 2009 17:36:06