StatusBar.Panels Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Źródło:

StatusBar.cs

Pobiera kolekcję paneli StatusBar zawartych w kontrolce.

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

Wartość właściwości

StatusBar.StatusBarPanelCollection

Obiekt StatusBar.StatusBarPanelCollection zawierający StatusBarPanel obiekty kontrolki StatusBar .

Przykłady

Poniższy przykład kodu tworzy kontrolkę StatusBar w formularzu i dodaje dwa StatusBarPanel obiekty. StatusBarPanel Jeden z obiektów o nazwie panel1wyświetla tekst stanu aplikacji. Drugi StatusBarPanel obiekt o nazwie panel2wyświetla bieżącą datę i używa ToolTipText właściwości StatusBarPanel klasy do wyświetlenia bieżącej godziny. W przykładzie ShowPanels użyto właściwości , aby upewnić się, że panele są wyświetlane zamiast panelu standardowego, i używa właściwości oraz Panels właściwości w celu uzyskania dostępu do Add metody StatusBar.StatusBarPanelCollection w celu dodania paneli do obiektu StatusBar. W przykładzie użyto AutoSizerównież właściwości , BorderStyle, ToolTipTexti Text do zainicjowania StatusBarPanel obiektów. Ten przykład wymaga, aby metoda zdefiniowana w przykładzie została zdefiniowana i wywołana z konstruktora Formklasy .

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

Uwagi

Kontrolka StatusBar może wyświetlać wiele paneli w celu udostępnienia informacji użytkownikowi aplikacji. Na przykład panel może wyświetlić bieżący czas lub postęp pobierania pliku. Każdy panel wyświetlany przez kontrolkę StatusBar jest wystąpieniem StatusBarPanel klasy. Właściwość Panels umożliwia uzyskanie odwołania do kolekcji StatusBarPanel obiektów, które są obecnie przechowywane w kontrolce StatusBar . Dzięki temu odwołaniu można dodawać panele, usuwać panele, uzyskiwać dostęp do określonego panelu w kolekcji i uzyskiwać liczbę paneli w kontrolce StatusBar . Aby uzyskać więcej informacji na temat zadań, które można wykonać za pomocą kolekcji paneli, zobacz StatusBar.StatusBarPanelCollection tematy referencyjne dotyczące klas.

Zobacz też

• StatusBar.StatusBarPanelCollection
• StatusBarPanel