ToolBarButton Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ToolBarButton.cs

Attention

ToolBar is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use ToolStrip instead.

Représente un bouton de barre d’outils Windows.

Cette classe n’est pas disponible dans .NET Core 3.1 et versions ultérieures. Utilisez ToolStripButton à la place, qui remplace et étend le ToolBarButton contrôle.

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

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`ToolBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class ToolBarButton : System.ComponentModel.Component

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`ToolBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type ToolBarButton = class
    inherit Component

Public Class ToolBarButton
Inherits Component

Héritage

Object

MarshalByRefObject

Component

ToolBarButton

Attributs

BrowsableAttribute ObsoleteAttribute

Exemples

L’exemple de code suivant crée un ToolBar et trois ToolBarButton contrôles. Les boutons de barre d’outils sont affectés à la collection de boutons, la collection est affectée à la barre d’outils et la barre d’outils est ajoutée au formulaire. Dans l’événement ButtonClick de la barre d’outils, la Button propriété de l’objet ToolBarButtonClickEventArgs est évaluée et la boîte de dialogue appropriée s’ouvre. Ce code nécessite qu’un , un FormOpenFileDialog, un SaveFileDialog, et un ont PrintDialog tous été créés.

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

Remarques

Cette classe n’est pas disponible dans .NET Core 3.1 et versions ultérieures. Utilisez ToolStripButton à la place.

ToolBarButton les contrôles sont parentés par ToolBar des contrôles. Les propriétés courantes à définir une fois le bouton de barre d’outils créé sont Text et ImageIndex. Définissez la Text propriété du bouton pour afficher du texte sous ou à droite de l’image. Pour affecter des images aux boutons en créant un ImageList, en l’affectant à la ImageList propriété de la barre d’outils, puis affectez la valeur d’index de l’image à la ImageIndex propriété du bouton.

Pour modifier l’apparence des boutons de barre d’outils affectés à la barre d’outils, définissez la Appearance propriété du contrôle de barre d’outils parent. L’apparence ToolBarAppearance.Flat donne aux boutons une apparence plate. Lorsque le pointeur de la souris se déplace sur les boutons, son apparence passe à trois dimensions. Les séparateurs de boutons apparaissent sous forme de lignes plutôt que d’espaces entre les boutons lorsque les boutons ont une apparence plate. Si la Appearance propriété est définie ToolBarAppearance.Normalsur , les boutons apparaissent déclenchés et tridimensionnels, et les séparateurs apparaissent comme un écart entre les boutons.

Vous pouvez affecter un ContextMenu bouton si la Style propriété est définie sur ToolBarButtonStyle.DropDown. Lorsque le bouton est cliqué, le menu affecté s’affiche.

Pour créer une collection de ToolBarButton contrôles à afficher sur un ToolBar, ajoutez les boutons individuellement à l’aide de la Add méthode de la Buttons propriété. Vous pouvez également ajouter plusieurs boutons de barre d’outils à l’aide de la AddRange méthode.

Constructeurs

Nom	Description
ToolBarButton()	Obsolète. Initialise une nouvelle instance de la classe ToolBarButton.
ToolBarButton(String)	Obsolète. Initialise une nouvelle instance de la ToolBarButton classe et affiche le texte affecté sur le bouton.

Propriétés

Nom	Description
DropDownMenu	Obsolète. Obtient ou définit le menu à afficher dans le bouton de la barre d’outils déroulante.
Enabled	Obsolète. Obtient ou définit une valeur indiquant si le bouton est activé.
ImageIndex	Obsolète. Obtient ou définit la valeur d’index de l’image affectée au bouton.
ImageKey	Obsolète. Obtient ou définit le nom de l’image affectée au bouton.
Name	Obsolète. Nom du bouton.
Parent	Obsolète. Obtient le contrôle de barre d’outils auquel le bouton de barre d’outils est affecté.
PartialPush	Obsolète. Obtient ou définit une valeur indiquant si un bouton de barre d’outils de style bascule est partiellement poussé.
Pushed	Obsolète. Obtient ou définit une valeur indiquant si un bouton bascule-style de barre d’outils est actuellement à l’état push.
Rectangle	Obsolète. Obtient le rectangle englobant d’un bouton de barre d’outils.
Style	Obsolète. Obtient ou définit le style du bouton de barre d’outils.
Tag	Obsolète. Obtient ou définit l’objet qui contient des données sur le bouton de barre d’outils.
Text	Obsolète. Obtient ou définit le texte affiché sur le bouton de la barre d’outils.
ToolTipText	Obsolète. Obtient ou définit le texte qui apparaît sous forme d’info-bulle pour le bouton.
Visible	Obsolète. Obtient ou définit une valeur indiquant si le bouton de barre d’outils est visible.

Voir aussi

• ToolBar
• MenuItem
• ImageList
• ToolTip