ToolBarButton Classe

Définition

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

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 FormOpenFileDialog, 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 à

Voir aussi