ToolStripItem.Click Event
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Occurs when the ToolStripItem is clicked.
public:
event EventHandler ^ Click;public event EventHandler Click;public event EventHandler? Click;member this.Click : EventHandler Public Custom Event Click As EventHandler Event Type
Examples
The following code example demonstrates how to set the Text, Overflow, and TextDirection properties, and handle the Click event. To run this example, paste the following code into a form that contains a ToolStrip named movingToolStrip and call InitializeMovingToolStrip in the form's constructor or Load event handler.
ToolStripButton^ changeDirectionButton;
void InitializeMovingToolStrip()
{
changeDirectionButton = gcnew ToolStripButton;
movingToolStrip->AutoSize = true;
movingToolStrip->RenderMode = ToolStripRenderMode::System;
changeDirectionButton->TextDirection =
ToolStripTextDirection::Vertical270;
changeDirectionButton->Overflow =
ToolStripItemOverflow::Never;
changeDirectionButton->Text = "Change Alignment";
movingToolStrip->Items->Add(changeDirectionButton);
changeDirectionButton->Click += gcnew EventHandler(this,
&Form1::changeDirectionButtonClick);
}
void changeDirectionButtonClick(Object^ sender, EventArgs^ e)
{
ToolStripItem^ item = (ToolStripItem^) sender;
if ((item->TextDirection == ToolStripTextDirection::Vertical270)
|| (item->TextDirection == ToolStripTextDirection::Vertical90))
{
item->TextDirection = ToolStripTextDirection::Horizontal;
movingToolStrip->Raft = RaftingSides::Top;
}
else
{
item->TextDirection =
ToolStripTextDirection::Vertical270;
movingToolStrip->Raft = RaftingSides::Left;
}
}
internal ToolStripButton changeDirectionButton;
private void InitializeMovingToolStrip()
{
movingToolStrip = new ToolStrip();
changeDirectionButton = new ToolStripButton();
movingToolStrip.AutoSize = true;
movingToolStrip.RenderMode = ToolStripRenderMode.System;
changeDirectionButton.TextDirection = ToolStripTextDirection.Vertical270;
changeDirectionButton.Overflow = ToolStripItemOverflow.Never;
changeDirectionButton.Text = "Change Alignment";
movingToolStrip.Items.Add(changeDirectionButton);
}
private void changeDirectionButton_Click(object sender, EventArgs e)
{
ToolStripItem item = (ToolStripItem)sender;
if (item.TextDirection == ToolStripTextDirection.Vertical270 || item.TextDirection == ToolStripTextDirection.Vertical90)
{
item.TextDirection = ToolStripTextDirection.Horizontal;
movingToolStrip.Dock = System.Windows.Forms.DockStyle.Top;
}
else
{
item.TextDirection = ToolStripTextDirection.Vertical270;
movingToolStrip.Dock = System.Windows.Forms.DockStyle.Left;
}
}
Friend WithEvents changeDirectionButton As ToolStripButton
Private Sub InitializeMovingToolStrip()
changeDirectionButton = New ToolStripButton()
movingToolStrip.AutoSize = True
movingToolStrip.RenderMode = ToolStripRenderMode.System
changeDirectionButton.TextDirection = ToolStripTextDirection.Vertical270
changeDirectionButton.Overflow = ToolStripItemOverflow.Never
changeDirectionButton.Text = "Change Alignment"
movingToolStrip.Items.Add(changeDirectionButton)
End Sub
Public Sub changeDirectionButton_Click(ByVal sender As Object, _
ByVal e As EventArgs) Handles changeDirectionButton.Click
Dim item As ToolStripItem = CType(sender, ToolStripItem)
If item.TextDirection = ToolStripTextDirection.Vertical270 _
OrElse item.TextDirection = ToolStripTextDirection.Vertical90 Then
item.TextDirection = ToolStripTextDirection.Horizontal
movingToolStrip.Dock = System.Windows.Forms.DockStyle.Top
Else
item.TextDirection = ToolStripTextDirection.Vertical270
movingToolStrip.Dock = System.Windows.Forms.DockStyle.Left
End If
End Sub
Remarks
The Click event passes an EventArgs to its event handler, so it only indicates that a click has occurred. If you need more specific mouse information (button, number of clicks, wheel rotation, or location), use the MouseDown and MouseUp events which pass a MouseEventArgs to the event handler.
A double-click is determined by the mouse settings of the user's operating system. The user can set the time between clicks of a mouse button that should be considered a double-click rather than two clicks. The Click event is raised every time a control is double-clicked. For example, if you have two event handlers for the Click and DoubleClick events of a Form, the Click and DoubleClick events are raised when the form is double-clicked and both methods are called. If an item is double-clicked that does not support the DoubleClick event, the Click event might be raised twice.
