ToolBarButton Classe

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Partilhar via