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

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)

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

Поделиться через