Skip to content

XTPTaskPanelItemAllowDrag Enumeration

Description

XTPTaskPanelItemAllowDrag is an enumeration that represents a set of drag options used to specify how and when an item can be dragged and dropped.

Members

Member Description
xtpTaskItemAllowDragNone Disable dragging. Specifies that the item or group cannot be dragged.
xtpTaskItemAllowDragDefault Default drag options. Please see Note 1 in the Remarks section.
xtpTaskItemAllowDragCopyWithinGroup Allows the item to only be copied within the group it belongs to. The item cannot be copied outside of the group or TaskPanel control.
xtpTaskItemAllowDragCopyWithinControl Allows the item to only be copied within any group in the Task Panel control. The item cannot be copied outside of the Task Panel control.
xtpTaskItemAllowDragCopyOutsideControl Allows the item to only be copied outside the Task Panel control. The item cannot be copied to any group inside the Task Panel control.
xtpTaskItemAllowDragCopy Note 2 in the Remarks section. This is the combination of xtpTaskItemAllowDragCopyWithinControl and xtpTaskItemAllowDragCopyOutsideControl.
xtpTaskItemAllowDragMoveWithinGroup Allows the item to only be moved within the group it belongs to. The item cannot be moved outside of the group or TaskPanel control.
xtpTaskItemAllowDragMoveWithinControl Allows the item to only be moved within any group in the Task Panel control. The item cannot be moved outside of the Task Panel control.
xtpTaskItemAllowDragMoveOutsideControl Allows the item to only be moved outside the Task Panel control. The item cannot be moved to any group inside the Task Panel control.
xtpTaskItemAllowDragMove Note 3 in the Remarks section. This is the combination of xtpTaskItemAllowDragMoveOutsideControl and xtpTaskItemAllowDragMoveWithinControl.
xtpTaskItemAllowDragWithinGroup Note 5 in the Remarks section. This is the combination of xtpTaskItemAllowDragCopyWithinGroup and xtpTaskItemAllowDragMoveWithinGroup.
xtpTaskItemAllowDragWithinControl Note 6 in the Remarks section. This is the combination of xtpTaskItemAllowDragCopyWithinControl and xtpTaskItemAllowDragMoveWithinControl.
xtpTaskItemAllowDrag Note 7 in the Remarks section. This is the combination of xtpTaskItemAllowDragCopyWithinControl, xtpTaskItemAllowDragCopyOutsideControl, xtpTaskItemAllowDragMoveWithinControl, and xtpTaskItemAllowDragMoveOutsideControl.

Remarks

The flags of the XTPTaskPanelItemAllowDrag enumeration are used to specify the drag options of the TaskPanel, TaskPanelGroup, and TaskPanelGroupItem objects. The AllowDrag property of each object is used to store the XTPTaskPanelItemAllowDrag flags. The XTPTaskPanelItemAllowDrag specifies both how and where the item can be dragged and dropped. The AllowDrop property can be used to further restrict where an item can be dropped; see Note 4.

Notes

  1. The xtpTaskItemAllowDragDefault flag has a different meaning depending on what type of item is using it. If TaskPanelGroupItem.AllowDrag = xtpTaskItemAllowDragDefault, then the item will use the AllowDrag settings from the group that it belongs to. If TaskPanelGroup.AllowDrag = xtpTaskItemAllowDragDefault, then the group will use the AllowDrop settings from the TaskPanel control. If TaskPanel.AllowDrag = xtpTaskItemAllowDragDefault, then xtpTaskItemAllowDrag is used.

  2. The xtpTaskItemAllowDragCopy flag specifies that a TaskPanelGroupItem will be copied or "duplicated" when dragged and dropped. This means the original item will not be moved, and a new "duplicate" item will be created in the spot the item is dropped. This option allows items to be copied within any of the TaskPanel groups or outside of the TaskPanel control. This option only applies to TaskPanelGroupItem objects and is not used with TaskPanel Group objects.

  3. The xtpTaskItemAllowDragMove flag specifies that a TaskPanelGroupItem will be moved when dragged and dropped. This means the original item will be removed from its original position and inserted into the spot the item is dropped. This option allows items to be moved within any of the TaskPanel groups or outside of the TaskPanel control. This option only applies to TaskPanelGroupItem objects and is not used with TaskPanel Group objects.

  4. The AllowDrop property can be used to further restrict where an item can be dropped. The TaskPanelGroupItem.AllowDrop property specifies whether another item can be "dropped" before the item. The TaskPanelGroup.AllowDrag property specifies whether items can be "dropped" into the group.

  5. During "normal" dragging and dropping of items, the item will be moved to the position it is dropped within the same group. If the Control (Ctrl) key is held down during the dragging and dropping of the item, then it will be copied. The xtpTaskItemAllowDragWithinGroup flag behaves exactly as the xtpTaskItemAllowDragMoveWithinGroup flag during "normal" dragging and dropping of items. If the Control (Ctrl) key is held down during the dragging and dropping of the item, then it will behave like the xtpTaskItemAllowDragCopyWithinGroup flag.

  6. During "normal" dragging and dropping of items, the item will be moved to the position it is dropped within any group in the TaskPanel control. If the Control (Ctrl) key is held down during the dragging and dropping of the item, then it will be copied. The xtpTaskItemAllowDragWithinControl flag behaves exactly as the xtpTaskItemAllowDragMoveWithinControl flag during "normal" dragging and dropping of items. If the Control (Ctrl) key is held down during the dragging and dropping of the item, then it will behave like the xtpTaskItemAllowDragCopyWithinControl flag.

  7. During "normal" dragging and dropping of items, the item will be moved anywhere inside or outside of the TaskPanel control. If the Control (Ctrl) key is held down during the dragging and dropping of the item, then the item will be copied instead of moved.

  8. The DrawText property can be set for each TaskPanelGroupItem. This is the text string that is sent to the Target Component when an item is dropped onto a control outside of the TaskPanel.

See Also

Copyright (c) 1998-2024 Codejock Technologies. All rights reserved.