StatusBar.StatusBarPanelCollection.Add メソッド

定義

StatusBarPanel をコレクションに追加します。Adds a StatusBarPanel to the collection.

オーバーロード

Add(String)

テキストが指定されている StatusBarPanel をコレクションに追加します。Adds a StatusBarPanel with the specified text to the collection.

Add(StatusBarPanel)

StatusBarPanel をコレクションに追加します。Adds a StatusBarPanel to the collection.

Add(String)

テキストが指定されている StatusBarPanel をコレクションに追加します。Adds a StatusBarPanel with the specified text to the collection.

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 のテキスト。The text for the StatusBarPanel that is being added.

戻り値

コレクションに追加されたパネルを表す StatusBarPanelA StatusBarPanel that represents the panel that was added to the collection.

注釈

コントロールにパネルを追加しStatusBarて、複数の種類の情報を表示できます。You can add panels to a StatusBar control to display more than one type of information. このバージョンのメソッドAddは、 textパラメーターでStatusBarPanel指定されたテキストを使用して新しいを作成し、コレクションに追加します。This version of the Add method creates a new StatusBarPanel with the text specified in the text parameter and adds it to collection. パネルが配置StatusBar.StatusBarPanelCollectionされる順序は、パネルがStatusBarコントロール内に表示される順序を表します。The order in which panels are located in the StatusBar.StatusBarPanelCollection represents the order that panels are displayed within the StatusBar control. パネルは、コレクションの最初のパネルから順に左から右に表示されます。Panels are displayed from left to right starting with the first panel in the collection. コントロールのプロパティは、 StatusBarにパネルが表示される順序を変更しません。 RightToLeft StatusBarThe RightToLeft property of the StatusBar control does not change the order in which panels are displayed in the StatusBar. パネルをコレクション内の特定の位置に挿入するには、 Insertメソッドを使用します。To insert a panel at a specific position in the collection, use the Insert method. 1回の操作で一連のパネルをコレクションに追加するには、 AddRangeメソッドを使用します。To add a set of panels to the collection in a single operation, use the AddRange method.

こちらもご覧ください

Add(StatusBarPanel)

StatusBarPanel をコレクションに追加します。Adds a StatusBarPanel to the collection.

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

コレクションに追加するパネルを表す StatusBarPanelA StatusBarPanel that represents the panel to add to the collection.

戻り値

コレクション内の項目の 0 から始まるインデックス番号。The zero-based index of the item in the collection.

例外

コレクションに追加しようとした StatusBarPanelnull でした。The StatusBarPanel being added to the collection was null.

value パラメーターで指定された StatusBarPanel の親が null ではありません。The parent of the StatusBarPanel specified in the value parameter is not null.

次のコード例ではStatusBar 、フォームにコントロールを作成しStatusBarPanel 、2つのオブジェクトを追加します。The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. という名前StatusBarPanel panel1のオブジェクトの1つは、アプリケーションのステータステキストを表示します。One of the StatusBarPanel objects, named panel1, displays status text for an application. 2番StatusBarPanelpanel2のは、 ToolTipText現在の日付を表示し、 StatusBarPanelクラスのプロパティを使用して現在の時刻を表示します。The second StatusBarPanel, named panel2, displays the current date and uses the ToolTipText property of the StatusBarPanel class to display the current time. この例ではShowPanels 、プロパティを使用して、標準パネルではなくパネルが表示されるようにPanelsStatusBarます。またAdd 、プロパティをStatusBar.StatusBarPanelCollection使用して、のメソッドにアクセスし、パネルをに追加します。The example uses the ShowPanels property to ensure that the panels are displayed instead of a standard panel, and it uses and the Panels property to access the Add method of the StatusBar.StatusBarPanelCollection to add the panels to the StatusBar. また、この例でAutoSizeBorderStyle ToolTipText、、、 Text 、およびの各StatusBarPanelプロパティを使用して、オブジェクトを初期化します。The example also uses the AutoSize, BorderStyle, ToolTipText, and Text properties to initialize the StatusBarPanel objects. この例では、例で定義されているメソッドが、 Formのコンストラクターから定義および呼び出されていることを前提としています。This example assumes that the method defined in the example is defined and called from the constructor of a 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て、複数の種類の情報を表示できます。You can add panels to a StatusBar control to display more than one type of information. このバージョンのメソッドAddは、 valueパラメーター StatusBarPanelに指定されたをコレクションに追加します。This version of the Add method adds the StatusBarPanel specified in the value parameter to the collection. パネルが配置StatusBar.StatusBarPanelCollectionされる順序は、パネルがStatusBarコントロール内に表示される順序を表します。The order in which panels are located in the StatusBar.StatusBarPanelCollection represents the order that panels are displayed within the StatusBar control. パネルは、コレクションの最初のパネルから順に左から右に表示されます。Panels are displayed from left to right starting with the first panel in the collection. コントロールのプロパティは、 StatusBarにパネルが表示される順序を変更しません。 RightToLeft StatusBarThe RightToLeft property of the StatusBar control does not change the order in which panels are displayed in the StatusBar. パネルをコレクション内の特定の位置に挿入するには、 Insertメソッドを使用します。To insert a panel at a specific position in the collection, use the Insert method. 1回の操作で一連のパネルをコレクションに追加するには、 AddRangeメソッドを使用します。To add a set of panels to the collection in a single operation, use the AddRange method.

こちらもご覧ください

適用対象