Classe ToolBarButton

ToolBarButton controles são pai por ToolBar controles. Propriedades comuns para conjunto após a criação de botão de barra de ferramentas são Text e ImageIndex. conjunto o Text propriedade do botão para exibir o texto abaixo ou à direita da imagem. Para atribuir imagens a botões, criando um ImageList, atribuindo-o para o ImageList propriedade da barra de ferramentas; em seguida, atribuir o valor de índice de imagem para o ImageIndex propriedade do botão.

Para alterar a aparência dos botões da barra de ferramentas atribuídos à barra de ferramentas, conjunto o Appearance propriedade do controle de barra de ferramentas do pai. The ToolBarAppearance.Flat aparência permite que os botões de uma aparência plana. Conforme o mouse, o ponteiro se move sobre botões, suas alterações de aparência tridimensional. Botão separadores aparecem sistema autônomo linhas, em vez de espaços entre sistema autônomo botões quando sistema autônomo botões têm uma aparência plana. Se o Appearance propriedade é conjunto para ToolBarAppearance.Normal, sistema autônomo botões aparecem elevado e tridimensionais e sistema autônomo separadores aparecem sistema autônomo uma lacuna entre sistema autônomo botões.

Você pode atribuir um ContextMenu para um botão se a Style propriedade estiver definida como ToolBarButtonStyle.DropDown. Quando o botão for clicado, o menu atribuído é exibido.

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

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ão, a coleção é atribuída à barra de ferramentas e a barra de ferramentas é adicionada ao formulário. Sobre o ButtonClick evento da barra de ferramentas, o Button propriedade das ToolBarButtonClickEventArgs é avaliada e abrir a caixa de diálogo apropriada. Esse código requer que um Form, um OpenFileDialog, um SaveFileDialoge um PrintDialog tudo foi criado.

publicvoid 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);
 }

 privatevoid 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; 
    }
 }

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Pocket PC

.NET Framework

.NET Compact Framework

Referência