QG_SetDropSignatures

QG_SetDropSignatures(areaRef; dropSignatures):errorCode
areaRef Longint QGrid area reference
dropSignatures Array string Droppable signatures
error Longint Error result

Specifies the signatures that are allowed to be dropped on a 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 dropSignatures specifies the string signatures that the area accepts to be dropped on it. Any string up to 31 characters in length could serve as a drop signature.

These string signatures are matched against the drag signatures of the drag source area (the same applies for drag'n'drop inside the same 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).

If no match is found the user is not allowed to make a drop on this area. That condition is reflected by the lack of visual feedback when the mouse is moving over the area.

 

Notes:

Example

ARRAY STRING(31;$acceptedDropTypes;2)
 
$acceptedDropTypes{1}:="banana_drag"
$acceptedDropTypes{2}:="apple_drag"
 
$err:=QG_SetDropSignatures ($targetArea;$acceptedDropTypes)
If ($err # qg_noErr)
  ` Handle the error
End if

Related commands

QG_GetDropSignatures Returns the signatures that are allowed to be dropped on a grid area
QG_SetDragSignatures Configures a grid area to allow dragging
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:09