public ref class ToolBar : System::Windows::Forms::Control
public class ToolBar : System.Windows.Forms.Control
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class ToolBar : System.Windows.Forms.Control
type ToolBar = class
inherit Control
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ToolBar = class
inherit Control
Public Class ToolBar
Inherits Control
ToolBar
下面的代码示例创建 一个 和三
ToolBarButton
个
ToolBar
控件。 工具栏按钮分配给按钮集合，集合分配给工具栏，工具栏添加到窗体。 在
ButtonClick
工具栏的 事件中
Button
，计算 的
ToolBarButtonClickEventArgs
属性，并打开相应的对话框。 此代码要求
Form
已创建 、
OpenFileDialog
、
SaveFileDialog
、 和
PrintDialog
。
public:
void InitializeMyToolBar()
// Create and initialize the ToolBar and ToolBarButton controls.
toolBar1 = gcnew ToolBar;
ToolBarButton^ toolBarButton1 = gcnew ToolBarButton;
ToolBarButton^ toolBarButton2 = gcnew ToolBarButton;
ToolBarButton^ toolBarButton3 = gcnew ToolBarButton;
// Set the Text properties of the ToolBarButton controls.
toolBarButton1->Text = "Open";
toolBarButton2->Text = "Save";
toolBarButton3->Text = "Print";
// Add the ToolBarButton controls to the ToolBar.
toolBar1->Buttons->Add( toolBarButton1 );
toolBar1->Buttons->Add( toolBarButton2 );
toolBar1->Buttons->Add( toolBarButton3 );
// Add the event-handler delegate.
toolBar1->ButtonClick += gcnew ToolBarButtonClickEventHandler(
this, &Form1::toolBar1_ButtonClick );
// Add the ToolBar to the Form.
Controls->Add( toolBar1 );
private:
void toolBar1_ButtonClick(
Object^ sender,
ToolBarButtonClickEventArgs^ e )
// Evaluate the Button property to determine which button was clicked.
switch ( toolBar1->Buttons->IndexOf( e->Button ) )
case 0:
openFileDialog1->ShowDialog();
// Insert code to open the file.
break;
case 1:
saveFileDialog1->ShowDialog();
// Insert code to save the file.
break;
case 2:
printDialog1->ShowDialog();
// Insert code to print the file.
break;
public void InitializeMyToolBar()
// Create and initialize the ToolBar and ToolBarButton controls.
toolBar1 = new ToolBar();
ToolBarButton toolBarButton1 = new ToolBarButton();
ToolBarButton toolBarButton2 = new ToolBarButton();
ToolBarButton toolBarButton3 = new ToolBarButton();
// Set the Text properties of the ToolBarButton controls.
toolBarButton1.Text = "Open";
toolBarButton2.Text = "Save";
toolBarButton3.Text = "Print";
// Add the ToolBarButton controls to the ToolBar.
toolBar1.Buttons.Add(toolBarButton1);
toolBar1.Buttons.Add(toolBarButton2);
toolBar1.Buttons.Add(toolBarButton3);
// Add the event-handler delegate.
toolBar1.ButtonClick += new ToolBarButtonClickEventHandler (
this.toolBar1_ButtonClick);
// Add the ToolBar to the Form.
Controls.Add(toolBar1);
private void toolBar1_ButtonClick (
Object sender,
ToolBarButtonClickEventArgs e)
// Evaluate the Button property to determine which button was clicked.
switch(toolBar1.Buttons.IndexOf(e.Button))
case 0:
openFileDialog1.ShowDialog();
// Insert code to open the file.
break;
case 1:
saveFileDialog1.ShowDialog();
// Insert code to save the file.
break;
case 2:
printDialog1.ShowDialog();
// Insert code to print the file.
break;
Public Sub InitializeMyToolBar()
' Create and initialize the ToolBar and ToolBarButton controls.
Dim toolBar1 As New ToolBar()
Dim toolBarButton1 As New ToolBarButton()
Dim toolBarButton2 As New ToolBarButton()
Dim toolBarButton3 As New ToolBarButton()
' Set the Text properties of the ToolBarButton controls.
toolBarButton1.Text = "Open"
toolBarButton2.Text = "Save"
toolBarButton3.Text = "Print"
' Add the ToolBarButton controls to the ToolBar.
toolBar1.Buttons.Add(toolBarButton1)
toolBar1.Buttons.Add(toolBarButton2)
toolBar1.Buttons.Add(toolBarButton3)
' Add the event-handler delegate.
AddHandler toolBar1.ButtonClick, AddressOf Me.toolBar1_ButtonClick
' Add the ToolBar to the Form.
Controls.Add(toolBar1)
End Sub
Private Sub toolBar1_ButtonClick(ByVal sender As Object, _
ByVal e As ToolBarButtonClickEventArgs)
' Evaluate the Button property to determine which button was clicked.
Select Case toolBar1.Buttons.IndexOf(e.Button)
Case 0
openFileDialog1.ShowDialog()
' Insert code to open the file.
Case 1
saveFileDialog1.ShowDialog()
' Insert code to save the file.
Case 2
printDialog1.ShowDialog()
' Insert code to print the file.
End Select
End Sub
此类在 .NET Core 3.1 及更高版本中不可用。 请改用
ToolStrip
。
ToolBar
控件用于显示
ToolBarButton
可以显示为标准按钮、切换样式按钮或下拉样式按钮的控件。 可以通过创建 ，
ImageList
将
ImageList
图像分配给工具栏的 属性，并将图像索引值
ImageIndex
分配给每个
ToolBarButton
属性。 然后，可以通过设置
Text
的 属性
ToolBarButton
来分配要显示在图像下方或右侧的文本。
将
Appearance
工具栏的 属性设置为 ，
Flat
使工具栏及其按钮具有平面外观。 当鼠标指针在按钮上移动时，它们的外观将变为三维。 可使用分隔符将工具栏按钮划分成多个逻辑组。 分隔符是一个工具栏按钮，其中
Style
属性设置为
ToolBarButtonStyle.Separator
。 当工具栏具有平面外观时，按钮分隔符显示为线条，而不是按钮之间的空格。 如果 属性
Appearance
设置为
Normal
，则工具栏按钮显示为凸起和三维。
如果为
ButtonSize
属性指定值，则工具栏中的所有按钮都限制为指定大小。 否则，按钮会根据其内容调整其大小，并且
ButtonSize
属性返回最大按钮的初始大小。
若要创建要显示在 上的
ToolBar
控件的集合
ToolBarButton
，请使用
Add
属性的
Buttons
或
Insert
方法单独添加按钮。
