QGrid
![]() |
![]() ![]() |
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 |