Freigeben über

Vorgehensweise: Hinzufügen von Bereichen zu einem StatusBar-Steuerelement

  • Artikel

Wichtig

Die Steuerelemente StatusStrip und ToolStripStatusLabel ersetzen und ergänzen die Funktionalität der Steuerelemente StatusBar und StatusBarPanel. Die Steuerelemente StatusBar und StatusBarPanel werden jedoch sowohl für die Abwärtskompatibilität als auch für Ihre zukünftige Verwendung beibehalten.

Der programmierbare Bereich innerhalb eines StatusBar-Steuerelements besteht aus Instanzen der StatusBarPanel-Klasse. Diese werden durch Ergänzungen an der StatusBar.StatusBarPanelCollection-Klasse hinzugefügt.

So fügen Sie Panels auf einer Statusleiste hinzu

  1. Erstellen Sie in einer Prozedur Statusleistenpanels, indem Sie sie der StatusBar.StatusBarPanelCollection hinzufügen. Geben Sie Eigenschafteneinstellungen für einzelne Panels an. Verwenden Sie dabei den Index, der durch die Panels-Eigenschaft übergeben wird.

    Im folgenden Codebeispiel ist der Pfad, der für den Speicherort des Symbols festgelegt ist, der Ordner Eigene Dokumente. Dieser Speicherort wird verwendet, da Sie davon ausgehen können, dass die meisten Computer, auf denen das Betriebssystem Windows ausgeführt wird, über diesen Ordner verfügen. Durch die Auswahl dieses Speicherorts können auch Benutzer*innen mit minimalen Systemzugriffsebenen die Anwendung sicher ausführen. Das folgende Beispiel erfordert ein Formular, dem bereits ein StatusBar-Steuerelement hinzugefügt wurde.

    Hinweis

    Die StatusBar.StatusBarPanelCollection ist eine nullbasierte Auflistung, sodass Code entsprechend fortfahren sollte.

    Public Sub CreateStatusBarPanels()  
' Create panels and set text property.  
   StatusBar1.Panels.Add("One")  
   StatusBar1.Panels.Add("Two")  
   StatusBar1.Panels.Add("Three")  
' Set properties of StatusBar panels.  
' Set AutoSize property of panels.  
   StatusBar1.Panels(0).AutoSize = StatusBarPanelAutoSize.Spring  
   StatusBar1.Panels(1).AutoSize = StatusBarPanelAutoSize.Contents  
   StatusBar1.Panels(2).AutoSize = StatusBarPanelAutoSize.Contents  
' Set BorderStyle property of panels.  
   StatusBar1.Panels(0).BorderStyle = StatusBarPanelBorderStyle.Raised  
   StatusBar1.Panels(1).BorderStyle = StatusBarPanelBorderStyle.Sunken  
   StatusBar1.Panels(2).BorderStyle = StatusBarPanelBorderStyle.Raised  
' Set Icon property of third panel. You should replace the bolded  
' icon in the sample below with an icon of your own choosing.  
   StatusBar1.Panels(2).Icon = New _
   System.Drawing.Icon(System.Environment.GetFolderPath _  
   (System.Environment.SpecialFolder.Personal) _  
   & "\Icon.ico")  
   StatusBar1.ShowPanels = True  
End Sub  

    public void CreateStatusBarPanels()  
{  
   // Create panels and set text property.  
   statusBar1.Panels.Add("One");  
   statusBar1.Panels.Add("Two");  
   statusBar1.Panels.Add("Three");  
   // Set properties of StatusBar panels.  
   // Set AutoSize property of panels.  
   statusBar1.Panels[0].AutoSize = StatusBarPanelAutoSize.Spring;  
   statusBar1.Panels[1].AutoSize = StatusBarPanelAutoSize.Contents;  
   statusBar1.Panels[2].AutoSize = StatusBarPanelAutoSize.Contents;  
   // Set BorderStyle property of panels.  
   statusBar1.Panels[0].BorderStyle =  
      StatusBarPanelBorderStyle.Raised;  
   statusBar1.Panels[1].BorderStyle = StatusBarPanelBorderStyle.Sunken;  
   statusBar1.Panels[2].BorderStyle = StatusBarPanelBorderStyle.Raised;  
   // Set Icon property of third panel. You should replace the bolded  
   // icon in the sample below with an icon of your own choosing.  
   // Note the escape character used (@) when specifying the path.  
   statusBar1.Panels[2].Icon =
      new System.Drawing.Icon (System.Environment.GetFolderPath _  
   (System.Environment.SpecialFolder.Personal) _  
   + @"\Icon.ico");  
   statusBar1.ShowPanels = true;  
}  

    public:  
   void CreateStatusBarPanels()  
   {  
      // Create panels and set text property.  
      statusBar1->Panels->Add("One");  
      statusBar1->Panels->Add("Two");  
      statusBar1->Panels->Add("Three");  
      // Set properties of StatusBar panels.  
      // Set AutoSize property of panels.  
      statusBar1->Panels[0]->AutoSize =  
         StatusBarPanelAutoSize::Spring;  
      statusBar1->Panels[1]->AutoSize =  
         StatusBarPanelAutoSize::Contents;  
      statusBar1->Panels[2]->AutoSize =  
         StatusBarPanelAutoSize::Contents;  
      // Set BorderStyle property of panels.  
      statusBar1->Panels[0]->BorderStyle =  
         StatusBarPanelBorderStyle::Raised;  
      statusBar1->Panels[1]->BorderStyle =  
         StatusBarPanelBorderStyle::Sunken;  
      statusBar1->Panels[2]->BorderStyle =  
         StatusBarPanelBorderStyle::Raised;  
      // Set Icon property of third panel.  
      // You should replace the bolded image
      // in the sample below with an icon of your own choosing.  
      statusBar1->Panels[2]->Icon =  
         gcnew System::Drawing::Icon(String::Concat(  
         System::Environment::GetFolderPath(  
         System::Environment::SpecialFolder::Personal),  
         "\\Icon.ico"));  
      statusBar1->ShowPanels = true;  
   }

Weitere Informationen