ToolStrip 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
为 Windows 工具栏对象提供容器。
public ref class ToolStrip : System::Windows::Forms::ScrollableControl, IDisposable
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class ToolStrip : System.Windows.Forms.ScrollableControl, IDisposable
public class ToolStrip : System.Windows.Forms.ScrollableControl, IDisposable
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ToolStrip = class
inherit ScrollableControl
interface IComponent
interface IDisposable
type ToolStrip = class
inherit ScrollableControl
interface IComponent
interface IDisposable
Public Class ToolStrip
Inherits ScrollableControl
Implements IDisposable
- 继承
- 派生
- 属性
- 实现
示例
下面的代码示例演示如何将 和 添加到 ToolStripContainer Windows 窗体、将项添加到 ToolStrip,以及将 添加到 ToolStripTopToolStripPanel 的 ToolStripContainer。ToolStrip
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
public class Form1 : Form
{
private ToolStripContainer toolStripContainer1;
private ToolStrip toolStrip1;
public Form1()
{
InitializeComponent();
}
[STAThread]
static void Main()
{
Application.EnableVisualStyles();
Application.Run(new Form1());
}
private void InitializeComponent()
{
toolStripContainer1 = new System.Windows.Forms.ToolStripContainer();
toolStrip1 = new System.Windows.Forms.ToolStrip();
// Add items to the 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);
// Add the ToolStripContainer to the form.
Controls.Add(toolStripContainer1);
}
}
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Data
Imports System.Drawing
Imports System.Text
Imports System.Windows.Forms
Public Class Form1
Inherits Form
Private toolStripContainer1 As ToolStripContainer
Private toolStrip1 As ToolStrip
Public Sub New()
InitializeComponent()
End Sub
<STAThread()> _
Shared Sub Main()
Application.EnableVisualStyles()
Application.Run(New Form1())
End Sub
Private Sub InitializeComponent()
toolStripContainer1 = New System.Windows.Forms.ToolStripContainer()
toolStrip1 = New System.Windows.Forms.ToolStrip()
' Add items to the 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)
' Add the ToolStripContainer to the form.
Controls.Add(toolStripContainer1)
End Sub
End Class
注解
ToolStrip 是 MenuStrip、StatusStrip 和 ContextMenuStrip 的基类。
在新的 Windows 窗体 应用程序中使用 ToolStrip 及其关联的类创建可具有 Windows、Office、Internet Explorer 或自定义外观和行为的工具栏,这些工具栏均带有或不包含主题,并支持溢出和运行时项重新排序。 ToolStrip 控件还提供丰富的设计时体验,包括就地激活和编辑、自定义布局以及共享指定 ToolStripContainer中的水平或垂直空间。
类 ToolStrip 提供了许多成员,用于管理绘制、鼠标和键盘输入以及拖放功能。 将 ToolStripRenderer 类与 类结合使用 ToolStripManager ,以获得对 Windows 窗体上所有 ToolStrip 控件的绘制和布局样式的更多控制和可自定义性。
以下项专门设计为在所有方向上无缝地与 ToolStripSystemRenderer 和 ToolStripProfessionalRenderer 配合工作。 默认情况下,它们在设计时可用于 ToolStrip 控件:
- ToolStripButton
- ToolStripSeparator
- ToolStripLabel
- ToolStripDropDownButton
- ToolStripSplitButton
- ToolStripTextBox
- ToolStripComboBox
可以联接 ToolStrip 指定 ToolStripContainer 中的控件,并相互合并 ToolStrip 控件。 将 ToolStripPanel 而不是 ToolStripContainer 用于 MDI) 应用程序的多文档接口 (。 通常, ToolStrip 不会参与 Tab 键顺序,除非它是绝对定位的,而不是停靠或 中的 ToolStripPanel。
ToolStripControlHost使用 类在 中ToolStrip承载任何其他Windows 窗体控件。
默认情况下,ToolStrip 会进行双缓冲(利用 OptimizedDoubleBuffer 设置)。
构造函数
ToolStrip() |
初始化 ToolStrip 类的新实例。 |
ToolStrip(ToolStripItem[]) |
用指定的 ToolStripItem 数组初始化 ToolStrip 类的一个新实例。 |
字段
ScrollStateAutoScrolling |
确定 AutoScroll 属性的值。 (继承自 ScrollableControl) |
ScrollStateFullDrag |
确定用户是否启用了全窗口拖动。 (继承自 ScrollableControl) |
ScrollStateHScrollVisible |
确定 HScroll 属性的值是否设置为 |
ScrollStateUserHasScrolled |
确定用户是否滚动了 ScrollableControl 控件。 (继承自 ScrollableControl) |
ScrollStateVScrollVisible |
确定 VScroll 属性的值是否设置为 |
属性
AccessibilityObject |
获取分配给该控件的 AccessibleObject。 (继承自 Control) |
AccessibleDefaultActionDescription |
获取或设置控件的默认操作说明以供具有辅助功能的客户端应用程序使用。 (继承自 Control) |
AccessibleDescription |
获取或设置辅助功能客户端应用程序使用的控件说明。 (继承自 Control) |
AccessibleName |
获取或设置辅助功能客户端应用程序所使用的控件名称。 (继承自 Control) |
AccessibleRole |
获取或设置控件的辅助性角色。 (继承自 Control) |
AllowClickThrough |
为 Windows 工具栏对象提供容器。 |
AllowDrop |
获取或设置一个值,该值指示是否通过你实现的事件来处理拖放和项重新排序。 |
AllowItemReorder |
获取或设置一个用于指示是否专门由 ToolStrip 类处理拖放和项重新排序操作的值。 |
AllowMerge |
获取或设置一个值,该值指示能否将多个 MenuStrip、ToolStripDropDownMenu、ToolStripMenuItem 及其他类型进行组合。 |
Anchor | |
AutoScroll |
此属性与此类无关。 |
AutoScrollMargin |
此属性与此类无关。 |
AutoScrollMinSize |
此属性与此类无关。 |
AutoScrollOffset |
获取或设置一个值,该值指示在 ScrollControlIntoView(Control) 中将控件滚动到何处。 (继承自 Control) |
AutoScrollPosition |
此属性与此类无关。 |
AutoSize |
获取或设置一个值,该值指示是否自动调整控件的大小以显示其完整内容。 |
BackColor |
获取或设置 ToolStrip 的背景色。 |
BackgroundImage |
获取或设置在控件中显示的背景图像。 (继承自 Control) |
BackgroundImageLayout |
获取或设置在 ImageLayout 枚举中定义的背景图像布局。 (继承自 Control) |
BindingContext |
获取或设置 ToolStrip 的绑定上下文。 |
Bottom |
获取控件下边缘与其容器的工作区上边缘之间的距离(以像素为单位)。 (继承自 Control) |
Bounds |
获取或设置控件(包括其非工作区元素)相对于其父控件的大小和位置(以像素为单位)。 (继承自 Control) |
CanEnableIme |
获取一个用以指示是否可以将 ImeMode 属性设置为活动值的值,以启用 IME 支持。 (继承自 Control) |
CanFocus |
获取一个值,该值指示控件是否可以接收焦点。 (继承自 Control) |
CanOverflow |
获取或设置一个值,该值指示是否可以将 ToolStrip 中的项发送到溢出菜单。 |
CanRaiseEvents |
确定是否可以在控件上引发事件。 (继承自 Control) |
CanSelect |
获取一个值,该值指示是否可以选中控件。 (继承自 Control) |
Capture |
获取或设置一个值,该值指示控件是否已捕获鼠标。 (继承自 Control) |
CausesValidation |
获取或设置一个值,该值指示 ToolStrip 是否会引起在任何需要在接收到焦点时执行验证的控件上执行验证。 |
ClientRectangle |
获取表示控件的工作区的矩形。 (继承自 Control) |
ClientSize |
获取或设置控件的工作区的高度和宽度。 (继承自 Control) |
CompanyName |
获取包含控件的应用程序的公司名称或创建者。 (继承自 Control) |
Container |
获取包含 IContainer 的 Component。 (继承自 Component) |
ContainsFocus |
获取一个值,该值指示控件或它的一个子控件当前是否有输入焦点。 (继承自 Control) |
ContextMenu |
获取或设置与控件关联的快捷菜单。 (继承自 Control) |
ContextMenuStrip |
获取或设置与此控件关联的 ContextMenuStrip。 (继承自 Control) |
Controls |
此属性与此类无关。 |
Created |
获取一个值,该值指示控件是否已经创建。 (继承自 Control) |
CreateParams |
获取创建控件句柄时所需要的创建参数。 (继承自 ScrollableControl) |
Cursor |
获取或设置当鼠标指针放置在 ToolStrip 上时显示的光标。 |
DataBindings |
为该控件获取数据绑定。 (继承自 Control) |
DataContext |
获取或设置用于数据绑定的数据上下文。 这是一个环境属性。 (继承自 Control) |
DefaultCursor |
获取或设置控件的默认光标。 (继承自 Control) |
DefaultDock |
获取 ToolStrip 的停靠位置,以指示哪些边框停靠到容器上。 |
DefaultDropDownDirection |
获取或设置一个值,该值表示 ToolStripDropDown 控件相对于 ToolStrip 的默认显示方向。 |
DefaultGripMargin |
获取大小调整手柄和 ToolStrip 的边缘之间的默认间距(以像素为单位)。 |
DefaultImeMode |
获取控件支持的默认输入法编辑器 (IME) 模式。 (继承自 Control) |
DefaultMargin |
获取 ToolStrip 与 ToolStripContainer 之间的间距(以像素为单位)。 |
DefaultMaximumSize |
获取以像素为单位的长度和高度,此长度和高度被指定为控件的默认最大大小。 (继承自 Control) |
DefaultMinimumSize |
获取以像素为单位的长度和高度,此长度和高度被指定为控件的默认最小大小。 (继承自 Control) |
DefaultPadding |
获取 ToolStrip 的内容的内部间距(以像素为单位)。 |
DefaultShowItemToolTips |
获取一个值,该值表示是否为 ToolStrip 默认显示工具提示。 |
DefaultSize |
获取 ToolStrip 的默认大小。 |
DesignMode |
获取一个值,用以指示 Component 当前是否处于设计模式。 (继承自 Component) |
DeviceDpi |
获取显示当前控件的显示设备的 DPI 值。 (继承自 Control) |
DisplayedItems | |
DisplayRectangle |
检索当前显示矩形。 |
Disposing |
获取一个值,该值指示 Control 基类是否在释放进程中。 (继承自 Control) |
Dock | |
DockPadding |
获取控件的所有边缘的停靠边距设置。 (继承自 ScrollableControl) |
DoubleBuffered |
获取或设置一个值,该值指示此控件是否应使用辅助缓冲区重绘其图面,以减少或避免闪烁。 (继承自 Control) |
Enabled |
获取或设置一个值,该值指示控件是否可以对用户交互作出响应。 (继承自 Control) |
Events |
获取附加到此 Component 的事件处理程序的列表。 (继承自 Component) |
Focused |
获取一个值,该值指示控件是否有输入焦点。 (继承自 Control) |
Font |
获取或设置用于显示控件中的文本的字体。 |
FontHeight |
获取或设置控件的字体的高度。 (继承自 Control) |
ForeColor |
获取或设置 ToolStrip 的前景色。 |
GripDisplayStyle |
获取 ToolStrip 移动手柄的方向。 |
GripMargin |
获取或设置 ToolStrip 移动手柄周围的空间。 |
GripRectangle |
获取 ToolStrip 移动手柄的边界。 |
GripStyle |
获取或设置 ToolStrip 移动手柄是可见还是隐藏。 |
Handle |
获取控件绑定到的窗口句柄。 (继承自 Control) |
HasChildren |
此属性与此类无关。 |
Height |
获取或设置控件的高度。 (继承自 Control) |
HorizontalScroll |
此属性与此类无关。 |
HScroll |
获取或设置一个值,该值指示水平滚动条是否可见。 (继承自 ScrollableControl) |
ImageList |
获取或设置包含 ToolStrip 项上显示的图像的图像列表。 |
ImageScalingSize |
获取或设置 ToolStrip 上所用图像的大小(以像素为单位)。 |
ImeMode |
获取或设置控件的输入法编辑器 (IME) 模式。 (继承自 Control) |
ImeModeBase |
获取或设置控件的 IME 模式。 (继承自 Control) |
InvokeRequired |
获取一个值,该值指示调用方在对控件进行方法调用时是否必须调用 Invoke 方法,因为调用方位于创建控件所在的线程以外的线程中。 (继承自 Control) |
IsAccessible |
获取或设置一个值,该值指示控件对辅助功能应用程序是否可见。 (继承自 Control) |
IsAncestorSiteInDesignMode |
指示此控件的上级之一是否位于 DesignMode 中。 此属性为只读。 (继承自 Control) |
IsCurrentlyDragging |
获取一个值,该值指示用户当前是否正在将 ToolStrip 从一个 ToolStripContainer 移到另一个。 |
IsDisposed |
获取一个值,该值指示控件是否已经被释放。 (继承自 Control) |
IsDropDown |
获取一个值,该值指示 ToolStrip 是否为 ToolStripDropDown 控件。 |
IsHandleCreated |
获取一个值,该值指示控件是否有与它关联的句柄。 (继承自 Control) |
IsMirrored |
获取一个值,该值指示此控件是否为镜像控件。 (继承自 Control) |
Items |
获取属于 ToolStrip 的所有项。 |
LayoutEngine |
将引用传递给由布局引擎接口返回的缓存 LayoutEngine。 |
LayoutSettings |
获取或设置布局方案特征。 |
LayoutStyle |
获取或设置一个值,该值指示 ToolStrip 如何对项集合进行布局。 |
Left |
获取或设置控件左边缘与其容器的工作区左边缘之间的距离(以像素为单位)。 (继承自 Control) |
Location |
获取或设置该控件的左上角相对于其容器的左上角的坐标。 (继承自 Control) |
Margin |
获取或设置控件之间的空间。 (继承自 Control) |
MaximumSize |
获取或设置大小,该大小是 GetPreferredSize(Size) 可以指定的上限。 (继承自 Control) |
MaxItemSize |
获取 ToolStrip 的最大高度和宽度,以像素为单位。 |
MinimumSize |
获取或设置大小,该大小是 GetPreferredSize(Size) 可以指定的下限。 (继承自 Control) |
Name |
获取或设置控件的名称。 (继承自 Control) |
Orientation |
获取 ToolStripPanel 的方向。 |
OverflowButton |
获取 ToolStripItem,它是启用了溢出的 ToolStrip 的“溢出”按钮。 |
Padding |
获取或设置控件内的空白。 (继承自 Control) |
Parent |
获取或设置控件的父容器。 (继承自 Control) |
PreferredSize |
获取可以容纳控件的矩形区域的大小。 (继承自 Control) |
ProductName |
获取包含控件的程序集的产品名称。 (继承自 Control) |
ProductVersion |
获取包含控件的程序集的版本。 (继承自 Control) |
RecreatingHandle |
获取一个值,该值指示控件当前是否在重新创建其句柄。 (继承自 Control) |
Region |
获取或设置与控件关联的窗口区域。 (继承自 Control) |
Renderer |
获取或设置用于自定义 ToolStripRenderer 的外观的 ToolStrip。 |
RenderMode |
获取或设置一个值,该值指示将把哪种视觉样式应用到 ToolStrip。 |
RenderRightToLeft |
已过时.
已过时.
此属性现已过时。 (继承自 Control) |
ResizeRedraw |
获取或设置一个值,该值指示控件在调整大小时是否重绘自己。 (继承自 Control) |
Right |
获取控件右边缘与其容器的工作区左边缘之间的距离(以像素为单位)。 (继承自 Control) |
RightToLeft |
获取或设置一个值,该值指示是否将控件的元素对齐以支持使用从右向左的字体的区域设置。 (继承自 Control) |
ScaleChildren |
获取一个值,该值确定子控件的缩放。 (继承自 Control) |
ShowFocusCues |
获取一个值,该值指示控件是否应显示聚焦框。 (继承自 Control) |
ShowItemToolTips |
获取或设置一个值,该值指示是否在 ToolStrip 项上显示工具提示。 |
ShowKeyboardCues |
获取一个值,该值指示用户界面是否处于适当的状态以显示或隐藏键盘快捷键。 (继承自 Control) |
Site |
获取或设置控件的站点。 (继承自 Control) |
Size |
获取或设置控件的高度和宽度。 (继承自 Control) |
Stretch |
获取或设置一个值,该值指示 ToolStrip 在 ToolStripContainer 中是否从一端拉伸到另一端。 |
TabIndex |
获取或设置控件在其容器内的 Tab 键顺序。 (继承自 Control) |
TabStop |
获取或设置一个值,该值指示用户能否使用 Tab 键为 ToolStrip 中的项提供焦点。 |
Tag |
获取或设置包含有关控件的数据的对象。 (继承自 Control) |
Text |
获取或设置与此控件关联的文本。 (继承自 Control) |
TextDirection |
获取或设置在 ToolStrip 上绘制文本的方向。 |
Top |
获取或设置控件上边缘与其容器的工作区上边缘之间的距离(以像素为单位)。 (继承自 Control) |
TopLevelControl |
获取没有另一个 Windows 窗体控件作为其父级的父控件。 通常,这是控件所在的最外面的 Form。 (继承自 Control) |
UseWaitCursor |
获取或设置一个值,该值指示是否将等待光标用于当前控件以及所有子控件。 (继承自 Control) |
VerticalScroll |
此属性与此类无关。 |
Visible |
获取或设置一个值,该值指示是否显示该控件及其所有子控件。 (继承自 Control) |
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) |
适用于
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈