Control.DragDrop 事件
在完成拖放操作时发生。
**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）
语法
声明
Public Event DragDrop As DragEventHandler
用法
Dim instance As Control
Dim handler As DragEventHandler
AddHandler instance.DragDrop, handler
public event DragEventHandler DragDrop
public:
event DragEventHandler^ DragDrop {
void add (DragEventHandler^ value);
void remove (DragEventHandler^ value);
}
/** @event */
public void add_DragDrop (DragEventHandler value)
/** @event */
public void remove_DragDrop (DragEventHandler value)
JScript 支持使用事件，但不支持进行新的声明。
备注
DragEventArgs 的 X 和 Y 属性在屏幕坐标中，而不是在工作区坐标中。下面的 Visual C# 代码行将这些属性转换为工作区 Point。
Point clientPoint = targetControl.PointToClient(new Point(de.X, de.Y));
提示
在 Microsoft .NET Framework 2.0 版 的早期版本中，如果将具有 DragEnter 和 DragDrop 事件的 UserControl 放在 Windows 窗体上，并在设计时将某个对象拖放到 UserControl 上，则将引发 DropDrop 和 DropEnter 事件。但是，当您关闭再重新打开解决方案时，将不再引发 DragEnter 和 DragDrop 事件。
有关处理事件的更多信息，请参见 使用事件。
示例
下面的代码示例演示在两个 ListBox 控件之间的拖放操作。当拖动动作启动时，该示例调用 DoDragDrop 方法。在 MouseDown 事件期间，如果从鼠标位置起鼠标移动的距离大于 SystemInformation.DragSize，则启动拖动动作。IndexFromPoint 方法用于在 MouseDown 事件期间确定要拖动的项的索引。
该示例同时演示了对拖放操作使用自定义光标。该示例要求应用程序目录中存在两个光标文件：3dwarro.cur 和 3dwno.cur，分别用于自定义拖动光标和禁止停放光标。如果选中 UseCustomCursorsCheckCheckBox，则使用自定义光标。自定义光标在 GiveFeedback 事件处理程序中设置。
键盘状态在右 ListBox 的 DragOver 事件处理程序中计算，以确定基于 Shift、Ctrl、Alt 或 Ctrl+Alt 键的状态将发生哪种拖动操作。放置动作在 ListBox 中发生的位置也在 DragOver 事件期间确定。如果要放置的数据不是 String，则在 DragDropEffects 中将 DragEventArgs.Effect 设置为值 None。最后，停放状态在 DropLocationLabelLabel 中显示。
要放置的用于右 ListBox 的数据在 DragDrop 事件处理程序中确定，并且在 ListBox 中的适当位置添加该 String 值。如果拖动操作移动到窗体边框的外面，则 QueryContinueDrag 事件处理程序中将取消拖放操作。
这段代码摘录演示了 DragDrop 事件的用法。有关完整的代码实例，请参见 DoDragDrop 方法。
Private Sub ListDragTarget_DragDrop(ByVal sender As Object, ByVal e As DragEventArgs) Handles ListDragTarget.DragDrop
' Ensures that the list item index is contained in the data.
If (e.Data.GetDataPresent(GetType(System.String))) Then
Dim item As Object = CType(e.Data.GetData(GetType(System.String)), System.Object)
' Perform drag-and-drop, depending upon the effect.
If (e.Effect = DragDropEffects.Copy Or _
e.Effect = DragDropEffects.Move) Then
' Insert the item.
If (indexOfItemUnderMouseToDrop <> ListBox.NoMatches) Then
ListDragTarget.Items.Insert(indexOfItemUnderMouseToDrop, item)
Else
ListDragTarget.Items.Add(item)
End If
End If
' Reset the label text.
DropLocationLabel.Text = "None"
End If
End Sub
private void ListDragTarget_DragDrop(object sender, System.Windows.Forms.DragEventArgs e)
{
// Ensure that the list item index is contained in the data.
if (e.Data.GetDataPresent(typeof(System.String))) {
Object item = (object)e.Data.GetData(typeof(System.String));
// Perform drag-and-drop, depending upon the effect.
if (e.Effect == DragDropEffects.Copy ||
e.Effect == DragDropEffects.Move) {
// Insert the item.
if (indexOfItemUnderMouseToDrop != ListBox.NoMatches)
ListDragTarget.Items.Insert(indexOfItemUnderMouseToDrop, item);
else
ListDragTarget.Items.Add(item);
}
}
// Reset the label text.
DropLocationLabel.Text = "None";
}
void ListDragTarget_DragDrop( Object^ /*sender*/, System::Windows::Forms::DragEventArgs^ e )
{
// Ensure that the list item index is contained in the data.
if ( e->Data->GetDataPresent( System::String::typeid ) )
{
Object^ item = dynamic_cast<Object^>(e->Data->GetData( System::String::typeid ));
// Perform drag-and-drop, depending upon the effect.
if ( e->Effect == DragDropEffects::Copy || e->Effect == DragDropEffects::Move )
{
// Insert the item.
if ( indexOfItemUnderMouseToDrop != ListBox::NoMatches )
ListDragTarget->Items->Insert( indexOfItemUnderMouseToDrop, item );
else
ListDragTarget->Items->Add( item );
}
}
// Reset the label text.
DropLocationLabel->Text = "None";
}
private void listDragTarget_DragDrop(Object sender,
System.Windows.Forms.DragEventArgs e)
{
// Ensure that the list item index is contained in the data.
if (e.get_Data().GetDataPresent(String.class.ToType())) {
Object item = (Object)(e.get_Data().GetData(
String.class.ToType()));
// Perform drag-and-drop, depending upon the effect.
if (e.get_Effect().Equals(DragDropEffects.Copy) ||
e.get_Effect().Equals(DragDropEffects.Move)) {
// Insert the item.
if (indexOfItemUnderMouseToDrop != ListBox.NoMatches) {
listDragTarget.get_Items().Insert(
indexOfItemUnderMouseToDrop, item);
}
else {
listDragTarget.get_Items().Add(item);
}
}
}
// Reset the label text.
dropLocationLabel.set_Text("None");
} //listDragTarget_DragDrop
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0