ToolBarButton Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un pulsante della barra degli strumenti di Windows.

Questa classe non è disponibile in .NET Core 3.1 e versioni successive. Utilizzare ToolStripButton invece , che sostituisce ed estende il ToolBarButton controllo .

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

public class ToolBarButton : System.ComponentModel.Component

type ToolBarButton = class
    inherit Component

Public Class ToolBarButton
Inherits Component

Ereditarietà: Object

MarshalByRefObject

Component
ToolBarButton

Esempio

Nell'esempio di codice seguente vengono creati e ToolBar tre ToolBarButton controlli . I pulsanti della barra degli strumenti vengono assegnati all'insieme di pulsanti, l'insieme viene assegnato alla barra degli strumenti e la barra degli strumenti viene aggiunta al modulo. Nell'evento ButtonClick della barra degli strumenti, la Button proprietà di ToolBarButtonClickEventArgs viene valutata e viene aperta la finestra di dialogo appropriata. Questo codice richiede che sia stato creato un Formoggetto , OpenFileDialogun SaveFileDialogoggetto e 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

Commenti

Questa classe non è disponibile in .NET Core 3.1 e versioni successive. In alternativa, utilizzare ToolStripButton.

ToolBarButton i controlli sono padre dei ToolBar controlli. Proprietà comuni da impostare dopo la creazione del pulsante della barra degli strumenti e Text ImageIndex. Impostare la Text proprietà del pulsante per visualizzare il testo sotto o a destra dell'immagine. Per assegnare immagini ai pulsanti creando un ImageListoggetto , assegnandolo alla ImageList proprietà della barra degli strumenti, quindi assegnare il valore di indice dell'immagine alla ImageIndex proprietà del pulsante.

Per modificare l'aspetto dei pulsanti della barra degli strumenti assegnati alla barra degli strumenti, impostare la Appearance proprietà del controllo della barra degli strumenti padre. L'aspetto ToolBarAppearance.Flat dà ai pulsanti un aspetto piatto. Quando il puntatore del mouse si sposta sui pulsanti, l'aspetto cambia in tridimensionale. I separatori dei pulsanti vengono visualizzati come linee anziché spazi tra i pulsanti quando i pulsanti hanno un aspetto piatto. Se la Appearance proprietà è impostata su ToolBarAppearance.Normal, i pulsanti vengono visualizzati in rilievo e tridimensionali e i separatori vengono visualizzati come distanza tra i pulsanti.

È possibile assegnare un ContextMenu oggetto a un pulsante se la Style proprietà è impostata su ToolBarButtonStyle.DropDown. Quando si fa clic sul pulsante, viene visualizzato il menu assegnato.

Per creare una raccolta di ToolBarButton controlli da visualizzare in un ToolBaroggetto , aggiungere i pulsanti singolarmente usando il Add metodo della Buttons proprietà . In alternativa, è possibile aggiungere diversi pulsanti della barra degli strumenti usando il AddRange metodo .

Costruttori

ToolBarButton()	Inizializza una nuova istanza della classe ToolBarButton.
ToolBarButton(String)	Inizializza una nuova istanza della classe ToolBarButton nella quale è visualizzato il testo assegnato al pulsante.

Proprietà

CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
DesignMode	Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
DropDownMenu	Ottiene o imposta il menu da visualizzare nel pulsante a discesa della barra degli strumenti.
Enabled	Ottiene o imposta un valore che indica se il pulsante è abilitato.
Events	Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
ImageIndex	Ottiene o imposta il valore di indice dell'immagine assegnata al pulsante.
ImageKey	Ottiene o imposta il nome dell'immagine assegnata al pulsante.
Name	Nome del pulsante.
Parent	Ottiene il controllo barra degli strumenti a cui è assegnato il pulsante.
PartialPush	Ottiene o imposta un valore che indica se un pulsante interruttore è parzialmente premuto.
Pushed	Ottiene o imposta un valore che indica se un pulsante interruttore della barra degli strumenti è premuto.
Rectangle	Ottiene il rettangolo di delimitazione di un pulsante della barra degli strumenti.
Site	Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)
Style	Ottiene o imposta lo stile del pulsante della barra degli strumenti.
Tag	Ottiene o imposta l'oggetto che contiene i dati relativi al pulsante della barra degli strumenti.
Text	Ottiene o imposta il testo visualizzato sul pulsante della barra degli strumenti.
ToolTipText	Ottiene o imposta il testo visualizzato come descrizione comandi di un pulsante.
Visible	Ottiene o imposta un valore che indica se il pulsante della barra degli strumenti è visibile.

Metodi

CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate da ToolBarButton e, facoltativamente, le risorse gestite.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleti. Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetService(Type)	Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
ToString()	Restituisce una stringa che rappresenta il controllo ToolBarButton.

Eventi

Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().

(Ereditato da Component)

Si applica a

Condividi tramite