Expand Minimize

ListViewBase.CanDragItems property

Applies to Windows and Windows Phone

Gets or sets a value that indicates whether items in the view can be dragged as data payload.

Syntax


public:
property bool CanDragItems { 
   bool get();
   void set (bool value);
}


<listViewBase CanDragItems="bool" />

Property value

Type: System.Boolean [.NET] | Platform::Boolean [C++]

True if items in the view can be dragged as data payload; otherwise, false. The default is false.

Remarks

Setting IsSwipeEnabled to false disables some default touch interactions, so it should be set to true when these interactions are needed. For example:

  • If item selection is enabled and you set IsSwipeEnabled to false, a user can deselect items by right-clicking with the mouse, but can't deselect an item with touch by using a swipe gesture.
  • If you set CanDragItems to true and IsSwipeEnabled to false, a user can drag items with the mouse, but not with touch.
  • If you set CanReorderItems to true and IsSwipeEnabled to false, a user can reorder items with the mouse, but not with touch.

CanDragItems can be set to false as part of visual states that are intended to prevent users from dragging items in views such as a GridView.

CanDragItems does not reflect transient states that might influence the ability to drag items, such as item population lag. The primary scenario where you might get the value of CanDragItems in code is to verify that dynamic templates or user-selectable options in your app UI have not changed the value since you last set it.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]

Namespace

Windows.UI.Xaml.Controls
Windows::UI::Xaml::Controls [C++]

Metadata

Windows.winmd

See also

ListViewBase
AllowDrop
CanReorderItems

 

 

Show:
© 2014 Microsoft