Control.AllowDrop Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает значение, указывающее, может ли элемент управления принимать данные, перетаскиваемые в него пользователем.

C#

public virtual bool AllowDrop { get; set; }

Значение свойства

Boolean

true, если операции перетаскивания поддерживаются элементом управления; в противном случае — false. Значение по умолчанию — false.

Примеры

В следующем примере кода пользователь может перетащить изображение или файл изображения в форму и отобразить его в точке удаления. Метод OnPaint переопределяется для перерисовки изображения при каждом закрашивание формы; в противном случае изображение будет сохраняться только до следующей перерисовки. Метод DragEnter обработки событий определяет тип данных, перетаскиваемых в форму, и предоставляет соответствующую обратную связь. Метод DragDrop обработки событий отображает изображение в форме, если Image можно создать на основе данных. 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)