Questa documentazione è stata archiviata e non viene gestita.

Classe ToolBar

Aggiornamento: novembre 2007

Rappresenta una barra degli strumenti di Windows. Benché l'oggetto ToolStrip sostituisca il controllo ToolBar delle versioni precedenti aggiungendo funzionalità, l'oggetto ToolBar viene mantenuto per compatibilità con le versioni precedenti e per utilizzo futuro se lo si desidera.

Spazio dei nomi:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
public class ToolBar : Control
/** @attribute ComVisibleAttribute(true) */
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
public class ToolBar extends Control
public class ToolBar extends Control

I controlli ToolBar vengono utilizzati per visualizzare i controlli ToolBarButton che possono essere rappresentati come pulsanti standard, pulsanti interruttore o pulsanti a discesa. È possibile assegnare immagini ai pulsanti creando un oggetto ImageList, assegnandolo alla proprietà ImageList della barra degli strumenti e assegnando il valore di indice dell'immagine alla proprietà ImageIndex di ciascun controllo ToolBarButton . Inoltre, è possibile assegnare il testo da visualizzare al di sotto o a destra dell'immagine impostando la proprietà Text del controllo ToolBarButton.

Impostare la proprietà Appearance della barra degli strumenti su Flat per dare un aspetto privo di effetti alla barra degli strumenti e ai relativi pulsanti. I pulsanti assumono un aspetto tridimensionale quando il puntatore del mouse vi passa sopra. I pulsanti della barra degli strumenti possono essere suddivisi in gruppi logici tramite separatori. Un separatore è un pulsante della barra degli strumenti la cui proprietà Style è impostata su ToolBarButtonStyle.Separator. I separatori dei pulsanti vengono visualizzati come righe anziché come spazi tra i pulsanti quando la barra degli strumenti ha un aspetto privo di effetti. Se la proprietà Appearance è impostata su Normal, i pulsanti della barra degli strumenti verranno visualizzati con aspetto incassato e tridimensionale.

Se si specifica un valore per la proprietà ButtonSize, tutti i pulsanti presenti nella barra degli strumenti vengono limitati alla dimensione specificata. In caso contrario, la dimensione dei pulsanti viene regolata in base al contenuto e la proprietà ButtonSize restituisce la dimensione iniziale del pulsante più grande.

Per creare un insieme di controlli ToolBarButton da visualizzare nel controllo ToolBar, aggiungere i pulsanti individualmente utilizzando il metodo Add o il metodo Insert della proprietà Buttons.

Nota sulla piattaforma Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows CE:

Un form supporta solo un oggetto ToolBar. Se si tenta di aggiungere ulteriori oggetti ToolBar viene generata un'eccezione NotSupportedException. Non è supportata l'aggiunta di un oggetto ToolBar a controlli diversi da un form, quale Panel.

Nell'esempio di codice riportato di seguito vengono creati un oggetto ToolBar e tre controlli ToolBarButton. I pulsanti della barra degli strumenti sono assegnati all'insieme dei pulsanti, l'insieme alla barra degli strumenti e la barra viene aggiunta al form. Al verificarsi dell'evento ButtonClick della barra degli strumenti, viene valutata la proprietà Button di ToolBarButtonClickEventArgs e aperta la finestra di dialogo appropriata. Per eseguire questo esempio è necessario che siano stati creati un oggetto Form, un oggetto OpenFileDialog, un oggetto SaveFileDialog e un oggetto PrintDialog.

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; 
    }
 }



Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile per Pocket PC

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supportato in: 3.5, 2.0, 1.0
Mostra: