Freigeben über


StatusBar.Panels Eigenschaft

Definition

Ruft die im Steuerelement enthaltene Auflistung von StatusBar-Bereichen ab.

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

StatusBar.StatusBarPanelCollection

Eine StatusBar.StatusBarPanelCollection, die die StatusBarPanel-Objekte des StatusBar-Steuerelements enthält.

Beispiele

Im folgenden Codebeispiel wird ein StatusBar Steuerelement in einem Formular erstellt und zwei StatusBarPanel Objekte hinzugefügt. Eines der StatusBarPanel Objekte, benannt panel1, zeigt Statustext für eine Anwendung an. Das zweite StatusBarPanel Objekt mit dem Namen panel2zeigt das aktuelle Datum an und verwendet die ToolTipText Eigenschaft der StatusBarPanel Klasse, um die aktuelle Uhrzeit anzuzeigen. Im Beispiel wird die ShowPanels Eigenschaft verwendet, um sicherzustellen, dass die Panels anstelle eines Standardpanels angezeigt werden, und die Eigenschaft wird verwendet und die Panels Eigenschaft verwendet, um auf die Add Methode der StatusBar.StatusBarPanelCollection Panels zuzugreifen, um die Panels zu hinzufügen StatusBar. Im Beispiel werden auch die AutoSizeObjekte initialisiertStatusBarPanel, BorderStyleToolTipTextund Text die Eigenschaften werden verwendet. In diesem Beispiel muss die im Beispiel definierte Methode definiert und aus dem Konstruktor einer .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 Ihrer Anwendung Informationen bereitzustellen. Beispielsweise kann ein Panel die aktuelle Uhrzeit oder den Fortschritt eines Dateidownloads anzeigen. Jedes panel, das StatusBar vom Steuerelement angezeigt wird, ist eine Instanz der StatusBarPanel Klasse. Mit der Panels Eigenschaft können Sie einen Verweis auf die Auflistung von StatusBarPanel Objekten abrufen, die derzeit im StatusBar Steuerelement gespeichert sind. Mit diesem Verweis können Sie Panels hinzufügen, Panels entfernen, auf einen bestimmten Bereich in der Sammlung zugreifen und eine Anzahl der Panels im StatusBar Steuerelement abrufen. Weitere Informationen zu den Aufgaben, die mit der Panelsammlung ausgeführt werden können, finden Sie in den StatusBar.StatusBarPanelCollection Klassenreferenzthemen.

Gilt für

Siehe auch