ItemDragEventArgs::Item Property

 

Gets the item that is being dragged.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
property Object^ Item {
	Object^ get();
}

Property Value

Type: System::Object^

An object that represents the item being dragged.

You can use this property to determine which item from the TreeView or ListView controls is being dragged from the control.

The following example illustrates the use of ItemDragEventArgs when enabling drag-and-drop operations within a TreeView control. The Button property determines whether the dragged node should be moved or copied to its destination. The node, represented by the Item property, is then passed to the TreeView control's DoDragDrop method along with a value that indicates the desired effect of the drag-and-drop operation.

For the complete example, see the TreeView::ItemDrag reference topic.

private:
   void treeView1_ItemDrag( Object^ /*sender*/, ItemDragEventArgs^ e )
   {

      // Move the dragged node when the left mouse button is used.
      if ( e->Button == ::MouseButtons::Left )
      {
         DoDragDrop( e->Item, DragDropEffects::Move );
      }
      // Copy the dragged node when the right mouse button is used.
      else

      // Copy the dragged node when the right mouse button is used.
      if ( e->Button == ::MouseButtons::Right )
      {
         DoDragDrop( e->Item, DragDropEffects::Copy );
      }
   }

.NET Framework
Available since 1.1
Return to top
Show: