ToolStripDropDownItem Class
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.
Provides basic functionality for controls that display a ToolStripDropDown when a ToolStripDropDownButton, ToolStripMenuItem, or ToolStripSplitButton control is clicked.
public ref class ToolStripDropDownItem abstract : System::Windows::Forms::ToolStripItempublic abstract class ToolStripDropDownItem : System.Windows.Forms.ToolStripItemtype ToolStripDropDownItem = class
inherit ToolStripItemPublic MustInherit Class ToolStripDropDownItem
Inherits ToolStripItem- Inheritance
- Inheritance
- Derived
Examples
The following code example demonstrates how to show and hide ToolStripMenuItem controls.
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Windows.Forms;
namespace ToolStripDropDownItemCS
{
public class Form1 : Form
{
private ToolStrip toolStrip1;
private StatusStrip statusStrip1;
private ToolStripStatusLabel toolStripStatusLabel1;
private ContextMenuStrip contextMenuStrip1;
private ToolStripMenuItem menuItem1ToolStripMenuItem;
private ToolStripMenuItem menuItem2ToolStripMenuItem;
private ToolStripMenuItem subItemToolStripMenuItem;
private ToolStripMenuItem subItem2ToolStripMenuItem;
private Button showButton;
private Button hideButton;
private System.ComponentModel.IContainer components = null;
public Form1()
{
InitializeComponent();
this.InitializeToolStripDropDownItems();
}
// This utility method creates and initializes three
// ToolStripDropDownItem controls and adds them
// to the form's ToolStrip control.
private void InitializeToolStripDropDownItems()
{
ToolStripDropDownButton b = new ToolStripDropDownButton("DropDownButton");
b.DropDown = this.contextMenuStrip1;
b.DropDownClosed += new EventHandler(toolStripDropDownItem_DropDownClosed);
b.DropDownItemClicked += new ToolStripItemClickedEventHandler(toolStripDropDownItem_DropDownItemClicked);
b.DropDownOpened += new EventHandler(toolStripDropDownItem_DropDownOpened);
ToolStripMenuItem m = new ToolStripMenuItem("MenuItem");
m.DropDown = this.contextMenuStrip1;
m.DropDownClosed += new EventHandler(toolStripDropDownItem_DropDownClosed);
m.DropDownItemClicked += new ToolStripItemClickedEventHandler(toolStripDropDownItem_DropDownItemClicked);
m.DropDownOpened += new EventHandler(toolStripDropDownItem_DropDownOpened);
ToolStripSplitButton sb = new ToolStripSplitButton("SplitButton");
sb.DropDown = this.contextMenuStrip1;
sb.DropDownClosed += new EventHandler(toolStripDropDownItem_DropDownClosed);
sb.DropDownItemClicked += new ToolStripItemClickedEventHandler(toolStripDropDownItem_DropDownItemClicked);
sb.DropDownOpened += new EventHandler(toolStripDropDownItem_DropDownOpened);
this.toolStrip1.Items.AddRange(new ToolStripItem[] { b, m, sb });
}
// This method handles the DropDownOpened event from a
// ToolStripDropDownItem. It displays the value of the
// item's Text property in the form's StatusStrip control.
void toolStripDropDownItem_DropDownOpened(object sender, EventArgs e)
{
ToolStripDropDownItem item = sender as ToolStripDropDownItem;
string msg = String.Format("Item opened: {0}", item.Text);
this.toolStripStatusLabel1.Text = msg;
}
// This method handles the DropDownItemClicked event from a
// ToolStripDropDownItem. It displays the value of the clicked
// item's Text property in the form's StatusStrip control.
void toolStripDropDownItem_DropDownItemClicked(object sender, ToolStripItemClickedEventArgs e)
{
string msg = String.Format("Item clicked: {0}", e.ClickedItem.Text);
this.toolStripStatusLabel1.Text = msg;
}
// This method handles the DropDownClosed event from a
// ToolStripDropDownItem. It displays the value of the
// item's Text property in the form's StatusStrip control.
void toolStripDropDownItem_DropDownClosed(object sender, EventArgs e)
{
ToolStripDropDownItem item = sender as ToolStripDropDownItem;
string msg = String.Format("Item closed: {0}", item.Text);
this.toolStripStatusLabel1.Text = msg;
}
// This method shows the drop-down for the first item
// in the form's ToolStrip.
private void showButton_Click(object sender, EventArgs e)
{
ToolStripDropDownItem item = this.toolStrip1.Items[0] as ToolStripDropDownItem;
if (item.HasDropDownItems)
{
item.ShowDropDown();
}
}
// This method hides the drop-down for the first item
// in the form's ToolStrip.
private void hideButton_Click(object sender, EventArgs e)
{
ToolStripDropDownItem item = this.toolStrip1.Items[0] as ToolStripDropDownItem;
item.HideDropDown();
}
protected override void Dispose(bool disposing)
{
if (disposing && (components != null))
{
components.Dispose();
}
base.Dispose(disposing);
}
#region Windows Form Designer generated code
private void InitializeComponent()
{
this.components = new System.ComponentModel.Container();
this.toolStrip1 = new System.Windows.Forms.ToolStrip();
this.statusStrip1 = new System.Windows.Forms.StatusStrip();
this.toolStripStatusLabel1 = new System.Windows.Forms.ToolStripStatusLabel();
this.contextMenuStrip1 = new System.Windows.Forms.ContextMenuStrip(this.components);
this.menuItem1ToolStripMenuItem = new System.Windows.Forms.ToolStripMenuItem();
this.menuItem2ToolStripMenuItem = new System.Windows.Forms.ToolStripMenuItem();
this.subItemToolStripMenuItem = new System.Windows.Forms.ToolStripMenuItem();
this.subItem2ToolStripMenuItem = new System.Windows.Forms.ToolStripMenuItem();
this.showButton = new System.Windows.Forms.Button();
this.hideButton = new System.Windows.Forms.Button();
this.statusStrip1.SuspendLayout();
this.contextMenuStrip1.SuspendLayout();
this.SuspendLayout();
//
// toolStrip1
//
this.toolStrip1.Location = new System.Drawing.Point(0, 0);
this.toolStrip1.Name = "toolStrip1";
this.toolStrip1.Size = new System.Drawing.Size(292, 25);
this.toolStrip1.TabIndex = 0;
this.toolStrip1.Text = "toolStrip1";
//
// statusStrip1
//
this.statusStrip1.Items.AddRange(new System.Windows.Forms.ToolStripItem[] {
this.toolStripStatusLabel1});
this.statusStrip1.Location = new System.Drawing.Point(0, 251);
this.statusStrip1.Name = "statusStrip1";
this.statusStrip1.Size = new System.Drawing.Size(292, 22);
this.statusStrip1.TabIndex = 1;
this.statusStrip1.Text = "statusStrip1";
//
// toolStripStatusLabel1
//
this.toolStripStatusLabel1.Name = "toolStripStatusLabel1";
this.toolStripStatusLabel1.Size = new System.Drawing.Size(38, 17);
this.toolStripStatusLabel1.Text = "Ready";
//
// contextMenuStrip1
//
this.contextMenuStrip1.Items.AddRange(new System.Windows.Forms.ToolStripItem[] {
this.menuItem1ToolStripMenuItem,
this.menuItem2ToolStripMenuItem});
this.contextMenuStrip1.Name = "contextMenuStrip1";
this.contextMenuStrip1.RightToLeft = System.Windows.Forms.RightToLeft.No;
this.contextMenuStrip1.Size = new System.Drawing.Size(146, 48);
//
// menuItem1ToolStripMenuItem
//
this.menuItem1ToolStripMenuItem.DropDownItems.AddRange(new System.Windows.Forms.ToolStripItem[] {
this.subItemToolStripMenuItem});
this.menuItem1ToolStripMenuItem.Name = "menuItem1ToolStripMenuItem";
this.menuItem1ToolStripMenuItem.Size = new System.Drawing.Size(145, 22);
this.menuItem1ToolStripMenuItem.Text = "Menu Item1";
//
// menuItem2ToolStripMenuItem
//
this.menuItem2ToolStripMenuItem.DropDownItems.AddRange(new System.Windows.Forms.ToolStripItem[] {
this.subItem2ToolStripMenuItem});
this.menuItem2ToolStripMenuItem.Name = "menuItem2ToolStripMenuItem";
this.menuItem2ToolStripMenuItem.Size = new System.Drawing.Size(145, 22);
this.menuItem2ToolStripMenuItem.Text = "Menu Item 2";
//
// subItemToolStripMenuItem
//
this.subItemToolStripMenuItem.Name = "subItemToolStripMenuItem";
this.subItemToolStripMenuItem.Size = new System.Drawing.Size(152, 22);
this.subItemToolStripMenuItem.Text = "Sub Item";
//
// subItem2ToolStripMenuItem
//
this.subItem2ToolStripMenuItem.Name = "subItem2ToolStripMenuItem";
this.subItem2ToolStripMenuItem.Size = new System.Drawing.Size(152, 22);
this.subItem2ToolStripMenuItem.Text = "Sub Item2";
//
// showButton
//
this.showButton.Location = new System.Drawing.Point(12, 180);
this.showButton.Name = "showButton";
this.showButton.Size = new System.Drawing.Size(75, 23);
this.showButton.TabIndex = 2;
this.showButton.Text = "Show";
this.showButton.UseVisualStyleBackColor = true;
this.showButton.Click += new System.EventHandler(this.showButton_Click);
//
// hideButton
//
this.hideButton.Location = new System.Drawing.Point(12, 209);
this.hideButton.Name = "hideButton";
this.hideButton.Size = new System.Drawing.Size(75, 23);
this.hideButton.TabIndex = 3;
this.hideButton.Text = "Hide";
this.hideButton.UseVisualStyleBackColor = true;
this.hideButton.Click += new System.EventHandler(this.hideButton_Click);
//
// Form1
//
this.AutoScaleDimensions = new System.Drawing.SizeF(6F, 13F);
this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
this.ClientSize = new System.Drawing.Size(292, 273);
this.Controls.Add(this.statusStrip1);
this.Controls.Add(this.hideButton);
this.Controls.Add(this.toolStrip1);
this.Controls.Add(this.showButton);
this.Name = "Form1";
this.Text = "Form1";
this.statusStrip1.ResumeLayout(false);
this.statusStrip1.PerformLayout();
this.contextMenuStrip1.ResumeLayout(false);
this.ResumeLayout(false);
this.PerformLayout();
}
#endregion
}
static class Program
{
/// <summary>
/// The main entry point for the application.
/// </summary>
[STAThread]
static void Main()
{
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
Application.Run(new Form1());
}
}
}
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Drawing
Imports System.Windows.Forms
Public Class Form1
Inherits Form
Private toolStrip1 As ToolStrip
Private statusStrip1 As StatusStrip
Private toolStripStatusLabel1 As ToolStripStatusLabel
Private contextMenuStrip1 As ContextMenuStrip
Private menuItem1ToolStripMenuItem As ToolStripMenuItem
Private menuItem2ToolStripMenuItem As ToolStripMenuItem
Private subItemToolStripMenuItem As ToolStripMenuItem
Private subItem2ToolStripMenuItem As ToolStripMenuItem
Private WithEvents showButton As Button
Private WithEvents hideButton As Button
Private components As System.ComponentModel.IContainer = Nothing
Public Sub New()
InitializeComponent()
Me.InitializeToolStripDropDownItems()
End Sub
' This utility method creates and initializes three
' ToolStripDropDownItem controls and adds them
' to the form's ToolStrip control.
Private Sub InitializeToolStripDropDownItems()
Dim b As New ToolStripDropDownButton("DropDownButton")
b.DropDown = Me.contextMenuStrip1
AddHandler b.DropDownClosed, AddressOf toolStripDropDownItem_DropDownClosed
AddHandler b.DropDownItemClicked, AddressOf toolStripDropDownItem_DropDownItemClicked
AddHandler b.DropDownOpened, AddressOf toolStripDropDownItem_DropDownOpened
Dim m As New ToolStripMenuItem("MenuItem")
m.DropDown = Me.contextMenuStrip1
AddHandler m.DropDownClosed, AddressOf toolStripDropDownItem_DropDownClosed
AddHandler m.DropDownItemClicked, AddressOf toolStripDropDownItem_DropDownItemClicked
AddHandler m.DropDownOpened, AddressOf toolStripDropDownItem_DropDownOpened
Dim sb As New ToolStripSplitButton("SplitButton")
sb.DropDown = Me.contextMenuStrip1
AddHandler sb.DropDownClosed, AddressOf toolStripDropDownItem_DropDownClosed
AddHandler sb.DropDownItemClicked, AddressOf toolStripDropDownItem_DropDownItemClicked
AddHandler sb.DropDownOpened, AddressOf toolStripDropDownItem_DropDownOpened
Me.toolStrip1.Items.AddRange(New ToolStripItem() {b, m, sb})
End Sub
' This method handles the DropDownOpened event from a
' ToolStripDropDownItem. It displays the value of the
' item's Text property in the form's StatusStrip control.
Private Sub toolStripDropDownItem_DropDownOpened(ByVal sender As Object, ByVal e As EventArgs)
Dim item As ToolStripDropDownItem = CType(sender, ToolStripDropDownItem)
Dim msg As String = String.Format("Item opened: {0}", item.Text)
Me.toolStripStatusLabel1.Text = msg
End Sub
' This method handles the DropDownItemClicked event from a
' ToolStripDropDownItem. It displays the value of the clicked
' item's Text property in the form's StatusStrip control.
Private Sub toolStripDropDownItem_DropDownItemClicked( _
ByVal sender As Object, _
ByVal e As ToolStripItemClickedEventArgs)
Dim msg As String = String.Format("Item clicked: {0}", e.ClickedItem.Text)
Me.toolStripStatusLabel1.Text = msg
End Sub
' This method handles the DropDownClosed event from a
' ToolStripDropDownItem. It displays the value of the
' item's Text property in the form's StatusStrip control.
Private Sub toolStripDropDownItem_DropDownClosed(ByVal sender As Object, ByVal e As EventArgs)
Dim item As ToolStripDropDownItem = CType(sender, ToolStripDropDownItem)
Dim msg As String = String.Format("Item closed: {0}", item.Text)
Me.toolStripStatusLabel1.Text = msg
End Sub
' This method shows the drop-down for the first item
' in the form's ToolStrip.
Private Sub showButton_Click( _
ByVal sender As Object, _
ByVal e As EventArgs) _
Handles showButton.Click
Dim item As ToolStripDropDownItem = CType(Me.toolStrip1.Items(0), ToolStripDropDownItem)
If item.HasDropDownItems Then
item.ShowDropDown()
End If
End Sub
' This method hides the drop-down for the first item
' in the form's ToolStrip.
Private Sub hideButton_Click( _
ByVal sender As Object, _
ByVal e As EventArgs) _
Handles hideButton.Click
Dim item As ToolStripDropDownItem = CType(Me.toolStrip1.Items(0), ToolStripDropDownItem)
item.HideDropDown()
End Sub
Protected Overrides Sub Dispose(disposing As Boolean)
If disposing AndAlso (components IsNot Nothing) Then
components.Dispose()
End If
MyBase.Dispose(disposing)
End Sub
#Region "Windows Form Designer generated code"
Private Sub InitializeComponent()
Me.components = New System.ComponentModel.Container()
Me.toolStrip1 = New System.Windows.Forms.ToolStrip()
Me.statusStrip1 = New System.Windows.Forms.StatusStrip()
Me.toolStripStatusLabel1 = New System.Windows.Forms.ToolStripStatusLabel()
Me.contextMenuStrip1 = New System.Windows.Forms.ContextMenuStrip(Me.components)
Me.menuItem1ToolStripMenuItem = New System.Windows.Forms.ToolStripMenuItem()
Me.menuItem2ToolStripMenuItem = New System.Windows.Forms.ToolStripMenuItem()
Me.subItemToolStripMenuItem = New System.Windows.Forms.ToolStripMenuItem()
Me.subItem2ToolStripMenuItem = New System.Windows.Forms.ToolStripMenuItem()
Me.showButton = New System.Windows.Forms.Button()
Me.hideButton = New System.Windows.Forms.Button()
Me.statusStrip1.SuspendLayout()
Me.contextMenuStrip1.SuspendLayout()
Me.SuspendLayout()
'
' toolStrip1
'
Me.toolStrip1.Location = New System.Drawing.Point(0, 0)
Me.toolStrip1.Name = "toolStrip1"
Me.toolStrip1.Size = New System.Drawing.Size(292, 25)
Me.toolStrip1.TabIndex = 0
Me.toolStrip1.Text = "toolStrip1"
'
' statusStrip1
'
Me.statusStrip1.Items.AddRange(New System.Windows.Forms.ToolStripItem() {Me.toolStripStatusLabel1})
Me.statusStrip1.Location = New System.Drawing.Point(0, 251)
Me.statusStrip1.Name = "statusStrip1"
Me.statusStrip1.Size = New System.Drawing.Size(292, 22)
Me.statusStrip1.TabIndex = 1
Me.statusStrip1.Text = "statusStrip1"
'
' toolStripStatusLabel1
'
Me.toolStripStatusLabel1.Name = "toolStripStatusLabel1"
Me.toolStripStatusLabel1.Size = New System.Drawing.Size(38, 17)
Me.toolStripStatusLabel1.Text = "Ready"
'
' contextMenuStrip1
'
Me.contextMenuStrip1.Items.AddRange(New System.Windows.Forms.ToolStripItem() {Me.menuItem1ToolStripMenuItem, Me.menuItem2ToolStripMenuItem})
Me.contextMenuStrip1.Name = "contextMenuStrip1"
Me.contextMenuStrip1.RightToLeft = System.Windows.Forms.RightToLeft.No
Me.contextMenuStrip1.Size = New System.Drawing.Size(146, 48)
'
' menuItem1ToolStripMenuItem
'
Me.menuItem1ToolStripMenuItem.DropDownItems.AddRange(New System.Windows.Forms.ToolStripItem() {Me.subItemToolStripMenuItem})
Me.menuItem1ToolStripMenuItem.Name = "menuItem1ToolStripMenuItem"
Me.menuItem1ToolStripMenuItem.Size = New System.Drawing.Size(145, 22)
Me.menuItem1ToolStripMenuItem.Text = "Menu Item1"
'
' menuItem2ToolStripMenuItem
'
Me.menuItem2ToolStripMenuItem.DropDownItems.AddRange(New System.Windows.Forms.ToolStripItem() {Me.subItem2ToolStripMenuItem})
Me.menuItem2ToolStripMenuItem.Name = "menuItem2ToolStripMenuItem"
Me.menuItem2ToolStripMenuItem.Size = New System.Drawing.Size(145, 22)
Me.menuItem2ToolStripMenuItem.Text = "Menu Item 2"
'
' subItemToolStripMenuItem
'
Me.subItemToolStripMenuItem.Name = "subItemToolStripMenuItem"
Me.subItemToolStripMenuItem.Size = New System.Drawing.Size(152, 22)
Me.subItemToolStripMenuItem.Text = "Sub Item"
'
' subItem2ToolStripMenuItem
'
Me.subItem2ToolStripMenuItem.Name = "subItem2ToolStripMenuItem"
Me.subItem2ToolStripMenuItem.Size = New System.Drawing.Size(152, 22)
Me.subItem2ToolStripMenuItem.Text = "Sub Item2"
'
' showButton
'
Me.showButton.Location = New System.Drawing.Point(12, 180)
Me.showButton.Name = "showButton"
Me.showButton.Size = New System.Drawing.Size(75, 23)
Me.showButton.TabIndex = 2
Me.showButton.Text = "Show"
Me.showButton.UseVisualStyleBackColor = True
'
' hideButton
'
Me.hideButton.Location = New System.Drawing.Point(12, 209)
Me.hideButton.Name = "hideButton"
Me.hideButton.Size = New System.Drawing.Size(75, 23)
Me.hideButton.TabIndex = 3
Me.hideButton.Text = "Hide"
Me.hideButton.UseVisualStyleBackColor = True
'
' Form1
'
Me.AutoScaleDimensions = New System.Drawing.SizeF(6F, 13F)
Me.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font
Me.ClientSize = New System.Drawing.Size(292, 273)
Me.Controls.Add(statusStrip1)
Me.Controls.Add(hideButton)
Me.Controls.Add(toolStrip1)
Me.Controls.Add(showButton)
Me.Name = "Form1"
Me.Text = "Form1"
Me.statusStrip1.ResumeLayout(False)
Me.statusStrip1.PerformLayout()
Me.contextMenuStrip1.ResumeLayout(False)
Me.ResumeLayout(False)
Me.PerformLayout()
End Sub
#End Region
End Class
Public Class Program
' The main entry point for the application.
<STAThread()> _
Shared Sub Main()
Application.EnableVisualStyles()
Application.SetCompatibleTextRenderingDefault(False)
Application.Run(New Form1())
End Sub
End Class
Remarks
ToolStripDropDownItem is the abstract base class for ToolStripMenuItem, ToolStripDropDownButton, and ToolStripSplitButton, which can host items directly or host additional items in a drop-down container. You do this by setting the DropDown property to a ToolStripDropDown and setting the Items property of the ToolStripDropDown. Access these drop-down items directly through the DropDownItems property.
Constructors
| ToolStripDropDownItem() |
Initializes a new instance of the ToolStripDropDownItem class. |
| ToolStripDropDownItem(String, Image, EventHandler, String) |
Initializes a new instance of the ToolStripDropDownItem class with the specified display text, image, action to take when the drop-down control is clicked, and control name. |
| ToolStripDropDownItem(String, Image, EventHandler) |
Initializes a new instance of the ToolStripDropDownItem class with the specified display text, image, and action to take when the drop-down control is clicked. |
| ToolStripDropDownItem(String, Image, ToolStripItem[]) |
Initializes a new instance of the ToolStripDropDownItem class with the specified display text, image, and ToolStripItem collection that the drop-down control contains. |
Properties
| AccessibilityObject |
Gets the AccessibleObject assigned to the control. (Inherited from ToolStripItem) |
| AccessibleDefaultActionDescription |
Gets or sets the default action description of the control for use by accessibility client applications. (Inherited from ToolStripItem) |
| AccessibleDescription |
Gets or sets the description that will be reported to accessibility client applications. (Inherited from ToolStripItem) |
| AccessibleName |
Gets or sets the name of the control for use by accessibility client applications. (Inherited from ToolStripItem) |
| AccessibleRole |
Gets or sets the accessible role of the control, which specifies the type of user interface element of the control. (Inherited from ToolStripItem) |
| Alignment |
Gets or sets a value indicating whether the item aligns towards the beginning or end of the ToolStrip. (Inherited from ToolStripItem) |
| AllowDrop |
Gets or sets a value indicating whether drag-and-drop and item reordering are handled through events that you implement. (Inherited from ToolStripItem) |
| Anchor |
Gets or sets the edges of the container to which a ToolStripItem is bound and determines how a ToolStripItem is resized with its parent. (Inherited from ToolStripItem) |
| AutoSize |
Gets or sets a value indicating whether the item is automatically sized. (Inherited from ToolStripItem) |
| AutoToolTip |
Gets or sets a value indicating whether to use the Text property or the ToolTipText property for the ToolStripItem ToolTip. (Inherited from ToolStripItem) |
| Available |
Gets or sets a value indicating whether the ToolStripItem should be placed on a ToolStrip. (Inherited from ToolStripItem) |
| BackColor |
Gets or sets the background color for the item. (Inherited from ToolStripItem) |
| BackgroundImage |
Gets or sets the background image displayed in the item. (Inherited from ToolStripItem) |
| BackgroundImageLayout |
Gets or sets the background image layout used for the ToolStripItem. (Inherited from ToolStripItem) |
| BindingContext |
Gets or sets the collection of currency managers for the IBindableComponent. (Inherited from BindableComponent) |
| Bounds |
Gets the size and location of the item. (Inherited from ToolStripItem) |
| CanRaiseEvents |
Gets a value indicating whether the component can raise an event. (Inherited from Component) |
| CanSelect |
Gets a value indicating whether the item can be selected. (Inherited from ToolStripItem) |
| Command |
Gets or sets the ICommand whose Execute(Object) method will be called when the ToolStripItem's Click event is invoked. (Inherited from ToolStripItem) |
| CommandParameter |
Gets or sets the parameter that is passed to the ICommand that's assigned to the Command property. (Inherited from ToolStripItem) |
| Container |
Gets the IContainer that contains the Component. (Inherited from Component) |
| ContentRectangle |
Gets the area where content, such as text and icons, can be placed within a ToolStripItem without overwriting background borders. (Inherited from ToolStripItem) |
| DataBindings |
Gets the collection of data-binding objects for this IBindableComponent. (Inherited from BindableComponent) |
| DefaultAutoToolTip |
Gets a value indicating whether to display the ToolTip that is defined as the default. (Inherited from ToolStripItem) |
| DefaultDisplayStyle |
Gets a value indicating what is displayed on the ToolStripItem. (Inherited from ToolStripItem) |
| DefaultMargin |
Gets the default margin of an item. (Inherited from ToolStripItem) |
| DefaultPadding |
Gets the internal spacing characteristics of the item. (Inherited from ToolStripItem) |
| DefaultSize |
Gets the default size of the item. (Inherited from ToolStripItem) |
| DesignMode |
Gets a value that indicates whether the Component is currently in design mode. (Inherited from Component) |
| DismissWhenClicked |
Gets a value indicating whether items on a ToolStripDropDown are hidden after they are clicked. (Inherited from ToolStripItem) |
| DisplayStyle |
Gets or sets whether text and images are displayed on a ToolStripItem. (Inherited from ToolStripItem) |
| Dock |
Gets or sets which ToolStripItem borders are docked to its parent control and determines how a ToolStripItem is resized with its parent. (Inherited from ToolStripItem) |
| DoubleClickEnabled |
Gets or sets a value indicating whether the ToolStripItem can be activated by double-clicking the mouse. (Inherited from ToolStripItem) |
| DropDown |
Gets or sets the ToolStripDropDown that will be displayed when this ToolStripDropDownItem is clicked. |
| DropDownDirection |
Gets or sets a value indicating the direction in which the ToolStripDropDownItem emerges from its parent container. |
| DropDownItems |
Gets the collection of items in the ToolStripDropDown that is associated with this ToolStripDropDownItem. |
| DropDownLocation |
Gets the screen coordinates, in pixels, of the upper-left corner of the ToolStripDropDownItem. |
| Enabled |
Gets or sets a value indicating whether the parent control of the ToolStripItem is enabled. (Inherited from ToolStripItem) |
| Events |
Gets the list of event handlers that are attached to this Component. (Inherited from Component) |
| Font |
Gets or sets the font of the text displayed by the item. (Inherited from ToolStripItem) |
| ForeColor |
Gets or sets the foreground color of the item. (Inherited from ToolStripItem) |
| HasDropDown |
Gets or sets a value that indicates whether the DropDown for the ToolStripDropDownItem has been created. |
| HasDropDownItems |
Gets a value indicating whether the ToolStripDropDownItem has ToolStripDropDown controls associated with it. |
| Height |
Gets or sets the height, in pixels, of a ToolStripItem. (Inherited from ToolStripItem) |
| Image |
Gets or sets the image that is displayed on a ToolStripItem. (Inherited from ToolStripItem) |
| ImageAlign |
Gets or sets the alignment of the image on a ToolStripItem. (Inherited from ToolStripItem) |
| ImageIndex |
Gets or sets the index value of the image that is displayed on the item. (Inherited from ToolStripItem) |
| ImageKey |
Gets or sets the key accessor for the image in the ImageList that is displayed on a ToolStripItem. (Inherited from ToolStripItem) |
| ImageScaling |
Gets or sets a value indicating whether an image on a ToolStripItem is automatically resized to fit in a container. (Inherited from ToolStripItem) |
| ImageTransparentColor |
Gets or sets the color to treat as transparent in a ToolStripItem image. (Inherited from ToolStripItem) |
| IsDisposed |
Gets a value indicating whether the object has been disposed of. (Inherited from ToolStripItem) |
| IsOnDropDown |
Gets a value indicating whether the container of the current Control is a ToolStripDropDown. (Inherited from ToolStripItem) |
| IsOnOverflow |
Gets a value indicating whether the Placement property is set to Overflow. (Inherited from ToolStripItem) |
| Margin |
Gets or sets the space between the item and adjacent items. (Inherited from ToolStripItem) |
| MergeAction |
Gets or sets how child menus are merged with parent menus. (Inherited from ToolStripItem) |
| MergeIndex |
Gets or sets the position of a merged item within the current ToolStrip. (Inherited from ToolStripItem) |
| Name |
Gets or sets the name of the item. (Inherited from ToolStripItem) |
| Overflow |
Gets or sets whether the item is attached to the ToolStrip or ToolStripOverflowButton or can float between the two. (Inherited from ToolStripItem) |
| Owner |
Gets or sets the owner of this item. (Inherited from ToolStripItem) |
| OwnerItem |
Gets the parent ToolStripItem of this ToolStripItem. (Inherited from ToolStripItem) |
| Padding |
Gets or sets the internal spacing, in pixels, between the item's contents and its edges. (Inherited from ToolStripItem) |
| Parent |
Gets or sets the parent container of the ToolStripItem. (Inherited from ToolStripItem) |
| Placement |
Gets the current layout of the item. (Inherited from ToolStripItem) |
| Pressed |
Gets a value indicating whether the ToolStripDropDownItem is in the pressed state. |
| Renderer |
Returns the parent ToolStrip's renderer. (Inherited from ToolStripItem) |
| RightToLeft |
Gets or sets a value indicating whether items are to be placed from right to left and text is to be written from right to left. (Inherited from ToolStripItem) |
| RightToLeftAutoMirrorImage |
Mirrors automatically the ToolStripItem image when the RightToLeft property is set to Yes. (Inherited from ToolStripItem) |
| Selected |
Gets a value indicating whether the item is selected. (Inherited from ToolStripItem) |
| ShowKeyboardCues |
Gets a value indicating whether to show or hide shortcut keys. (Inherited from ToolStripItem) |
| Site |
Gets or sets the ISite of the Component. (Inherited from Component) |
| Size |
Gets or sets the size of the item. (Inherited from ToolStripItem) |
| Tag |
Gets or sets the object that contains data about the item. (Inherited from ToolStripItem) |
| Text |
Gets or sets the text that is to be displayed on the item. (Inherited from ToolStripItem) |
| TextAlign |
Gets or sets the alignment of the text on a ToolStripLabel. (Inherited from ToolStripItem) |
| TextDirection |
Gets the orientation of text used on a ToolStripItem. (Inherited from ToolStripItem) |
| TextImageRelation |
Gets or sets the position of ToolStripItem text and image relative to each other. (Inherited from ToolStripItem) |
| ToolTipText |
Gets or sets the text that appears as a ToolTip for a control. (Inherited from ToolStripItem) |
| Visible |
Gets or sets a value indicating whether the item is displayed. (Inherited from ToolStripItem) |
| Width |
Gets or sets the width in pixels of a ToolStripItem. (Inherited from ToolStripItem) |
Methods
| CreateAccessibilityInstance() |
Creates a new accessibility object for the ToolStripItem. |
| CreateDefaultDropDown() |
Creates a generic ToolStripDropDown for which events can be defined. |
| CreateObjRef(Type) |
Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject) |
| Dispose() |
Releases all resources used by the Component. (Inherited from Component) |
| Dispose(Boolean) |
Releases the unmanaged resources used by the ToolStripDropDownItem and optionally releases the managed resources. |
| DoDragDrop(Object, DragDropEffects, Bitmap, Point, Boolean) |
Begins a drag operation. (Inherited from ToolStripItem) |
| DoDragDrop(Object, DragDropEffects) |
Begins a drag-and-drop operation. (Inherited from ToolStripItem) |
| Equals(Object) |
Determines whether the specified object is equal to the current object. (Inherited from Object) |
| GetCurrentParent() |
Retrieves the ToolStrip that is the container of the current ToolStripItem. (Inherited from ToolStripItem) |
| GetHashCode() |
Serves as the default hash function. (Inherited from Object) |
| GetLifetimeService() |
Obsolete.
Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject) |
| GetPreferredSize(Size) |
Retrieves the size of a rectangular area into which a control can be fit. (Inherited from ToolStripItem) |
| GetService(Type) |
Returns an object that represents a service provided by the Component or by its Container. (Inherited from Component) |
| GetType() |
Gets the Type of the current instance. (Inherited from Object) |
| HideDropDown() |
Makes a visible ToolStripDropDown hidden. |
| InitializeLifetimeService() |
Obsolete.
Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject) |
| Invalidate() |
Invalidates the entire surface of the ToolStripItem and causes it to be redrawn. (Inherited from ToolStripItem) |
| Invalidate(Rectangle) |
Invalidates the specified region of the ToolStripItem by adding it to the update region of the ToolStripItem, which is the area that will be repainted at the next paint operation, and causes a paint message to be sent to the ToolStripItem. (Inherited from ToolStripItem) |
| IsInputChar(Char) |
Determines whether a character is an input character that the item recognizes. (Inherited from ToolStripItem) |
| IsInputKey(Keys) |
Determines whether the specified key is a regular input key or a special key that requires preprocessing. (Inherited from ToolStripItem) |
| MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
| MemberwiseClone(Boolean) |
Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject) |
| OnAvailableChanged(EventArgs) |
Raises the AvailableChanged event. (Inherited from ToolStripItem) |
| OnBackColorChanged(EventArgs) |
Raises the BackColorChanged event. (Inherited from ToolStripItem) |
| OnBindingContextChanged(EventArgs) |
Raises the BindingContextChanged event. (Inherited from BindableComponent) |
| OnBoundsChanged() |
Occurs when the Bounds property changes. |
| OnClick(EventArgs) |
Raises the Click event. (Inherited from ToolStripItem) |
| OnCommandCanExecuteChanged(EventArgs) |
Raises the CommandCanExecuteChanged event. (Inherited from ToolStripItem) |
| OnCommandChanged(EventArgs) |
Raises the CommandChanged event. (Inherited from ToolStripItem) |
| OnCommandParameterChanged(EventArgs) |
Raises the CommandParameterChanged event. (Inherited from ToolStripItem) |
| OnDisplayStyleChanged(EventArgs) |
Raises the DisplayStyleChanged event. (Inherited from ToolStripItem) |
| OnDoubleClick(EventArgs) |
Raises the DoubleClick event. (Inherited from ToolStripItem) |
| OnDragDrop(DragEventArgs) |
Raises the DragDrop event. (Inherited from ToolStripItem) |
| OnDragEnter(DragEventArgs) |
Raises the DragEnter event. (Inherited from ToolStripItem) |
| OnDragLeave(EventArgs) |
Raises the DragLeave event. (Inherited from ToolStripItem) |
| OnDragOver(DragEventArgs) |
Raises the DragOver event. (Inherited from ToolStripItem) |
| OnDropDownClosed(EventArgs) |
Raises the DropDownClosed event. |
| OnDropDownHide(EventArgs) |
Raised in response to the HideDropDown() method. |
| OnDropDownItemClicked(ToolStripItemClickedEventArgs) |
Raises the DropDownItemClicked event. |
| OnDropDownOpened(EventArgs) |
Raises the DropDownOpened event. |
| OnDropDownShow(EventArgs) |
Raised in response to the ShowDropDown() method. |
| OnEnabledChanged(EventArgs) |
Raises the EnabledChanged event. (Inherited from ToolStripItem) |
| OnFontChanged(EventArgs) |
Raises the FontChanged event. |
| OnForeColorChanged(EventArgs) |
Raises the ForeColorChanged event. (Inherited from ToolStripItem) |
| OnGiveFeedback(GiveFeedbackEventArgs) |
Raises the GiveFeedback event. (Inherited from ToolStripItem) |
| OnLayout(LayoutEventArgs) |
Raises the Layout event. (Inherited from ToolStripItem) |
| OnLocationChanged(EventArgs) |
Raises the LocationChanged event. (Inherited from ToolStripItem) |
| OnMouseDown(MouseEventArgs) |
Raises the MouseDown event. (Inherited from ToolStripItem) |
| OnMouseEnter(EventArgs) |
Raises the MouseEnter event. (Inherited from ToolStripItem) |
| OnMouseHover(EventArgs) |
Raises the MouseHover event. (Inherited from ToolStripItem) |
| OnMouseLeave(EventArgs) |
Raises the MouseLeave event. (Inherited from ToolStripItem) |
| OnMouseMove(MouseEventArgs) |
Raises the MouseMove event. (Inherited from ToolStripItem) |
| OnMouseUp(MouseEventArgs) |
Raises the MouseUp event. (Inherited from ToolStripItem) |
| OnOwnerChanged(EventArgs) |
Raises the OwnerChanged event. (Inherited from ToolStripItem) |
| OnOwnerFontChanged(EventArgs) |
Raises the FontChanged event when the Font property has changed on the parent of the ToolStripItem. (Inherited from ToolStripItem) |
| OnPaint(PaintEventArgs) |
Raises the Paint event. (Inherited from ToolStripItem) |
| OnParentBackColorChanged(EventArgs) |
Raises the BackColorChanged event. (Inherited from ToolStripItem) |
| OnParentChanged(ToolStrip, ToolStrip) |
Raises the ParentChanged event. (Inherited from ToolStripItem) |
| OnParentEnabledChanged(EventArgs) |
Raises the EnabledChanged event when the Enabled property value of the item's container changes. (Inherited from ToolStripItem) |
| OnParentForeColorChanged(EventArgs) |
Raises the ForeColorChanged event. (Inherited from ToolStripItem) |
| OnParentRightToLeftChanged(EventArgs) |
Raises the RightToLeftChanged event. (Inherited from ToolStripItem) |
| OnQueryContinueDrag(QueryContinueDragEventArgs) |
Raises the QueryContinueDrag event. (Inherited from ToolStripItem) |
| OnRequestCommandExecute(EventArgs) |
Called in the context of OnClick(EventArgs) to invoke Execute(Object) if the context allows. (Inherited from ToolStripItem) |
| OnRightToLeftChanged(EventArgs) |
Raises the RightToLeftChanged event. |
| OnSelectedChanged(EventArgs) |
Raises the SelectedChanged event. (Inherited from ToolStripItem) |
| OnTextChanged(EventArgs) |
Raises the TextChanged event. (Inherited from ToolStripItem) |
| OnVisibleChanged(EventArgs) |
Raises the VisibleChanged event. (Inherited from ToolStripItem) |
| PerformClick() |
Generates a |
| ProcessCmdKey(Message, Keys) |
Processes a command key. |
| ProcessDialogKey(Keys) |
Processes a dialog key. |
| ProcessMnemonic(Char) |
Processes a mnemonic character. (Inherited from ToolStripItem) |
| ResetBackColor() |
This method is not relevant to this class. (Inherited from ToolStripItem) |
| ResetDisplayStyle() |
This method is not relevant to this class. (Inherited from ToolStripItem) |
| ResetFont() |
This method is not relevant to this class. (Inherited from ToolStripItem) |
| ResetForeColor() |
This method is not relevant to this class. (Inherited from ToolStripItem) |
| ResetImage() |
This method is not relevant to this class. (Inherited from ToolStripItem) |
| ResetMargin() |
This method is not relevant to this class. (Inherited from ToolStripItem) |
| ResetPadding() |
This method is not relevant to this class. (Inherited from ToolStripItem) |
| ResetRightToLeft() |
This method is not relevant to this class. (Inherited from ToolStripItem) |
| ResetTextDirection() |
This method is not relevant to this class. (Inherited from ToolStripItem) |
| Select() |
Selects the item. (Inherited from ToolStripItem) |
| SetBounds(Rectangle) |
Sets the size and location of the item. (Inherited from ToolStripItem) |
| SetVisibleCore(Boolean) |
Sets the ToolStripItem to the specified visible state. (Inherited from ToolStripItem) |
| ShowDropDown() |
Displays the ToolStripDropDownItem control associated with this ToolStripDropDownItem. |
| ToString() |
Returns a String containing the name of the Component, if any. This method should not be overridden. (Inherited from ToolStripItem) |
Events
| AvailableChanged |
Occurs when the value of the Available property changes. (Inherited from ToolStripItem) |
| BackColorChanged |
Occurs when the value of the BackColor property changes. (Inherited from ToolStripItem) |
| BindingContextChanged |
Occurs when the binding context has changed. (Inherited from BindableComponent) |
| Click |
Occurs when the ToolStripItem is clicked. (Inherited from ToolStripItem) |
| CommandCanExecuteChanged |
Occurs when the CanExecute(Object) status of the ICommand that's assigned to the Command property has changed. (Inherited from ToolStripItem) |
| CommandChanged |
Occurs when the assigned ICommand of the Command property has changed. (Inherited from ToolStripItem) |
| CommandParameterChanged |
Occurs when the value of the CommandParameter property has changed. (Inherited from ToolStripItem) |
| DisplayStyleChanged |
Occurs when the DisplayStyle has changed. (Inherited from ToolStripItem) |
| Disposed |
Occurs when the component is disposed by a call to the Dispose() method. (Inherited from Component) |
| DoubleClick |
Occurs when the item is double-clicked with the mouse. (Inherited from ToolStripItem) |
| DragDrop |
Occurs when the user drags an item and the user releases the mouse button, indicating that the item should be dropped into this item. (Inherited from ToolStripItem) |
| DragEnter |
Occurs when the user drags an item into the client area of this item. (Inherited from ToolStripItem) |
| DragLeave |
Occurs when the user drags an item and the mouse pointer is no longer over the client area of this item. (Inherited from ToolStripItem) |
| DragOver |
Occurs when the user drags an item over the client area of this item. (Inherited from ToolStripItem) |
| DropDownClosed |
Occurs when the ToolStripDropDown closes. |
| DropDownItemClicked |
Occurs when the ToolStripDropDown is clicked. |
| DropDownOpened |
Occurs when the ToolStripDropDown has opened. |
| DropDownOpening |
Occurs as the ToolStripDropDown is opening. |
| EnabledChanged |
Occurs when the Enabled property value has changed. (Inherited from ToolStripItem) |
| ForeColorChanged |
Occurs when the ForeColor property value changes. (Inherited from ToolStripItem) |
| GiveFeedback |
Occurs during a drag operation. (Inherited from ToolStripItem) |
| LocationChanged |
Occurs when the location of a ToolStripItem is updated. (Inherited from ToolStripItem) |
| MouseDown |
Occurs when the mouse pointer is over the item and a mouse button is pressed. (Inherited from ToolStripItem) |
| MouseEnter |
Occurs when the mouse pointer enters the item. (Inherited from ToolStripItem) |
| MouseHover |
Occurs when the mouse pointer hovers over the item. (Inherited from ToolStripItem) |
| MouseLeave |
Occurs when the mouse pointer leaves the item. (Inherited from ToolStripItem) |
| MouseMove |
Occurs when the mouse pointer is moved over the item. (Inherited from ToolStripItem) |
| MouseUp |
Occurs when the mouse pointer is over the item and a mouse button is released. (Inherited from ToolStripItem) |
| OwnerChanged |
Occurs when the Owner property changes. (Inherited from ToolStripItem) |
| Paint |
Occurs when the item is redrawn. (Inherited from ToolStripItem) |
| QueryAccessibilityHelp |
Occurs when an accessibility client application invokes help for the ToolStripItem. (Inherited from ToolStripItem) |
| QueryContinueDrag |
Occurs during a drag-and-drop operation and allows the drag source to determine whether the drag-and-drop operation should be canceled. (Inherited from ToolStripItem) |
| RightToLeftChanged |
Occurs when the RightToLeft property value changes. (Inherited from ToolStripItem) |
| SelectedChanged |
Occurs when the value of the Selected property changes. (Inherited from ToolStripItem) |
| TextChanged |
Occurs when the value of the Text property changes. (Inherited from ToolStripItem) |
| VisibleChanged |
Occurs when the value of the Visible property changes. (Inherited from ToolStripItem) |
Explicit Interface Implementations
| IDropTarget.OnDragDrop(DragEventArgs) |
Raises the DragDrop event. (Inherited from ToolStripItem) |
| IDropTarget.OnDragEnter(DragEventArgs) |
Raises the DragEnter event. (Inherited from ToolStripItem) |
| IDropTarget.OnDragLeave(EventArgs) |
Raises the DragLeave event. (Inherited from ToolStripItem) |
| IDropTarget.OnDragOver(DragEventArgs) |
Raises the |
