StatusBar.StatusBarPanelCollection クラス

[アーティクル]
03/28/2008

StatusBar コントロール内のパネルのコレクションを表します。

この型のすべてのメンバの一覧については、StatusBar.StatusBarPanelCollection メンバを参照してください。

System.Object
System.Windows.Forms.StatusBar.StatusBarPanelCollection

Public Class StatusBar.StatusBarPanelCollection
   Implements IList, ICollection, IEnumerable
[C#]
public class StatusBar.StatusBarPanelCollection : IList,
   ICollection, IEnumerable
[C++]
public __gc class StatusBar.StatusBarPanelCollection : public
   IList, ICollection, IEnumerable
[JScript]
public class StatusBar.StatusBarPanelCollection implements IList,
   ICollection, IEnumerable

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

StatusBar.StatusBarPanelCollection クラスは、 StatusBar に表示されるパネルを格納します。このコレクション内の各オブジェクトは、 StatusBar 内に表示されるパネルの表示特性と表示動作を定義する、StatusBarPanel クラスのインスタンスです。

パネルをコレクションに追加するには、いくつか方法があります。 Add メソッドを使用すると、単一のパネルをコレクションに追加できます。複数のパネルをコレクションに追加するには、 StatusBarPanel オブジェクトの配列を作成し、その配列を AddRange メソッドに割り当てます。コレクション内の特定の位置にパネルを挿入するには、 Insert メソッドを使用します。パネルを削除するには、 Remove メソッドか、コレクション内のパネルの位置が判明している場合は RemoveAt メソッドを使用できます。一度に 1 つのパネルしか削除できない Remove メソッドを使用する代わりに、 Clear メソッドを使用すると、コレクションからすべてのパネルを削除できます。

パネルを追加および削除するメソッドやプロパティのほかに、 StatusBar.StatusBarPanelCollection は、コレクション内でパネルを検索するメソッドも提供します。 Contains メソッドを使用すると、パネルがコレクションのメンバであるかどうかを確認できます。コレクション内にパネルがあることがわかれば、 IndexOf メソッドを使用して、そのパネルがコレクションのどこにあるかを判断できます。

使用例

[Visual Basic, C#, C++] フォームに StatusBar コントロールを作成し、2 つの StatusBarPanel オブジェクトを追加する例を次に示します。 StatusBarPanel オブジェクトの 1 つである panel1 は、アプリケーションのステータステキストを表示します。 panel2 という名前の 2 番目の StatusBarPanel オブジェクトは、現在の日付を表示し、 StatusBarPanel クラスの ToolTipText プロパティを使用して現在の時刻を表示します。この例では、標準パネルの代わりにこれらのパネルが表示されるようにするために ShowPanels プロパティを使用し、さらに Panels プロパティを使用して StatusBar.StatusBarPanelCollection の Add メソッドにアクセスして StatusBar にパネルを追加します。また、 StatusBarPanel オブジェクトを初期化するために、 AutoSize 、 BorderStyle 、 ToolTipText 、 Text の各プロパティも使用します。この例は、コード内で定義されたメソッドが定義されており、 Form のコンストラクタから呼び出されることを前提にしています。

 
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 current time.
   panel2.ToolTipText = 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

[C#] 
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 the current time.
    panel2.ToolTipText = 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);
}

[C++] 
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 = S"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 current time.
        panel2->ToolTipText = 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);
    }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

名前空間: System.Windows.Forms

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)

参照

StatusBar.StatusBarPanelCollection メンバ | System.Windows.Forms 名前空間 | StatusBarPanel

次の方法で共有

StatusBar.StatusBarPanelCollection クラス

スレッドセーフ

解説

使用例

必要条件

参照

その他のリソース