StatusBar.StatusBarPanelCollection.Add 方法

  • 参考

定义

命名空间:
System.Windows.Forms
程序集:
System.Windows.Forms.dll

将 StatusBarPanel 添加到集合。

重载

Add(String)

向集合中添加包含指定文本的 StatusBarPanel。
Add(StatusBarPanel)

将 StatusBarPanel 添加到集合。

Add(String)

向集合中添加包含指定文本的 StatusBarPanel。

public:
 virtual System::Windows::Forms::StatusBarPanel ^ Add(System::String ^ text);
public virtual System.Windows.Forms.StatusBarPanel Add (string text);
abstract member Add : string -> System.Windows.Forms.StatusBarPanel
override this.Add : string -> System.Windows.Forms.StatusBarPanel
Public Overridable Function Add (text As String) As StatusBarPanel

参数

text
String

要添加的 StatusBarPanel 的文本。

返回

StatusBarPanel

一个 StatusBarPanel，它表示已添加到集合中的面板。

注解

可以将面板添加到 StatusBar 控件以显示多种信息类型。 此方法的Add此版本使用参数中指定的text文本创建一个新StatusBarPanel方法，并将其添加到集合中。 面板所在的 StatusBar.StatusBarPanelCollection 顺序表示在控件中 StatusBar 显示面板的顺序。 从左到右显示面板，从集合中的第一个面板开始。 控件 RightToLeft 的属性 StatusBar 不会更改面板显示在其中 StatusBar的顺序。 若要在集合中的特定位置插入面板，请使用 Insert 该方法。 若要在单个操作中向集合添加一组面板，请使用 AddRange 该方法。

另请参阅

适用于

Add(StatusBarPanel)

将 StatusBarPanel 添加到集合。

public:
 virtual int Add(System::Windows::Forms::StatusBarPanel ^ value);
public virtual int Add (System.Windows.Forms.StatusBarPanel value);
abstract member Add : System.Windows.Forms.StatusBarPanel -> int
override this.Add : System.Windows.Forms.StatusBarPanel -> int
Public Overridable Function Add (value As StatusBarPanel) As Integer

参数

value
StatusBarPanel

一个 StatusBarPanel，表示要向集合中添加的面板。

返回

Int32

集合中项的从零开始的索引。

例外

ArgumentNullException

要添加到集合中的 StatusBarPanel 为 null。

ArgumentException

value 参数中指定的 StatusBarPanel 的父级不为 null。

示例

下面的代码示例在窗体上创建一个控件，并添加两StatusBarPanel个StatusBar对象。 其中一 StatusBarPanel 个对象名为 panel1，显示应用程序的状态文本。 第二 StatusBarPanel个，命名 panel2，显示当前日期，并使用 ToolTipText 类的属性 StatusBarPanel 显示当前时间。 该示例使用ShowPanels该属性来确保显示面板而不是标准面板，并且该属性用于Panels访问Add将面板添加到StatusBar其中的方法StatusBar.StatusBarPanelCollection。 该示例还使用 AutoSize、BorderStyle和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 控件以显示多种信息类型。 此方法的Add此版本将参数中指定的value值添加到StatusBarPanel集合中。 面板所在的 StatusBar.StatusBarPanelCollection 顺序表示在控件中 StatusBar 显示面板的顺序。 从左到右显示面板，从集合中的第一个面板开始。 控件 RightToLeft 的属性 StatusBar 不会更改面板显示在其中 StatusBar的顺序。 若要在集合中的特定位置插入面板，请使用 Insert 该方法。 若要在单个操作中向集合添加一组面板，请使用 AddRange 该方法。

另请参阅

适用于