ToolBarButton Класс

Определение

public ref class ToolBarButton : System::ComponentModel::Component

public class ToolBarButton : System.ComponentModel.Component

type ToolBarButton = class
    inherit Component

Public Class ToolBarButton
Inherits Component

Наследование

Object

MarshalByRefObject

Component

ToolBarButton

Примеры

В следующем примере кода создаются ToolBar три ToolBarButton элемента управления и . Кнопки панели инструментов назначаются коллекции кнопок, коллекция назначается панели инструментов, а панель инструментов добавляется в форму. В событии 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 и более поздних версиях. Взамен рекомендуется использовать ToolStripButton.

ToolBarButton элементы управления являются родительскими элементами ToolBar управления. Общие свойства, которые следует задать после создания кнопки панели инструментов: Text и ImageIndex. Text Задайте свойство кнопки для отображения текста под изображением или справа от нее. Чтобы назначить изображения для кнопок, создав ImageList, назначьте его свойству ImageList панели инструментов, а затем назначьте значение ImageIndex индекса изображения свойству кнопки.

Чтобы изменить внешний вид кнопок панели инструментов, назначенных панели инструментов, задайте Appearance свойство родительского элемента управления панели инструментов. Внешний ToolBarAppearance.Flat вид придает кнопкам плоский вид. При наведении указателя мыши на кнопки их внешний вид изменяется на трехмерный. Разделители кнопок отображаются в виде линий, а не пробелов между кнопками, если кнопки имеют плоский вид. Если свойству Appearance присвоено значение ToolBarAppearance.Normal, кнопки отображаются как приподнятые и трехмерные, а разделители — как зазор между кнопками.

Вы можете назначить кнопке , ContextMenu если Style свойство имеет значение ToolBarButtonStyle.DropDown. При нажатии кнопки отображается назначенное меню.

Чтобы создать коллекцию ToolBarButton элементов управления для отображения в ToolBar, добавьте кнопки по отдельности Add с помощью метода Buttons свойства . Кроме того, можно добавить несколько кнопок панели инструментов с помощью AddRange метода .

Конструкторы

Свойства

Методы

События

Применяется к

См. также раздел

• ToolBar
• MenuItem
• ImageList
• ToolTip