TdxCustomTileControl.OnGroupDragOver Event

Enables you to prevent end-users from dropping a dragged tile group at a specific position within the control.

Declaration

property OnGroupDragOver: TdxTileControlGroupDragOverEvent read; write;

Remarks

This event occurs when dropping the dragged tile group anywhere within the control. You can assign False to the AAccept parameter within the OnGroupDragOver event handler to forbid an end-user to place a group at the currently highlighted drop position:

The dropped group automatically returns to its initial position if you made the current drop position unavailable within the event handler. For instance, you can forbid end-users to place a dragged group between the first and second groups within the control:

Delphi

procedure TMyForm.dxTileControl1GroupDragOver(Sender: TdxCustomTileControl; AInfo: TdxTileControlDragGroupInfo; var AAccept: Boolean);
begin
  if AInfo.CurrentIndex = 1 then  // If the current group drop position is the second from the start...
    AAccept := False;  // Forbids an end-user to drop a group here
end;

C++

void __fastcall TMyForm::dxTileControl1GroupDragOver(TdxCustomTileControl *Sender, TdxTileControlDragGroupInfo *AInfo, bool &AAccept)
{
  if(AInfo->CurrentIndex == 1) {  // If the current group drop position is the second from the start...
    AAccept = False;  // Forbids an end-user to drop a group here
  }
}

Refer to the TdxTileControlGroupDragOverEvent procedural type description for detailed information on all parameters accessible within an OnGroupDragOver event handler.