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

範例

下列程式碼範例會在表單上建立 控制項，並新增兩 StatusBarPanel 個 StatusBar 物件。 名為 的第一個 StatusBarPanelpanel1 會顯示應用程式的狀態文字。 第二 StatusBarPanel 個名為 panel2 的 會顯示目前的日期，並使用 ToolTipText 類別的 StatusBarPanel 屬性來顯示目前的時間。 此範例會 ShowPanels 使用 屬性來確保顯示面板，而不是標準面板，並使用 Panels 屬性來存取 Add 的 方法 StatusBar.StatusBarPanelCollection ，將面板新增至 StatusBar 。 此範例也會使用 AutoSize 、 BorderStyleToolTipText 和 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.StatusBarPanelCollectionStatusBar 個別面板。 StatusBarPanel可以包含文字和/或圖示，可用來反映應用程式的狀態。 使用 可 StatusBar.StatusBarPanelCollection 透過 StatusBar.Panels 控制項的 StatusBar 屬性存取的 ，以擷取、新增或移除個別 StatusBarPanel 的 。

提供 StatusBarPanel 屬性，可讓您修改控制項內 StatusBar 面板的顯示行為。 您可以使用 Icon 屬性在面板中顯示圖示。 這個屬性可用來在應用程式中提供狀態的圖形標記法。 屬性 Alignment 可讓您指定文字和/或圖示在面板內對齊的方式。 若要確保您的面板已適當調整大小以符合面板的文字，您可以使用 AutoSize 屬性自動調整面板的大小，以符合面板的文字，或填滿控制項內的 StatusBar 剩餘空間。 屬性 MinWidth 可讓您指定面板的最小寬度，以確保其不會小於所要顯示的資料。

控制項 StatusBar 通常用來顯示應用程式的說明資訊或狀態資訊。 通常，請務必顯示面板中所呈現之資料的其他資訊。 每當滑鼠指標停留在面板上時，您可以使用 ToolTipText 屬性來顯示資訊。

StatusBar雖然控制項通常用來顯示文字資訊，但您也可以提供自己的顯示類型給 StatusBarPanel 。 屬性 Style 可讓您指定 繪製 的方式 StatusBarPanel 。 根據預設，如果屬性) 中指定的 Icon 屬性，則會 Style 使用 屬性來顯示內容 (和圖示的值 Text 。 如果 屬性設定為 OwnerDraw ，您可以將自己的資訊繪製到面板中。 您可以使用此功能在面板中繪製進度列或動畫圖標。

當您建立 類別的 StatusBarPanel 實例時，讀取/寫入屬性會設定為初始值。 如需這些值的清單，請參閱建 StatusBarPanel 構函式。

建構函式

屬性

方法

事件

適用於

另請參閱

• StatusBarPanel