Control.AllowDrop 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取或设置一个值，该值指示控件是否可以接受用户拖放到它上面的数据。

C#

public virtual bool AllowDrop { get; set; }

属性值

Boolean

如果控件允许拖放操作，则为 true；否则为 false。 默认值为 false。

示例

下面的代码示例使用户能够将图像或图像文件拖到窗体上，并在删除时将其显示。 OnPaint将重写 方法以在每次绘制窗体时重新绘制图像;否则，图像将仅保留到下一次重新绘制。 事件 DragEnter 处理方法确定要拖动到窗体中的数据类型，并提供适当的反馈。 如果可以从数据创建 ，Image则DragDrop事件处理方法会在窗体上显示图像。 DragEventArgs.X由于 和 DragEventArgs.Y 值是屏幕坐标，因此该示例使用 PointToClient 方法将它们转换为客户端坐标。

C#

private Image picture;
private Point pictureLocation;

public Form1()
{
   // Enable drag-and-drop operations and 
   // add handlers for DragEnter and DragDrop.
   this.AllowDrop = true;
   this.DragDrop += new DragEventHandler(this.Form1_DragDrop);
   this.DragEnter += new DragEventHandler(this.Form1_DragEnter);
}

protected override void OnPaint(PaintEventArgs e)
{
   // If there is an image and it has a location, 
   // paint it when the Form is repainted.
   base.OnPaint(e);
   if(this.picture != null && this.pictureLocation != Point.Empty)
   {
      e.Graphics.DrawImage(this.picture, this.pictureLocation);
   }
}

private void Form1_DragDrop(object sender, DragEventArgs e)
{
   // Handle FileDrop data.
   if(e.Data.GetDataPresent(DataFormats.FileDrop) )
   {
      // Assign the file names to a string array, in 
      // case the user has selected multiple files.
      string[] files = (string[])e.Data.GetData(DataFormats.FileDrop);
      try
      {
         // Assign the first image to the picture variable.
         this.picture = Image.FromFile(files[0]);
         // Set the picture location equal to the drop point.
         this.pictureLocation = this.PointToClient(new Point(e.X, e.Y) );
      }
      catch(Exception ex)
      {
         MessageBox.Show(ex.Message);
         return;
      }
   }

   // Handle Bitmap data.
   if(e.Data.GetDataPresent(DataFormats.Bitmap) )
   {
      try
      {
         // Create an Image and assign it to the picture variable.
         this.picture = (Image)e.Data.GetData(DataFormats.Bitmap);
         // Set the picture location equal to the drop point.
         this.pictureLocation = this.PointToClient(new Point(e.X, e.Y) );
      }
      catch(Exception ex)
      {
         MessageBox.Show(ex.Message);
         return;
      }
   }
   // Force the form to be redrawn with the image.
   this.Invalidate();
}

private void Form1_DragEnter(object sender, DragEventArgs e)
{
   // If the data is a file or a bitmap, display the copy cursor.
   if (e.Data.GetDataPresent(DataFormats.Bitmap) || 
      e.Data.GetDataPresent(DataFormats.FileDrop) ) 
   {
      e.Effect = DragDropEffects.Copy;
   }
   else
   {
      e.Effect = DragDropEffects.None;
   }
}

继承者说明

重写派生类中的 AllowDrop 属性时，请使用基类的 AllowDrop 属性来扩展基实现。 否则，必须提供所有实现。 无需同时替代 get 属性的 AllowDrop 和 set 访问器;如果需要，只能重写一个。

适用于

另请参阅

• DragEventArgs
• DragOver
• DragDrop
• DragEnter
• DragLeave
• DoDragDrop(Object, DragDropEffects)