Skip to main content
.NET Framework Class Library
ToolStrip..::.BeginDrag Event

Occurs when the user begins to drag the ToolStrip control.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Syntax
Public Event BeginDrag As EventHandler
public event EventHandler BeginDrag
public:
 event EventHandler^ BeginDrag {
	void add (EventHandler^ value);
	void remove (EventHandler^ value);
}
member BeginDrag : IEvent<EventHandler,
    EventArgs>
Remarks

For more information about handling events, see Consuming Events.

Examples

The following code example demonstrates the use of BeginDrag and EndDrag with a ToolStrip and a ToolStripContainer.


Imports System
Imports System.Windows.Forms



Public Class Form1
   Inherits Form
   Private toolStripContainer1 As ToolStripContainer
   Private toolStrip1 As ToolStrip
   Private richTextBox1 As RichTextBox


   Public Sub New()
      DragToolStrip()
   End Sub

   <STAThread()>  _
   Shared Sub Main()
      Application.EnableVisualStyles()
      Application.Run(New Form1())
   End Sub


   Private Sub DragToolStrip()
      ' Create a ToolStripContainer.
      toolStripContainer1 = New System.Windows.Forms.ToolStripContainer()
      toolStripContainer1.Dock = System.Windows.Forms.DockStyle.Fill
      Controls.Add(toolStripContainer1)

      ' Create a ToolStrip and add items to it.
      toolStrip1 = New System.Windows.Forms.ToolStrip()
      toolStrip1.Items.Add("One")
      toolStrip1.Items.Add("Two")
      toolStrip1.Items.Add("Three")

      ' Add the ToolStrip to the top panel of the ToolStripContainer.
      toolStripContainer1.TopToolStripPanel.Controls.Add(toolStrip1)

      ' Create a RichTextBox and add it to the ContentPanel.
      richTextBox1 = New System.Windows.Forms.RichTextBox()
      richTextBox1.Location = New System.Drawing.Point(94, 61)
      toolStripContainer1.ContentPanel.Controls.Add(richTextBox1)

      ' Attach event handlers for the BeginDrag and EndDrag events.
      AddHandler toolStrip1.BeginDrag, AddressOf toolStrip1_BeginDrag
      AddHandler toolStrip1.EndDrag, AddressOf toolStrip1_EndDrag
   End Sub

   ' Clear any text from the RichTextBox when a drag operation begins.
   Private Sub toolStrip1_BeginDrag(sender As Object, e As EventArgs)
      richTextBox1.Text = ""
   End Sub

   ' Notify the user when the drag operation ends.
   Private Sub toolStrip1_EndDrag(sender As Object, e As EventArgs)
      richTextBox1.Text = "The drag operation is complete."
   End Sub
End Class


using System;
using System.Windows.Forms;

public class Form1 : Form
{
    private ToolStripContainer toolStripContainer1;
    private ToolStrip toolStrip1;
    private RichTextBox richTextBox1;

    public Form1()
    {
        DragToolStrip();
    }
    [STAThread]
    static void Main()
        {
            Application.EnableVisualStyles();
            Application.Run(new Form1());
        }

        private void DragToolStrip()
        {
        // Create a ToolStripContainer.
        toolStripContainer1 = new System.Windows.Forms.ToolStripContainer();
        toolStripContainer1.Dock = System.Windows.Forms.DockStyle.Fill;
        Controls.Add(toolStripContainer1);

        // Create a ToolStrip and add items to it.
        toolStrip1 = new System.Windows.Forms.ToolStrip();
        toolStrip1.Items.Add("One");
        toolStrip1.Items.Add("Two");
        toolStrip1.Items.Add("Three");

        // Add the ToolStrip to the top panel of the ToolStripContainer.
        toolStripContainer1.TopToolStripPanel.Controls.Add(toolStrip1);

        // Create a RichTextBox and add it to the ContentPanel.
        richTextBox1 = new System.Windows.Forms.RichTextBox();
        richTextBox1.Location = new System.Drawing.Point(94, 61);
        toolStripContainer1.ContentPanel.Controls.Add(richTextBox1);

        // Attach event handlers for the BeginDrag and EndDrag events.
        toolStrip1.BeginDrag += new System.EventHandler(toolStrip1_BeginDrag);
        toolStrip1.EndDrag += new System.EventHandler(toolStrip1_EndDrag);
    }
    // Clear any text from the RichTextBox when a drag operation begins.
    private void toolStrip1_BeginDrag(object sender, EventArgs e)
    {
        richTextBox1.Text = "";
    }
    // Notify the user when the drag operation ends.
    private void toolStrip1_EndDrag(object sender, EventArgs e)
    {
        richTextBox1.Text="The drag operation is complete.";
    }
}

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.