StatusBarPanel 类

定义

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

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

type StatusBarPanel = class
    inherit Component
    interface ISupportInitialize

Public Class StatusBarPanel
Inherits Component
Implements ISupportInitialize

继承

Object

MarshalByRefObject

Component

StatusBarPanel

实现

ISupportInitialize

示例

下面的代码示例在窗体上创建控件 StatusBar 并添加两 StatusBarPanel 个 对象。 名为 的第一个 StatusBarPanelpanel1显示应用程序的状态文本。 名为 的第二 StatusBarPanel个 panel2显示当前日期，并使用 ToolTipText 类的 StatusBarPanel 属性显示当前时间。 该示例使用 ShowPanels 属性来确保显示面板而不是标准面板，并使用 Panels 属性访问 Add 的 StatusBar.StatusBarPanelCollection 方法，将面板添加到 StatusBar。 该示例还使用 AutoSize、 BorderStyle、 ToolTipText和 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