Gewusst wie: Definieren eines Symbols für eine Symbolleisten-Schaltfläche

Tipp

Obwohl das ToolStrip-Steuerelement das ToolBar-Steuerelement ersetzt und funktionell erweitert, wird das ToolBar-Steuerelement sowohl aus Gründen der Abwärtskompatibilität als auch, falls gewünscht, für die zukünftige Verwendung beibehalten.

Auf ToolBar-Schaltflächen können Symbole angezeigt werden, damit sie für die Benutzer leicht erkennbar sind. Hierzu werden der ImageList-Komponente (Windows Forms)-Komponente Bilder hinzugefügt. Anschließend wird die ImageList-Komponente dem ToolBar-Steuerelement zugewiesen.

So legen Sie ein Symbol für eine Symbolleisten-Schaltfläche programmgesteuert fest

  1. Instanziieren Sie in einer Prozedur eine ImageList-Komponente und ein ToolBar-Steuerelement.

  2. Weisen Sie der ImageList-Komponente in derselben Prozedur ein Bild zu.

  3. Weisen Sie in derselben Prozedur das ImageList-Steuerelement dem ToolBar-Steuerelement zu. Weisen Sie auch die ImageIndex-Eigenschaft der einzelnen Symbolleisten-Schaltflächen zu.

    Im folgenden Codebeispiel wurde als Speicherort für das Bild der Ordner Eigene Dateien festgelegt. Dieser Speicherort wird verwendet, weil vorausgesetzt werden kann, dass die meisten Computer mit einem Windows-Betriebssystem über dieses Verzeichnis verfügen. Dieser Speicherort ermöglicht es auch Benutzern mit minimalen Systemzugriffsberechtigungen, die Anwendung sicher auszuführen. Im unten stehenden Beispiel wird davon ausgegangen, dass einem Formular bereits ein PictureBox-Steuerelement hinzugefügt wurde.

    Den oben stehenden Schritten entsprechend sollte der von Ihnen geschriebene Code etwa wie folgt aussehen.

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

Siehe auch

Aufgaben

Gewusst wie: Auslösen von Menüereignissen für Symbolleisten-Schaltflächen

Referenz

ToolBar

Weitere Ressourcen

ToolBar-Steuerelement (Windows Forms)

ImageList-Komponente (Windows Forms)