StatusBarPanel Класс

Определение

public ref class StatusBarPanel : System::ComponentModel::Component, System::ComponentModel::ISupportInitialize

public class StatusBarPanel : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

[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 StatusBarPanel : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

type StatusBarPanel = class
    inherit Component
    interface ISupportInitialize

[<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 StatusBarPanel = class
    inherit Component
    interface ISupportInitialize

Public Class StatusBarPanel
Inherits Component
Implements ISupportInitialize

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

Object

MarshalByRefObject

Component

StatusBarPanel

Атрибуты

BrowsableAttribute ObsoleteAttribute

Реализации

ISupportInitialize

Примеры

В следующем примере кода создается 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

Комментарии

Этот класс недоступен в .NET 5 и более поздних версиях. ToolStripStatusLabel Вместо этого используйте элемент управления.

Элемент управления StatusBarPanel представляет отдельную панель в StatusBar.StatusBarPanelCollection элементе StatusBar управления. Может StatusBarPanel содержать текст и(или) значок, который можно использовать для отражения состояния приложения. StatusBar.StatusBarPanelCollectionИспользуйте , доступный через StatusBar.Panels свойство StatusBar элемента управления, для извлечения, добавления или удаления отдельного пользователяStatusBarPanel.

Предоставляет StatusBarPanel свойства, позволяющие изменять поведение отображения панели в элементе StatusBar управления. Свойство можно использовать Icon для отображения значка на панели. Это свойство можно использовать для предоставления графического представления состояния в приложении. Свойство Alignment позволяет указать способ выравнивания текста и (или) значка на панели. Чтобы убедиться, что панель правильно соответствует тексту панели, можно использовать AutoSize свойство для автоматического изменения размера панели, чтобы поместить текст панели или заполнить оставшееся пространство в элементе StatusBar управления. Свойство MinWidth позволяет указать минимальную ширину панели, чтобы она не была меньше, чем данные, которые он должен отображать.

Элемент StatusBar управления обычно используется для отображения сведений справки или сведений о состоянии приложения. Часто важно отображать дополнительные сведения о данных, представленных на панели. Свойство можно использовать ToolTipText для отображения информации, когда указатель мыши находится на панели.

Хотя элемент StatusBar управления обычно используется для отображения текстовых сведений, вы также можете указать собственный тип отображения StatusBarPanel. Свойство Style позволяет указать способ StatusBarPanel рисования. По умолчанию Style свойство используется для отображения значения свойства (и значка Text , если указано в свойстве Icon ). Если для свойства задано OwnerDrawзначение, вы можете нарисовать собственные сведения на панели. Эту функцию можно использовать для рисования индикатора выполнения или анимированного значка на панели.

При создании экземпляра StatusBarPanel класса свойства чтения и записи задаются для начальных значений. Список этих значений см. в конструкторе StatusBarPanel .

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

• StatusBarPanel