共用方式為


StatusBar.Panels 屬性

定義

取得控制項中所包含的 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 物件。

範例

下列程式碼範例會在表單上建立控制項,並新增兩 StatusBarPanelStatusBar 物件。 StatusBarPanel其中一個名為 的物件 panel1 會顯示應用程式的狀態文字。 名為 的第二 StatusBarPanelpanel2 物件會顯示目前的日期,並使用 ToolTipText 類別的 StatusBarPanel 屬性來顯示目前時間。 此範例會使用 ShowPanels 屬性來確保面板會顯示,而不是標準面板,而且會使用 和 Panels 屬性來存取 Add 的 方法 StatusBar.StatusBarPanelCollection ,將面板新增至 StatusBar 。 此範例也會使用 AutoSizeBorderStyle ToolTipTextText 屬性來初始化 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 類別參考主題。

適用於

另請參閱