StatusBar.Panels StatusBar.Panels StatusBar.Panels StatusBar.Panels Property

Definition

Ruft die im Steuerelement enthaltene Auflistung von StatusBar-Bereichen ab.Gets the collection of StatusBar panels contained within the control.

public:
 property System::Windows::Forms::StatusBar::StatusBarPanelCollection ^ Panels { System::Windows::Forms::StatusBar::StatusBarPanelCollection ^ get(); };
public System.Windows.Forms.StatusBar.StatusBarPanelCollection Panels { get; }
member this.Panels : System.Windows.Forms.StatusBar.StatusBarPanelCollection
Public ReadOnly Property Panels As StatusBar.StatusBarPanelCollection

Eigenschaftswert

Beispiele

Im folgenden Codebeispiel wird ein StatusBar -Steuerelement auf einem Formular erstellt StatusBarPanel und zwei-Objekte hinzugefügt.The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. Eines der- StatusBarPanel Objekte mit dem panel1Namen zeigt den Status Text für eine Anwendung an.One of the StatusBarPanel objects, named panel1, displays status text for an application. Das zweite StatusBarPanel Objekt namens panel2zeigt das aktuelle Datum an und StatusBarPanel verwendet die ToolTipText -Eigenschaft der-Klasse, um die aktuelle Uhrzeit anzuzeigen.The second StatusBarPanel object, named panel2, displays the current date and uses the ToolTipText property of the StatusBarPanel class to display the current time. Im Beispiel wird die ShowPanels -Eigenschaft verwendet, um sicherzustellen, dass die Panels anstelle eines Standard Bereichs angezeigt werden, und Panels die-Eigenschaft verwendet Add , um auf StatusBar.StatusBarPanelCollection die-Methode StatusBarder zuzugreifen, um die Panels hinzuzufügen.The example uses the ShowPanels property to ensure that the panels are displayed instead of a standard panel, and it uses and the Panels property to access the Add method of the StatusBar.StatusBarPanelCollection to add the panels to the StatusBar. Im Beispiel werden auch die AutoSizeEigenschaften BorderStyle, ToolTipText, und Text verwendet, um die StatusBarPanel -Objekte zu initialisieren.The example also uses the AutoSize, BorderStyle, ToolTipText, and Text properties to initialize the StatusBarPanel objects. Für dieses Beispiel ist es erforderlich, dass die im Beispiel definierte-Methode definiert und vom Konstruktor einer Formaufgerufen wird.This example requires that the method defined in the example is defined and called from the constructor of a Form.

private:
   void CreateMyStatusBar()
   {
      // Create a StatusBar control.
      StatusBar^ statusBar1 = gcnew StatusBar;

      // Create two StatusBarPanel objects to display in the StatusBar.
      StatusBarPanel^ panel1 = gcnew StatusBarPanel;
      StatusBarPanel^ panel2 = gcnew StatusBarPanel;

      // Display the first panel with a sunken border style.
      panel1->BorderStyle = StatusBarPanelBorderStyle::Sunken;

      // Initialize the text of the panel.
      panel1->Text = "Ready...";

      // Set the AutoSize property to use all remaining space on the StatusBar.
      panel1->AutoSize = StatusBarPanelAutoSize::Spring;

      // Display the second panel with a raised border style.
      panel2->BorderStyle = StatusBarPanelBorderStyle::Raised;

      // Create ToolTip text that displays the time the application
      // was started.
      panel2->ToolTipText = System::DateTime::Now.ToShortTimeString();

      // Set the text of the panel to the current date.
      panel2->Text = "Started: " + System::DateTime::Today.ToLongDateString();

      // Set the AutoSize property to size the panel to the size of the contents.
      panel2->AutoSize = StatusBarPanelAutoSize::Contents;

      // Display panels in the StatusBar control.
      statusBar1->ShowPanels = true;

      // Add both panels to the StatusBarPanelCollection of the StatusBar.   
      statusBar1->Panels->Add( panel1 );
      statusBar1->Panels->Add( panel2 );

      // Add the StatusBar to the form.
      this->Controls->Add( statusBar1 );
   }
private void CreateMyStatusBar()
{
    // Create a StatusBar control.
    StatusBar statusBar1 = new StatusBar();
    // Create two StatusBarPanel objects to display in the StatusBar.
    StatusBarPanel panel1 = new StatusBarPanel();
    StatusBarPanel panel2 = new StatusBarPanel();

    // Display the first panel with a sunken border style.
    panel1.BorderStyle = StatusBarPanelBorderStyle.Sunken;
    // Initialize the text of the panel.
    panel1.Text = "Ready...";
    // Set the AutoSize property to use all remaining space on the StatusBar.
    panel1.AutoSize = StatusBarPanelAutoSize.Spring;
    
    // Display the second panel with a raised border style.
    panel2.BorderStyle = StatusBarPanelBorderStyle.Raised;
    
    // Create ToolTip text that displays time the application was started.
    panel2.ToolTipText = "Started: " + System.DateTime.Now.ToShortTimeString();
    // Set the text of the panel to the current date.
    panel2.Text = System.DateTime.Today.ToLongDateString();
    // Set the AutoSize property to size the panel to the size of the contents.
    panel2.AutoSize = StatusBarPanelAutoSize.Contents;
                
    // Display panels in the StatusBar control.
    statusBar1.ShowPanels = true;

    // Add both panels to the StatusBarPanelCollection of the StatusBar.			
    statusBar1.Panels.Add(panel1);
    statusBar1.Panels.Add(panel2);

    // Add the StatusBar to the form.
    this.Controls.Add(statusBar1);
}
Private Sub CreateMyStatusBar()
   ' Create a StatusBar control.
   Dim statusBar1 As New StatusBar()

   ' Create two StatusBarPanel objects to display in the StatusBar.
   Dim panel1 As New StatusBarPanel()
   Dim panel2 As New StatusBarPanel()

   ' Display the first panel with a sunken border style.
   panel1.BorderStyle = StatusBarPanelBorderStyle.Sunken

   ' Initialize the text of the panel.
   panel1.Text = "Ready..."

   ' Set the AutoSize property to use all remaining space on the StatusBar.
   panel1.AutoSize = StatusBarPanelAutoSize.Spring
   
   ' Display the second panel with a raised border style.
   panel2.BorderStyle = StatusBarPanelBorderStyle.Raised
   
   ' Create ToolTip text that displays the time the application was started.
   panel2.ToolTipText = "Started: " & System.DateTime.Now.ToShortTimeString()

   ' Set the text of the panel to the current date.
   panel2.Text = System.DateTime.Today.ToLongDateString()

   ' Set the AutoSize property to size the panel to the size of the contents.
   panel2.AutoSize = StatusBarPanelAutoSize.Contents

   ' Display panels in the StatusBar control.
   statusBar1.ShowPanels = True

   ' Add both panels to the StatusBarPanelCollection of the StatusBar.			
   statusBar1.Panels.Add(panel1)
   statusBar1.Panels.Add(panel2)

   ' Add the StatusBar to the form.
   Me.Controls.Add(statusBar1)
End Sub

Hinweise

Das StatusBar -Steuerelement kann eine Reihe von Panels anzeigen, um dem Benutzer der Anwendung Informationen bereitzustellen.The StatusBar control can display a number of panels to provide information to the user of your application. Ein Panel könnte z. b. die aktuelle Uhrzeit oder den Fortschritt eines Dateidownloads anzeigen.For example, a panel could display the current time or the progress of a file download. Jeder Panel, der vom StatusBar -Steuerelement angezeigt wird, StatusBarPanel ist eine Instanz der-Klasse.Each panel displayed by the StatusBar control is an instance of the StatusBarPanel class. Mit Panels der-Eigenschaft können Sie einen Verweis auf die Auflistung von StatusBarPanel -Objekten abrufen, die derzeit im StatusBar -Steuerelement gespeichert sind.The Panels property enables you to obtain a reference to the collection of StatusBarPanel objects that are currently stored in the StatusBar control. Mit diesem Verweis können Sie Panels hinzufügen, Bereiche entfernen, auf einen bestimmten Bereich innerhalb der Auflistung zugreifen und die Anzahl der Panels im StatusBar Steuerelement abrufen.With this reference, you can add panels, remove panels, access a specific panel within the collection, and obtain a count of the panels in the StatusBar control. Weitere Informationen zu den Aufgaben, die mit der Panel-Auflistung ausgeführt werden können, finden StatusBar.StatusBarPanelCollection Sie in den Referenz Themen der-Klasse.For more information on the tasks that can be performed with the panel collection, see the StatusBar.StatusBarPanelCollection class reference topics.

Gilt für:

Siehe auch