ToolBarButton Classe

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

public class ToolBarButton : System.ComponentModel.Component

type ToolBarButton = class
    inherit Component

Public Class ToolBarButton
Inherits Component

Héritage: Object

MarshalByRefObject

Component
ToolBarButton

Exemples

L’exemple de code suivant crée un ToolBar et trois ToolBarButton contrôles. Les boutons de la 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 est ToolBarButtonClickEventArgs évaluée et la boîte de dialogue appropriée est ouverte. Ce code nécessite qu’un Form OpenFileDialog, un , un SaveFileDialoget un PrintDialog aient 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 plutôt ToolStripButton.

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 le 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 d’image à la ImageIndex propriété du bouton .

Pour modifier l’apparence des boutons de la 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, leur 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 sur ToolBarAppearance.Normal, les boutons apparaissent en haut et en trois dimensions, et les séparateurs apparaissent sous la forme d’un espace entre les boutons.

Vous pouvez affecter un ContextMenu à un bouton si la propriété a la Style valeur ToolBarButtonStyle.DropDown. Lorsque vous cliquez sur le bouton, 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

ToolBarButton()	Initialise une nouvelle instance de la classe ToolBarButton.
ToolBarButton(String)	Initialise une nouvelle instance de la classe ToolBarButton et affiche le texte assigné au bouton.

Propriétés

CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
Container	Obtient le IContainer qui contient la Component. (Hérité de Component)
DesignMode	Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
DropDownMenu	Obtient ou définit le menu à afficher dans le bouton déroulant de la barre d'outils.
Enabled	Obtient ou définit une valeur indiquant si le bouton est activé.
Events	Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component)
ImageIndex	Obtient ou définit la valeur d'index de l'image assignée au bouton.
ImageKey	Obtient ou définit le nom de l'image assignée au bouton.
Name	Nom du bouton.
Parent	Obtient le contrôle de barre d'outils auquel le bouton de barre d'outils est assigné.
PartialPush	Obtient ou définit une valeur indiquant si un bouton de barre d'outils de style bascule fait partiellement l'objet d'un push.
Pushed	Obtient ou définit une valeur indiquant si un bouton de barre d'outils de style bascule fait l'objet d'un push.
Rectangle	Obtient le rectangle englobant d'un bouton de barre d'outils.
Site	Obtient ou définit le ISite de Component. (Hérité de Component)
Style	Obtient ou définit le style du bouton sur la barre d'outils.
Tag	Obtient ou définit l'objet qui contient les données relatives au bouton de la barre d'outils.
Text	Obtient ou définit le texte affiché sur le bouton de barre d'outils.
ToolTipText	Obtient ou définit le texte du bouton qui s'affiche sous la forme d'une info-bulle.
Visible	Obtient ou définit une valeur indiquant si le bouton est visible sur la barre d'outils.

Méthodes

CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par ToolBarButton et libère éventuellement les ressources managées.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetService(Type)	Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
ToString()	Retourne une chaîne qui représente le contrôle ToolBarButton.

Événements

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().

(Hérité de Component)

S’applique à

Partage via