ToolBarButton Classe

Definição

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

public class ToolBarButton : System.ComponentModel.Component

type ToolBarButton = class
    inherit Component

Public Class ToolBarButton
Inherits Component

Herança

Object

MarshalByRefObject

Component

ToolBarButton

Exemplos

O seguinte exemplo de código cria um ToolBar e três ToolBarButton controlos. Os botões da barra de ferramentas são atribuídos à coleção de botões, a coleção é atribuída à barra de ferramentas e a barra de ferramentas é adicionada ao formulário. No ButtonClick evento da barra de ferramentas, a Button propriedade do ToolBarButtonClickEventArgs é avaliada e a caixa de diálogo apropriada é aberta. Este código exige que a Form, an OpenFileDialog, a SaveFileDialog, e a PrintDialog tenham sido todos criados.

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

Observações

Esta classe não está disponível no .NET Core 3.1 e versões posteriores. Utilize ToolStripButton em substituição.

ToolBarButton Os controlos são parentados por ToolBar controlos. As propriedades comuns a definir depois de criar o botão da barra de ferramentas são Text e ImageIndex. Defina a Text propriedade do botão para mostrar texto abaixo ou à direita da imagem. Para atribuir imagens aos botões criando um ImageList, atribuindo-os à ImageList propriedade da barra de ferramentas; depois atribui o valor do índice da imagem à ImageIndex propriedade do botão.

Para alterar a aparência dos botões da barra de ferramentas atribuídos à barra de ferramentas, defina a Appearance propriedade do controlo da barra de ferramentas pai. A ToolBarAppearance.Flat aparência confere aos botões um aspeto plano. À medida que o ponteiro do rato se move sobre os botões, a sua aparência muda para tridimensional. Os separadores de botões aparecem como linhas em vez de espaços entre os botões quando estes têm uma aparência plana. Se a Appearance propriedade estiver definida para ToolBarAppearance.Normal, os botões aparecem em relevo e tridimensionais, e os separadores aparecem como um espaço entre os botões.

Pode atribuir a ContextMenu a a a se a Style propriedade estiver definida para ToolBarButtonStyle.DropDown. Quando o botão é clicado, o menu atribuído é exibido.

Para criar uma coleção de ToolBarButton controlos para mostrar num ToolBar, adicione os botões individualmente usando o Add método da Buttons propriedade. Em alternativa, pode adicionar vários botões na barra de ferramentas usando este AddRange método.

Ver também

• ToolBar
• MenuItem
• ImageList
• ToolTip