Procedura: definire un'icona per un pulsante ToolBarHow to: Define an Icon for a ToolBar Button

Nota

Benché il controllo ToolStrip sostituisca il controllo ToolBar aggiungendovi funzionalità, il controllo ToolBar viene mantenuto per compatibilità con le versioni precedenti e per un eventuale uso futuro.The ToolStrip control replaces and adds functionality to the ToolBar control; however, the ToolBar control is retained for both backward compatibility and future use, if you choose.

ToolBar i pulsanti sono in grado di visualizzare icone all'interno di essi per semplificarne l'identificazione da parte degli utenti.ToolBar buttons are able to display icons within them for easy identification by users. Questo risultato viene ottenuto tramite l'aggiunta di immagini per il componente ImageList componente e quindi associando il ImageList componente con il ToolBar controllo.This is achieved through adding images to the ImageList Component component and then associating the ImageList component with the ToolBar control.

Per impostare un'icona per un pulsante della barra degli strumenti a livello di codiceTo set an icon for a toolbar button programmatically

  1. In una routine, creare un'istanza di un ImageList componente e un ToolBar controllo.In a procedure, instantiate an ImageList component and a ToolBar control.

  2. Nella stessa stored procedure, assegnare un'immagine per il ImageList componente.In the same procedure, assign an image to the ImageList component.

  3. Nella stessa stored procedure, assegnare il ImageList controllo il ToolBar controllare e assegnare il ImageIndex proprietà dei pulsanti della barra degli strumenti singoli.In the same procedure, assign the ImageList control to the ToolBar control and assign the ImageIndex property of the individual toolbar buttons.

    Nell'esempio di codice riportato di seguito, il percorso impostato per la posizione dell'immagine è il documenti cartella.In the following code example, the path set for the location of the image is the My Documents folder. Ciò accade in quanto è possibile presupporre che la maggior parte dei computer che eseguono il sistema operativo Windows includerà questa directory.This is done, because you can assume that most computers running the Windows operating system will include this directory. Ciò consente inoltre agli utenti del sistema con livelli di accesso minimo di eseguire l'applicazione senza problemi.This also allows users with minimal system access levels to safely run the application. Nell'esempio seguente si presuppone un form con un PictureBox controllo già aggiunto.The example below assumes a form with a PictureBox control already added.

    Seguendo i passaggi precedenti, consente di scrivere codice simile a quello riportato di seguito.Following the steps above, you should have written code similar to that displayed below.

    Public Sub InitializeMyToolBar()  
    ' Instantiate an ImageList component and a ToolBar control.  
       Dim ToolBar1 as New ToolBar  
       Dim ImageList1 as New ImageList  
    ' Assign an image to the ImageList component.  
    ' You should replace the bold image  
    ' in the sample below with an icon of your own choosing.  
       Dim myImage As System.Drawing.Image = _   
          Image.FromFile Image.FromFile _  
          (System.Environment.GetFolderPath _  
          (System.Environment.SpecialFolder.Personal) _  
          & "\Image.gif")  
       ImageList1.Images.Add(myImage)  
    ' Create a ToolBarButton.  
       Dim ToolBarButton1 As New ToolBarButton()  
    ' Add the ToolBarButton to the ToolBar.  
       ToolBar1.Buttons.Add(toolBarButton1)  
    ' Assign an ImageList to the ToolBar.  
       ToolBar1.ImageList = ImageList1  
    ' Assign the ImageIndex property of the ToolBarButton.  
       ToolBarButton1.ImageIndex = 0  
    End Sub  
    
    public void InitializeMyToolBar()  
    {  
       // Instantiate an ImageList component and a ToolBar control.  
       ToolBar toolBar1 = new  ToolBar();   
       ImageList imageList1 = new ImageList();  
       // Assign an image to the ImageList component.  
       // You should replace the bold image   
       // in the sample below with an icon of your own choosing.  
       // Note the escape character used (@) when specifying the path.  
       Image myImage = Image.FromFile  
       (System.Environment.GetFolderPath  
       (System.Environment.SpecialFolder.Personal)  
       + @"\Image.gif");  
       imageList1.Images.Add(myImage);  
       // Create a ToolBarButton.  
       ToolBarButton toolBarButton1 = new ToolBarButton();  
       // Add the ToolBarButton to the ToolBar.  
       toolBar1.Buttons.Add(toolBarButton1);  
       // Assign an ImageList to the ToolBar.  
       toolBar1.ImageList = imageList1;  
       // Assign ImageIndex property of the ToolBarButton.  
       toolBarButton1.ImageIndex = 0;  
    }  
    
    public:  
       void InitializeMyToolBar()  
       {  
          // Instantiate an ImageList component and a ToolBar control.  
          ToolBar ^ toolBar1 = gcnew  ToolBar();   
          ImageList ^ imageList1 = gcnew ImageList();  
          // Assign an image to the ImageList component.  
          // You should replace the bold image   
          // in the sample below with an icon of your own choosing.  
          Image ^ myImage = Image::FromFile(String::Concat  
             (System::Environment::GetFolderPath  
             (System::Environment::SpecialFolder::Personal),  
             "\\Image.gif"));  
          imageList1->Images->Add(myImage);  
          // Create a ToolBarButton.  
          ToolBarButton ^ toolBarButton1 = gcnew ToolBarButton();  
          // Add the ToolBarButton to the ToolBar.  
          toolBar1->Buttons->Add(toolBarButton1);  
          // Assign an ImageList to the ToolBar.  
          toolBar1->ImageList = imageList1;  
          // Assign ImageIndex property of the ToolBarButton.  
          toolBarButton1->ImageIndex = 0;  
       }  
    

Vedere ancheSee Also

ToolBar
Procedura: Attivare eventi di menu per i pulsanti di una barra degli strumentiHow to: Trigger Menu Events for Toolbar Buttons
Controllo ToolBarToolBar Control
Componente ImageListImageList Component