ToolStripDropDownMenu 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供 ContextMenuStrip 控件的基本功能。
public ref class ToolStripDropDownMenu : System::Windows::Forms::ToolStripDropDown[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class ToolStripDropDownMenu : System.Windows.Forms.ToolStripDropDownpublic class ToolStripDropDownMenu : System.Windows.Forms.ToolStripDropDown[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ToolStripDropDownMenu = class
inherit ToolStripDropDowntype ToolStripDropDownMenu = class
inherit ToolStripDropDownPublic Class ToolStripDropDownMenu
Inherits ToolStripDropDown- 继承
-
ToolStripDropDownMenu
- 派生
- 属性
示例
下面的代码示例演示如何通过设置检查和图像边距来创建和初始化ContextMenuStrip控件。
重要
此代码不是完整的示例，因此无法编译。 有关完整代码列表，请参阅 如何：在 ContextMenuStrip 控件中启用检查边距和图像边距。
public Form5()
{
// Size the form to show three wide menu items.
this.Width = 500;
this.Text = "ToolStripContextMenuStrip: Image and Check Margins";
// Create a new MenuStrip control.
MenuStrip ms = new MenuStrip();
// Create the ToolStripMenuItems for the MenuStrip control.
ToolStripMenuItem bothMargins = new ToolStripMenuItem("BothMargins");
ToolStripMenuItem imageMarginOnly = new ToolStripMenuItem("ImageMargin");
ToolStripMenuItem checkMarginOnly = new ToolStripMenuItem("CheckMargin");
ToolStripMenuItem noMargins = new ToolStripMenuItem("NoMargins");
// Customize the DropDowns menus.
// This ToolStripMenuItem has an image margin
// and a check margin.
bothMargins.DropDown = CreateCheckImageContextMenuStrip();
((ContextMenuStrip)bothMargins.DropDown).ShowImageMargin = true;
((ContextMenuStrip)bothMargins.DropDown).ShowCheckMargin = true;
// This ToolStripMenuItem has only an image margin.
imageMarginOnly.DropDown = CreateCheckImageContextMenuStrip();
((ContextMenuStrip)imageMarginOnly.DropDown).ShowImageMargin = true;
((ContextMenuStrip)imageMarginOnly.DropDown).ShowCheckMargin = false;
// This ToolStripMenuItem has only a check margin.
checkMarginOnly.DropDown = CreateCheckImageContextMenuStrip();
((ContextMenuStrip)checkMarginOnly.DropDown).ShowImageMargin = false;
((ContextMenuStrip)checkMarginOnly.DropDown).ShowCheckMargin = true;
// This ToolStripMenuItem has no image and no check margin.
noMargins.DropDown = CreateCheckImageContextMenuStrip();
((ContextMenuStrip)noMargins.DropDown).ShowImageMargin = false;
((ContextMenuStrip)noMargins.DropDown).ShowCheckMargin = false;
// Populate the MenuStrip control with the ToolStripMenuItems.
ms.Items.Add(bothMargins);
ms.Items.Add(imageMarginOnly);
ms.Items.Add(checkMarginOnly);
ms.Items.Add(noMargins);
// Dock the MenuStrip control to the top of the form.
ms.Dock = DockStyle.Top;
// Add the MenuStrip control to the controls collection last.
// This is important for correct placement in the z-order.
this.Controls.Add(ms);
}
Public Sub New()
' Size the form to show three wide menu items.
Me.Width = 500
Me.Text = "ToolStripContextMenuStrip: Image and Check Margins"
' Create a new MenuStrip control.
Dim ms As New MenuStrip()
' Create the ToolStripMenuItems for the MenuStrip control.
Dim bothMargins As New ToolStripMenuItem("BothMargins")
Dim imageMarginOnly As New ToolStripMenuItem("ImageMargin")
Dim checkMarginOnly As New ToolStripMenuItem("CheckMargin")
Dim noMargins As New ToolStripMenuItem("NoMargins")
' Customize the DropDowns menus.
' This ToolStripMenuItem has an image margin
' and a check margin.
bothMargins.DropDown = CreateCheckImageContextMenuStrip()
CType(bothMargins.DropDown, ContextMenuStrip).ShowImageMargin = True
CType(bothMargins.DropDown, ContextMenuStrip).ShowCheckMargin = True
' This ToolStripMenuItem has only an image margin.
imageMarginOnly.DropDown = CreateCheckImageContextMenuStrip()
CType(imageMarginOnly.DropDown, ContextMenuStrip).ShowImageMargin = True
CType(imageMarginOnly.DropDown, ContextMenuStrip).ShowCheckMargin = False
' This ToolStripMenuItem has only a check margin.
checkMarginOnly.DropDown = CreateCheckImageContextMenuStrip()
CType(checkMarginOnly.DropDown, ContextMenuStrip).ShowImageMargin = False
CType(checkMarginOnly.DropDown, ContextMenuStrip).ShowCheckMargin = True
' This ToolStripMenuItem has no image and no check margin.
noMargins.DropDown = CreateCheckImageContextMenuStrip()
CType(noMargins.DropDown, ContextMenuStrip).ShowImageMargin = False
CType(noMargins.DropDown, ContextMenuStrip).ShowCheckMargin = False
' Populate the MenuStrip control with the ToolStripMenuItems.
ms.Items.Add(bothMargins)
ms.Items.Add(imageMarginOnly)
ms.Items.Add(checkMarginOnly)
ms.Items.Add(noMargins)
' Dock the MenuStrip control to the top of the form.
ms.Dock = DockStyle.Top
' Add the MenuStrip control to the controls collection last.
' This is important for correct placement in the z-order.
Me.Controls.Add(ms)
End Sub
注解
ToolStripDropDownMenu 是 的 ContextMenuStrip基类，提供必要的绘制和布局属性和方法。 最有可能直接使用的此类的属性是 ShowCheckMargin 和 ShowImageMargin 属性，它们决定了快捷菜单是否能够显示检查标记和/或图像。
ToolStripDropDownMenu 并 ToolStripDropDown 替换和扩展 Menu 在 .NET Core 3.1 中删除的 控件。
构造函数
| ToolStripDropDownMenu() |
初始化 ToolStripDropDownMenu 类的新实例。 |
字段
| ScrollStateAutoScrolling |
确定 AutoScroll 属性的值。 (继承自 ScrollableControl) |
| ScrollStateFullDrag |
确定用户是否启用了全窗口拖动。 (继承自 ScrollableControl) |
| ScrollStateHScrollVisible |
确定 HScroll 属性的值是否设置为 |
| ScrollStateUserHasScrolled |
确定用户是否滚动了 ScrollableControl 控件。 (继承自 ScrollableControl) |
| ScrollStateVScrollVisible |
确定 VScroll 属性的值是否设置为 |
属性
| AccessibilityObject |
获取分配给该控件的 AccessibleObject。 (继承自 Control) |
| AccessibleDefaultActionDescription |
获取或设置控件的默认操作说明以供具有辅助功能的客户端应用程序使用。 (继承自 Control) |
| AccessibleDescription |
获取或设置辅助功能客户端应用程序使用的控件说明。 (继承自 Control) |
| AccessibleName |
获取或设置辅助功能客户端应用程序所使用的控件名称。 (继承自 Control) |
| AccessibleRole |
获取或设置控件的辅助性角色。 (继承自 Control) |
| AllowClickThrough |
提供 ContextMenuStrip 控件的基本功能。 (继承自 ToolStrip) |
| AllowDrop |
获取或设置一个值，该值指示是否通过你实现的事件来处理拖放和项重新排序。 (继承自 ToolStrip) |
| AllowItemReorder |
此属性与此类无关。 (继承自 ToolStripDropDown) |
| AllowMerge |
获取或设置一个值，该值指示能否将多个 MenuStrip、ToolStripDropDownMenu、ToolStripMenuItem 及其他类型进行组合。 (继承自 ToolStrip) |
| AllowTransparency |
获取或设置一个值，该值指示能否调整窗体的 Opacity。 (继承自 ToolStripDropDown) |
| Anchor |
此属性与此类无关。 (继承自 ToolStripDropDown) |
| AutoClose |
获取或设置一个值，该值指示 ToolStripDropDown 控件是否应在失去激活状态时自动关闭。 (继承自 ToolStripDropDown) |
| AutoScroll |
此属性与此类无关。 (继承自 ToolStrip) |
| AutoScrollMargin |
此属性与此类无关。 (继承自 ToolStrip) |
| AutoScrollMinSize |
此属性与此类无关。 (继承自 ToolStrip) |
| AutoScrollOffset |
获取或设置一个值，该值指示在 ScrollControlIntoView(Control) 中将控件滚动到何处。 (继承自 Control) |
| AutoScrollPosition |
此属性与此类无关。 (继承自 ToolStrip) |
| AutoSize |
获取或设置一个值，该值指示 ToolStripDropDown 是否在调整窗体大小时自动调整它的大小。 (继承自 ToolStripDropDown) |
| BackColor |
获取或设置 ToolStrip 的背景色。 (继承自 ToolStrip) |
| BackgroundImage |
获取或设置在控件中显示的背景图像。 (继承自 Control) |
| BackgroundImageLayout |
获取或设置在 ImageLayout 枚举中定义的背景图像布局。 (继承自 Control) |
| BindingContext |
获取或设置 ToolStrip 的绑定上下文。 (继承自 ToolStrip) |
| Bottom |
获取控件下边缘与其容器的工作区上边缘之间的距离（以像素为单位）。 (继承自 Control) |
| Bounds |
获取或设置控件（包括其非工作区元素）相对于其父控件的大小和位置（以像素为单位）。 (继承自 Control) |
| CanEnableIme |
获取一个用以指示是否可以将 ImeMode 属性设置为活动值的值，以启用 IME 支持。 (继承自 Control) |
| CanFocus |
获取一个值，该值指示控件是否可以接收焦点。 (继承自 Control) |
| CanOverflow |
获取或设置一个值，该值指示 ToolStripDropDown 中的项是否可被发送到溢出菜单。 (继承自 ToolStripDropDown) |
| CanRaiseEvents |
确定是否可以在控件上引发事件。 (继承自 Control) |
| CanSelect |
获取一个值，该值指示是否可以选中控件。 (继承自 Control) |
| Capture |
获取或设置一个值，该值指示控件是否已捕获鼠标。 (继承自 Control) |
| CausesValidation |
获取或设置一个值，该值指示 ToolStrip 是否会引起在任何需要在接收到焦点时执行验证的控件上执行验证。 (继承自 ToolStrip) |
| ClientRectangle |
获取表示控件的工作区的矩形。 (继承自 Control) |
| ClientSize |
获取或设置控件的工作区的高度和宽度。 (继承自 Control) |
| CompanyName |
获取包含控件的应用程序的公司名称或创建者。 (继承自 Control) |
| Container |
获取包含 IContainer 的 Component。 (继承自 Component) |
| ContainsFocus |
获取一个值，该值指示控件或它的一个子控件当前是否有输入焦点。 (继承自 Control) |
| ContextMenu |
此属性与此类无关。 (继承自 ToolStripDropDown) |
| ContextMenuStrip |
此属性与此类无关。 (继承自 ToolStripDropDown) |
| Controls |
此属性与此类无关。 (继承自 ToolStrip) |
| Created |
获取一个值，该值指示控件是否已经创建。 (继承自 Control) |
| CreateParams |
获取新窗口的参数。 (继承自 ToolStripDropDown) |
| Cursor |
获取或设置当鼠标指针放置在 ToolStrip 上时显示的光标。 (继承自 ToolStrip) |
| DataBindings |
为该控件获取数据绑定。 (继承自 Control) |
| DataContext |
获取或设置用于数据绑定的数据上下文。 这是一个环境属性。 (继承自 Control) |
| DefaultCursor |
获取或设置控件的默认光标。 (继承自 Control) |
| DefaultDock |
获取 ToolStrip 的停靠位置，以指示哪些边框停靠到容器上。 (继承自 ToolStripDropDown) |
| DefaultDropDownDirection |
获取或设置 ToolStripDropDown 相对于 ToolStrip 的显示方向。 (继承自 ToolStripDropDown) |
| DefaultGripMargin |
获取大小调整手柄和 ToolStrip 的边缘之间的默认间距（以像素为单位）。 (继承自 ToolStrip) |
| DefaultImeMode |
获取控件支持的默认输入法编辑器 (IME) 模式。 (继承自 Control) |
| DefaultMargin |
获取 ToolStrip 与 ToolStripContainer 之间的间距（以像素为单位）。 (继承自 ToolStrip) |
| DefaultMaximumSize |
获取以像素为单位的长度和高度，此长度和高度被指定为控件的默认最大大小。 (继承自 Control) |
| DefaultMinimumSize |
获取以像素为单位的长度和高度，此长度和高度被指定为控件的默认最小大小。 (继承自 Control) |
| DefaultPadding |
获取控件的内部间距（以像素为单位）。 |
| DefaultShowItemToolTips |
获取一个值，该值表示是否为 ToolStripDropDown 默认显示工具提示。 (继承自 ToolStripDropDown) |
| DefaultSize |
获取 ToolStrip 的默认大小。 (继承自 ToolStrip) |
| DesignMode |
获取一个值，用以指示 Component 当前是否处于设计模式。 (继承自 Component) |
| DeviceDpi |
获取显示当前控件的显示设备的 DPI 值。 (继承自 Control) |
| DisplayedItems |
获取当前在 ToolStrip 上显示的项的子集，其中包括自动添加到 ToolStrip 中的项。 (继承自 ToolStrip) |
| DisplayRectangle |
获取表示 ToolStripDropDownMenu 的显示区域的矩形。 |
| Disposing |
获取一个值，该值指示 Control 基类是否在释放进程中。 (继承自 Control) |
| Dock |
此属性与此类无关。 (继承自 ToolStripDropDown) |
| DockPadding |
获取控件的所有边缘的停靠边距设置。 (继承自 ScrollableControl) |
| DoubleBuffered |
获取或设置一个值，该值指示此控件是否应使用辅助缓冲区重绘其图面，以减少或避免闪烁。 (继承自 Control) |
| DropShadowEnabled |
获取或设置一个值，该值指示显示 ToolStripDropDown 时是否出现三维阴影效果。 (继承自 ToolStripDropDown) |
| Enabled |
获取或设置一个值，该值指示控件是否可以对用户交互作出响应。 (继承自 Control) |
| Events |
获取附加到此 Component 的事件处理程序的列表。 (继承自 Component) |
| Focused |
获取一个值，该值指示控件是否有输入焦点。 (继承自 Control) |
| Font |
获取或设置 ToolStripDropDown 上显示的文本的字体。 (继承自 ToolStripDropDown) |
| FontHeight |
获取或设置控件的字体的高度。 (继承自 Control) |
| ForeColor |
获取或设置 ToolStrip 的前景色。 (继承自 ToolStrip) |
| GripDisplayStyle |
此属性与此类无关。 (继承自 ToolStripDropDown) |
| GripMargin |
此属性与此类无关。 (继承自 ToolStripDropDown) |
| GripRectangle |
此属性与此类无关。 (继承自 ToolStripDropDown) |
| GripStyle |
此属性与此类无关。 (继承自 ToolStripDropDown) |
| Handle |
获取控件绑定到的窗口句柄。 (继承自 Control) |
| HasChildren |
此属性与此类无关。 (继承自 ToolStrip) |
| Height |
获取或设置控件的高度。 (继承自 Control) |
| HorizontalScroll |
此属性与此类无关。 (继承自 ToolStrip) |
| HScroll |
获取或设置一个值，该值指示水平滚动条是否可见。 (继承自 ScrollableControl) |
| ImageList |
获取或设置包含 ToolStrip 项上显示的图像的图像列表。 (继承自 ToolStrip) |
| ImageScalingSize |
获取或设置 ToolStrip 上所用图像的大小（以像素为单位）。 (继承自 ToolStrip) |
| ImeMode |
获取或设置控件的输入法编辑器 (IME) 模式。 (继承自 Control) |
| ImeModeBase |
获取或设置控件的 IME 模式。 (继承自 Control) |
| InvokeRequired |
获取一个值，该值指示调用方在对控件进行方法调用时是否必须调用 Invoke 方法，因为调用方位于创建控件所在的线程以外的线程中。 (继承自 Control) |
| IsAccessible |
获取或设置一个值，该值指示控件对辅助功能应用程序是否可见。 (继承自 Control) |
| IsAncestorSiteInDesignMode |
指示此控件的上级之一是否位于 DesignMode 中以及该站点。 此属性为只读。 (继承自 Control) |
| IsAutoGenerated |
获取一个值，该值指示是否自动生成此 ToolStripDropDown。 (继承自 ToolStripDropDown) |
| IsCurrentlyDragging |
获取一个值，该值指示用户当前是否正在将 ToolStrip 从一个 ToolStripContainer 移到另一个。 (继承自 ToolStrip) |
| IsDisposed |
获取一个值，该值指示控件是否已经被释放。 (继承自 Control) |
| IsDropDown |
获取一个值，该值指示 ToolStrip 是否为 ToolStripDropDown 控件。 (继承自 ToolStrip) |
| IsHandleCreated |
获取一个值，该值指示控件是否有与它关联的句柄。 (继承自 Control) |
| IsMirrored |
获取一个值，该值指示此控件是否为镜像控件。 (继承自 Control) |
| Items |
获取属于 ToolStrip 的所有项。 (继承自 ToolStrip) |
| LayoutEngine |
将引用传递给由布局引擎接口返回的缓存 LayoutEngine。 |
| LayoutSettings |
获取或设置布局方案特征。 (继承自 ToolStrip) |
| LayoutStyle |
获取或设置一个值，该值指示 ContextMenuStrip 的项的显示方式。 |
| Left |
获取或设置控件左边缘与其容器的工作区左边缘之间的距离（以像素为单位）。 (继承自 Control) |
| Location |
此属性与此类无关。 (继承自 ToolStripDropDown) |
| Margin |
获取或设置控件之间的空间。 (继承自 Control) |
| MaximumSize |
获取或设置大小，该大小是 GetPreferredSize(Size) 可以指定的上限。 (继承自 Control) |
| MaxItemSize |
获取 ContextMenuStrip 的最大高度和宽度，以像素为单位。 |
| MinimumSize |
获取或设置大小，该大小是 GetPreferredSize(Size) 可以指定的下限。 (继承自 Control) |
| Name |
获取或设置控件的名称。 (继承自 Control) |
| Opacity |
确定窗体的不透明度。 (继承自 ToolStripDropDown) |
| Orientation |
获取 ToolStripPanel 的方向。 (继承自 ToolStrip) |
| OverflowButton |
此属性与此类无关。 (继承自 ToolStripDropDown) |
| OwnerItem |
获取或设置作为此 ToolStripItem 所有者的 ToolStripDropDown。 (继承自 ToolStripDropDown) |
| Padding |
获取或设置控件内的空白。 (继承自 Control) |
| Parent |
获取或设置控件的父容器。 (继承自 Control) |
| PreferredSize |
获取可以容纳控件的矩形区域的大小。 (继承自 Control) |
| ProductName |
获取包含控件的程序集的产品名称。 (继承自 Control) |
| ProductVersion |
获取包含控件的程序集的版本。 (继承自 Control) |
| RecreatingHandle |
获取一个值，该值指示控件当前是否在重新创建其句柄。 (继承自 Control) |
| Region |
获取或设置与 ToolStripDropDown 关联的窗口区域。 (继承自 ToolStripDropDown) |
| Renderer |
获取或设置用于自定义 ToolStripRenderer 的外观的 ToolStrip。 (继承自 ToolStrip) |
| RenderMode |
获取或设置一个值，该值指示将把哪种视觉样式应用到 ToolStrip。 (继承自 ToolStrip) |
| RenderRightToLeft |
已过时.
已过时.
此属性现已过时。 (继承自 Control) |
| ResizeRedraw |
获取或设置一个值，该值指示控件在调整大小时是否重绘自己。 (继承自 Control) |
| Right |
获取控件右边缘与其容器的工作区左边缘之间的距离（以像素为单位）。 (继承自 Control) |
| RightToLeft |
获取或设置一个值，该值指示是否将控件的元素对齐以支持使用从右向左的字体的区域设置。 (继承自 ToolStripDropDown) |
| ScaleChildren |
获取一个值，该值确定子控件的缩放。 (继承自 Control) |
| ShowCheckMargin |
获取或设置一个值，该值指示是否在 ToolStripMenuItem 的左边缘显示选中标记的位置。 |
| ShowFocusCues |
获取一个值，该值指示控件是否应显示聚焦框。 (继承自 Control) |
| ShowImageMargin |
获取或设置一个值，该值指示是否在 ToolStripMenuItem 的左边缘显示图像的位置。 |
| ShowItemToolTips |
获取或设置一个值，该值指示是否在 ToolStrip 项上显示工具提示。 (继承自 ToolStrip) |
| ShowKeyboardCues |
获取一个值，该值指示用户界面是否处于适当的状态以显示或隐藏键盘快捷键。 (继承自 Control) |
| Site |
获取或设置控件的站点。 (继承自 Control) |
| Size |
获取或设置控件的高度和宽度。 (继承自 Control) |
| Stretch |
此属性与此类无关。 (继承自 ToolStripDropDown) |
| TabIndex |
此属性与此类无关。 (继承自 ToolStripDropDown) |
| TabStop |
获取或设置一个值，该值指示用户能否使用 Tab 键为 ToolStrip 中的项提供焦点。 (继承自 ToolStrip) |
| Tag |
获取或设置包含有关控件的数据的对象。 (继承自 Control) |
| Text |
获取或设置与此控件关联的文本。 (继承自 Control) |
| TextDirection |
指定项上的文本绘制方向。 (继承自 ToolStripDropDown) |
| Top |
获取或设置控件上边缘与其容器的工作区上边缘之间的距离（以像素为单位）。 (继承自 Control) |
| TopLevel |
获取或设置一个值，该值指示 ToolStripDropDown 是否是一个顶级控件。 (继承自 ToolStripDropDown) |
| TopLevelControl |
获取没有另一个 Windows 窗体控件作为其父级的父控件。 通常，这是控件所在的最外面的 Form。 (继承自 Control) |
| TopMost |
获取或设置一个值，指示该窗体是否应显示为最顶层窗体。 (继承自 ToolStripDropDown) |
| UseWaitCursor |
获取或设置一个值，该值指示是否将等待光标用于当前控件以及所有子控件。 (继承自 Control) |
| VerticalScroll |
此属性与此类无关。 (继承自 ToolStrip) |
| Visible |
获取或设置一个值，该值指示 ToolStripDropDown 是否可见或隐藏。 (继承自 ToolStripDropDown) |
| VScroll |
获取或设置一个值，该值指示垂直滚动条是否可见。 (继承自 ScrollableControl) |
| Width |
获取或设置控件的宽度。 (继承自 Control) |
| WindowTarget |
此属性与此类无关。 (继承自 Control) |
方法
事件
显式接口实现
| IDropTarget.OnDragDrop(DragEventArgs) |
引发 DragDrop 事件。 (继承自 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引发 DragEnter 事件。 (继承自 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引发 DragLeave 事件。 (继承自 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引发 DragOver 事件。 (继承自 Control) |
