StatusBar.StatusBarPanelCollection Класс

Определение

public: ref class StatusBar::StatusBarPanelCollection : System::Collections::IList

public class StatusBar.StatusBarPanelCollection : System.Collections.IList

[System.ComponentModel.ListBindable(false)]
public class StatusBar.StatusBarPanelCollection : System.Collections.IList

[System.ComponentModel.ListBindable(false)]
[System.ComponentModel.Browsable(false)]
[System.Obsolete("`StatusBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `StatusStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class StatusBar.StatusBarPanelCollection : System.Collections.IList

type StatusBar.StatusBarPanelCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

[<System.ComponentModel.ListBindable(false)>]
type StatusBar.StatusBarPanelCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

[<System.ComponentModel.ListBindable(false)>]
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`StatusBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `StatusStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type StatusBar.StatusBarPanelCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public Class StatusBar.StatusBarPanelCollection
Implements IList

Наследование

Object

StatusBar.StatusBarPanelCollection

Атрибуты

ListBindableAttribute BrowsableAttribute ObsoleteAttribute

Реализации

ICollection IEnumerable IList

Примеры

В следующем примере кода создается 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.StatusBarPanelCollection сохраняет панели, отображаемые в элементе StatusBar. Каждый объект в коллекции — это экземпляр StatusBarPanel класса, который определяет характеристики отображения и поведение панели, отображаемой в объекте StatusBar.

Существует несколько способов добавления панелей в коллекцию. Метод Add предоставляет возможность добавления одной панели в коллекцию. Чтобы добавить в коллекцию ряд панелей StatusBarPanel , создайте массив объектов и назначьте его методу AddRange . Если вы хотите вставить панель в определенном расположении в коллекции, можно использовать Insert этот метод. Чтобы удалить панели, можно использовать Remove метод или RemoveAt метод, если вы знаете, где находится панель в коллекции. Этот Clear метод позволяет удалять все панели из коллекции, а не использовать Remove метод для удаления одной панели одновременно.

Помимо методов и свойств для добавления и удаления панелей, также StatusBar.StatusBarPanelCollection предоставляются методы для поиска панелей в коллекции. Этот Contains метод позволяет определить, является ли панель членом коллекции. После того как вы знаете, что панель находится в коллекции, можно использовать IndexOf метод, чтобы определить, где находится панель в коллекции.

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

• StatusBarPanel