ToolBarButton Classe

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Representa um botão de barra de ferramentas do Windows.

Esta classe não está disponível no .NET Core 3.1 nem em versões posteriores. Em vez disso, use ToolStripButton , que substitui e estende o ToolBarButton controle .

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 exemplo de código a seguir cria um ToolBar e três ToolBarButton controles. 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. ButtonClick No evento da barra de ferramentas, a Button propriedade do ToolBarButtonClickEventArgs é avaliada e a caixa de diálogo apropriada é aberta. Esse código requer que um Form, um OpenFileDialog, um SaveFileDialoge um PrintDialog tenham sido 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

Comentários

Esta classe não está disponível no .NET Core 3.1 nem em versões posteriores. Use ToolStripButton em seu lugar.

ToolBarButton os controles são pai de ToolBar controles. As propriedades comuns a serem definidas depois que o botão da barra de ferramentas tiver sido criado são Text e ImageIndex. Defina a Text propriedade do botão para exibir o texto abaixo ou à direita da imagem. Para atribuir imagens aos botões criando um ImageList, atribuindo-o ImageList à propriedade da barra de ferramentas; em seguida, atribua o valor do índice de 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 controle da barra de ferramentas pai. A ToolBarAppearance.Flat aparência dá aos botões uma aparência plana. À medida que o ponteiro do mouse se move sobre os botões, sua aparência muda para tridimensional. Separadores de botão aparecem como linhas em vez de espaços entre os botões quando os botões têm uma aparência plana. Se a Appearance propriedade for definida ToolBarAppearance.Normalcomo , os botões aparecerão gerados e tridimensionais e os separadores aparecerão como uma lacuna entre os botões.

Você poderá atribuir um ContextMenu a um botão se a Style propriedade estiver definida ToolBarButtonStyle.DropDowncomo . Quando o botão é clicado, o menu atribuído é exibido.

Para criar uma coleção de ToolBarButton controles a serem exibidos em um ToolBar, adicione os botões individualmente usando o Add método da Buttons propriedade . Como alternativa, você pode adicionar vários botões da barra de ferramentas usando o AddRange método .

Construtores

ToolBarButton()

Inicializa uma nova instância da classe ToolBarButton.
ToolBarButton(String)

Inicializa uma nova instância da classe ToolBarButton e exibe o texto atribuído no botão.

Propriedades

CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.

(Herdado de Component)
Container

Obtém o IContainer que contém o Component.

(Herdado de Component)
DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.

(Herdado de Component)
DropDownMenu

Obtém ou define o menu a ser exibido no botão da lista suspensa de barra de ferramentas.
Enabled

Obtém ou define um valor que indica se o botão está habilitado.
Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.

(Herdado de Component)
ImageIndex

Obtém ou define o valor do índice da imagem atribuída ao botão.
ImageKey

Obtém ou define o nome da imagem atribuída ao botão.
Name

O nome do botão.
Parent

Obtém o controle de barra de ferramentas ao qual o botão de barra de ferramentas foi atribuído.
PartialPush

Obtém ou define um valor que indica se um botão de barra de ferramentas no estilo de alternância está parcialmente pressionado.
Pushed

Obtém ou define um valor que indica se um botão de barra de ferramentas no estilo de alternância está atualmente no estado pressionado.
Rectangle

Obtém o retângulo delimitador para um botão de barra de ferramentas.
Site

Obtém ou define o ISite do Component.

(Herdado de Component)
Style

Obtém ou define o estilo do botão de barra de ferramentas.
Tag

Obtém ou define o objeto que contém dados sobre o botão de barra de ferramentas.
Text

Obtém ou define o texto exibido no botão de barra de ferramentas.
ToolTipText

Obtém ou define o texto exibido como uma ToolTip para o botão.
Visible

Obtém ou define um valor que indica se o botão de barra de ferramentas está visível.

Métodos

CreateObjRef(Type)

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
Dispose()

Libera todos os recursos usados pelo Component.

(Herdado de Component)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo ToolBarButton e opcionalmente libera os recursos gerenciados.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetLifetimeService()
Obsoleto.

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.

(Herdado de MarshalByRefObject)
GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.

(Herdado de Component)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitializeLifetimeService()
Obsoleto.

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.

(Herdado de MarshalByRefObject)
ToString()

Retorna uma cadeia de caracteres que representa o controle ToolBarButton.

Eventos

Disposed

Ocorre quando o componente é disposto por uma chamada ao método Dispose().

(Herdado de Component)

Aplica-se a

Confira também