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 assignés à la collection de boutons, la collection est assignée à la barre d’outils et la barre d’outils est ajoutée au formulaire. Sur l' ButtonClick événement de la barre d’outils, la Button propriété de ToolBarButtonClickEventArgs est évaluée et la boîte de dialogue appropriée s’ouvre. Ce code requiert la création d’un, d’un, d’un Form OpenFileDialog et d' SaveFileDialog un PrintDialog .

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 apparentés à des ToolBar contrôles. Les propriétés communes à définir une fois le bouton de la 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 assigner des images aux boutons en créant un ImageList , en l’assignant à la ImageList propriété de la barre d’outils, puis affecter la valeur d’index de l’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' ToolBarAppearance.Flat apparence 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 à deux dimensions. Si la Appearance propriété a la valeur ToolBarAppearance.Normal , les boutons apparaissent en relief et en trois dimensions, et les séparateurs apparaissent comme un intervalle entre les boutons.

Vous pouvez assigner un ContextMenu à un bouton si la Style propriété a la 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 Add de la 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