ToolBarButton Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

ToolBarButton.cs

Внимание

ToolBar is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use ToolStrip instead.

Представляет кнопку панели инструментов Windows.

Этот класс недоступен в .NET Core 3.1 и более поздних версиях. Используйте ToolStripButton вместо этого, который заменяет и расширяет ToolBarButton элемент управления.

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

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`ToolBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class ToolBarButton : System.ComponentModel.Component

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`ToolBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type ToolBarButton = class
    inherit Component

Public Class ToolBarButton
Inherits Component

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

Object

MarshalByRefObject

Component

ToolBarButton

Атрибуты

BrowsableAttribute ObsoleteAttribute

Примеры

В следующем примере кода создается ToolBar и три ToolBarButton элемента управления. Кнопки панели инструментов назначаются коллекции кнопок, коллекция назначается панели инструментов, а панель инструментов добавляется в форму. ButtonClick На событии панели инструментов Button вычисляется свойство и ToolBarButtonClickEventArgs открывается соответствующее диалоговое окно. Для этого кода требуется, чтобы Formбыл создан объект , OpenFileDialoga 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, добавьте кнопки по отдельности Buttons с помощью Add метода свойства. Кроме того, можно добавить несколько кнопок панели инструментов с помощью AddRange метода.

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

Имя	Описание
ToolBarButton()	Устаревшие.. Инициализирует новый экземпляр класса ToolBarButton.
ToolBarButton(String)	Устаревшие.. Инициализирует новый экземпляр ToolBarButton класса и отображает назначенный текст на кнопке.

Свойства

Имя	Описание
DropDownMenu	Устаревшие.. Возвращает или задает меню, отображаемое в раскрывающемся списке на панели инструментов.
Enabled	Устаревшие.. Возвращает или задает значение, указывающее, включена ли кнопка.
ImageIndex	Устаревшие.. Возвращает или задает значение индекса изображения, назначенного кнопке.
ImageKey	Устаревшие.. Возвращает или задает имя изображения, назначенного кнопке.
Name	Устаревшие.. Имя кнопки.
Parent	Устаревшие.. Возвращает элемент управления панели инструментов, которому назначена кнопка панели инструментов.
PartialPush	Устаревшие.. Возвращает или задает значение, указывающее, была ли частично отложена кнопка панели инструментов в стиле переключателя.
Pushed	Устаревшие.. Возвращает или задает значение, указывающее, находится ли кнопка панели инструментов в стиле переключателя в настоящее время в состоянии принудительной передачи.
Rectangle	Устаревшие.. Получает ограничивающий прямоугольник для кнопки панели инструментов.
Style	Устаревшие.. Возвращает или задает стиль кнопки панели инструментов.
Tag	Устаревшие.. Возвращает или задает объект, содержащий данные о кнопке панели инструментов.
Text	Устаревшие.. Возвращает или задает текст, отображаемый на кнопке панели инструментов.
ToolTipText	Устаревшие.. Возвращает или задает текст, который отображается в виде подсказки для кнопки.
Visible	Устаревшие.. Возвращает или задает значение, указывающее, отображается ли кнопка панели инструментов.

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

• ToolBar
• MenuItem
• ImageList
• ToolTip