StatusBar.Panels Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает коллекцию панелей StatusBar, содержащихся в элементе управления.

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

Значение свойства

StatusBar.StatusBarPanelCollection

Объект StatusBar.StatusBarPanelCollection, содержащий объекты StatusBarPanel элемента управления StatusBar.

Примеры

В следующем примере кода создается StatusBar элемент управления в форме и добавляются два StatusBarPanel объекта. Один из StatusBarPanel объектов с именем panel1отображает текст состояния для приложения. StatusBarPanel Второй объект с именем panel2отображает текущую дату и использует ToolTipText свойство класса для отображения текущего StatusBarPanel времени. В примере используется ShowPanels свойство, чтобы убедиться, что панели отображаются вместо стандартной панели, а также используется свойство Panels для доступа Add к методу StatusBar.StatusBarPanelCollection добавления панелей.StatusBar В примере также используются AutoSizeсвойства , ToolTipTextBorderStyleи свойства для инициализации Text StatusBarPanel объектов. В этом примере требуется, чтобы метод, определенный в примере, был определен и вызывается из конструктора объекта 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

Комментарии

Элемент StatusBar управления может отображать ряд панелей для предоставления сведений пользователю приложения. Например, панель может отображать текущее время или ход скачивания файла. Каждая панель, отображаемая элементом StatusBar управления, является экземпляром StatusBarPanel класса. Свойство Panels позволяет получить ссылку на коллекцию StatusBarPanel объектов, которые в настоящее время хранятся в элементе StatusBar управления. С помощью этой ссылки можно добавлять панели, удалять панели, обращаться к определенной панели в коллекции и получать количество панелей в элементе StatusBar управления. Дополнительные сведения о задачах, которые можно выполнять с коллекцией панелей, см. в справочных разделах по классам StatusBar.StatusBarPanelCollection .

См. также раздел

• StatusBar.StatusBarPanelCollection
• StatusBarPanel