ToolBarButton Класс

  • Ссылка

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

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

Этот класс недоступен в .NET Core 3.1 и более поздних версиях. Вместо него следует использовать класс ToolStripButton, который заменяет и расширяет элемент управления 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 метода .

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

ToolBarButton()

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

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

Свойства

CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.

(Унаследовано от Component)
Container

Возвращает объект IContainer, который содержит коллекцию Component.

(Унаследовано от Component)
DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.

(Унаследовано от Component)
DropDownMenu

Возвращает или задает меню, отображаемое кнопкой с раскрывающимся списком, находящейся в панели инструментов.
Enabled

Возвращает или задает значение, определяющее, доступна ли данная кнопка.
Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.

(Унаследовано от Component)
ImageIndex

Возвращает или задает значение индекса изображения, назначенного кнопке.
ImageKey

Возвращает или задает имя изображения, назначенного кнопке.
Name

Имя кнопки.
Parent

Возвращает элемент управления панели инструментов, которому назначена данная кнопка.
PartialPush

Возвращает или задает значение, показывающее, находится ли кнопка-переключатель в нейтральном положении.
Pushed

Возвращает или задает значение, указывающее, нажата ли в данный момент кнопка-переключатель.
Rectangle

Возвращает ограничивающий прямоугольник для кнопки панели инструментов.
Site

Получает или задает ISite объекта Component.

(Унаследовано от Component)
Style

Возвращает или задает стиль кнопки панели инструментов.
Tag

Возвращает или задает объект, содержащий данные, относящиеся к кнопке панели инструментов.
Text

Возвращает или задает текст, отображаемый на кнопке панели инструментов.
ToolTipText

Возвращает или задает текст всплывающей подсказки для кнопки.
Visible

Возвращает или задает значение, показывающее, является ли кнопка панели инструментов видимой.

Методы

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, занятые модулем Component.

(Унаследовано от Component)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом ToolBarButton, а при необходимости освобождает также управляемые ресурсы.
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetLifetimeService()
Устаревшие..

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.

(Унаследовано от MarshalByRefObject)
GetService(Type)

Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container.

(Унаследовано от Component)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
InitializeLifetimeService()
Устаревшие..

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.

(Унаследовано от MarshalByRefObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.

(Унаследовано от MarshalByRefObject)
ToString()

Возвращает строку, представляющую элемент управления ToolBarButton.

События

Disposed

Возникает при удалении компонента путем вызова метода Dispose().

(Унаследовано от Component)

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

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