StatusBar.StatusBarPanelCollection クラス

定義

StatusBar コントロール内のパネルのコレクションを表します。Represents the collection of panels in a StatusBar control.

public: ref class StatusBar::StatusBarPanelCollection : System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public class StatusBar.StatusBarPanelCollection : System.Collections.IList
public class StatusBar.StatusBarPanelCollection : System.Collections.IList
type StatusBar.StatusBarPanelCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
Public Class StatusBar.StatusBarPanelCollection
Implements IList
継承
StatusBar.StatusBarPanelCollection
属性
実装

次のコード例では、フォームに StatusBar コントロールを作成し、2つの StatusBarPanel オブジェクトを追加します。The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. panel1という名前の StatusBarPanelの1つは、アプリケーションのステータステキストを表示します。One of the StatusBarPanel, named panel1, displays status text for an application. 2番目の panel2StatusBarPanelは、現在の日付を表示し、StatusBarPanel クラスの ToolTipText プロパティを使用して現在の時刻を表示します。The second StatusBarPanel, named panel2, displays the current date and uses the ToolTipText property of the StatusBarPanel class to display the current time. この例では、ShowPanels プロパティを使用して、標準パネルではなくパネルが表示されるようにします。また、と Panels プロパティを使用して StatusBar.StatusBarPanelCollectionAdd メソッドにアクセスし、パネルを StatusBarに追加します。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. また、この例では、AutoSizeBorderStyleToolTipText、および 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.StatusBarPanelCollection クラスは、StatusBarに表示されるパネルを格納します。The StatusBar.StatusBarPanelCollection class stores the panels displayed in the StatusBar. コレクション内の各オブジェクトは、StatusBarに表示されるパネルの表示特性と動作を定義する StatusBarPanel クラスのインスタンスです。Each object in the collection is an instance of the StatusBarPanel class which defines the display characteristics and behaviors of a panel displayed in a StatusBar.

コレクションにパネルを追加するには、さまざまな方法があります。There are a number of ways to add panels to the collection. Add メソッドを使用すると、1つのパネルをコレクションに追加できます。The Add method provides the ability to add a single panel to the collection. 複数のパネルをコレクションに追加するには、StatusBarPanel オブジェクトの配列を作成し、AddRange メソッドに割り当てます。To add a number of panels to the collection, you create an array of StatusBarPanel objects and assign it to the AddRange method. コレクション内の特定の位置にパネルを挿入する場合は、Insert メソッドを使用できます。If you want to insert a panel at a specific location within the collection, you can use the Insert method. パネルを削除するには、Remove メソッドまたは RemoveAt メソッドを使用します (パネルがコレクション内に配置されている場所がわかっている場合)。To remove panels, you can use either the Remove method or the RemoveAt method if you know where the panel is located within the collection. Clear メソッドを使用すると、Remove メソッドを使用して一度に1つのパネルを削除する代わりに、コレクションからすべてのパネルを削除できます。The Clear method enables you to remove all panels from the collection instead of using the Remove method to remove a single panel at a time.

StatusBar.StatusBarPanelCollection には、パネルを追加および削除するためのメソッドとプロパティに加えて、コレクション内のパネルを検索するためのメソッドも用意されています。In addition to methods and properties for adding and removing panels, the StatusBar.StatusBarPanelCollection also provides methods to find panels within the collection. Contains メソッドを使用すると、パネルがコレクションのメンバーであるかどうかを判断できます。The Contains method enables you to determine whether a panel is a member of the collection. パネルがコレクション内にあることを確認したら、IndexOf メソッドを使用して、パネルがコレクション内に配置されている場所を確認できます。Once you know that the panel is located within the collection, you can use the IndexOf method to determine where the panel is located within the collection.

コンストラクター

StatusBar.StatusBarPanelCollection(StatusBar)

StatusBar.StatusBarPanelCollection クラスの新しいインスタンスを初期化します。Initializes a new instance of the StatusBar.StatusBarPanelCollection class.

プロパティ

Count

コレクションに含まれるアイテムの数を取得します。Gets the number of items in the collection.

IsReadOnly

このコレクションが読み取り専用かどうかを示す値を取得します。Gets a value indicating whether this collection is read-only.

Item[Int32]

指定されたインデックスの StatusBarPanel を取得または設定します。Gets or sets the StatusBarPanel at the specified index.

Item[String]

指定したキーを持つ項目をコレクションから取得します。Gets an item with the specified key from the collection.

メソッド

Add(StatusBarPanel)

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

Add(String)

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

AddRange(StatusBarPanel[])

コレクションに StatusBarPanel オブジェクトの配列を追加します。Adds an array of StatusBarPanel objects to the collection.

Clear()

すべてのアイテムをコレクションから削除します。Removes all items from the collection.

Contains(StatusBarPanel)

指定したパネルがコレクション内にあるかどうかを確認します。Determines whether the specified panel is located within the collection.

ContainsKey(String)

指定したキーの StatusBarPanel がコレクションに含まれているかどうかを確認します。Determines whether the collection contains a StatusBarPanel with the specified key.

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判定します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetEnumerator()

項目コレクションを反復処理するために使用する列挙子を返します。Returns an enumerator to use to iterate through the item collection.

GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
IndexOf(StatusBarPanel)

指定したパネルのコレクション内のインデックスを返します。Returns the index within the collection of the specified panel.

IndexOfKey(String)

指定したキーを持つ StatusBarPanel が最初に見つかった位置のインデックスを返します。Returns the index of the first occurrence of a StatusBarPanel with the specified key.

Insert(Int32, StatusBarPanel)

コレクション内の指定したインデックス位置に、指定した StatusBarPanel を挿入します。Inserts the specified StatusBarPanel into the collection at the specified index.

MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
Remove(StatusBarPanel)

指定した StatusBarPanel をコレクションから削除します。Removes the specified StatusBarPanel from the collection.

RemoveAt(Int32)

コレクション内の指定したインデックスにある StatusBarPanel を削除します。Removes the StatusBarPanel located at the specified index within the collection.

RemoveByKey(String)

指定したキーを持つ StatusBarPanel をコレクションから削除します。Removes the StatusBarPanel with the specified key from the collection.

ToString()

現在のオブジェクトを表す string を返します。Returns a string that represents the current object.

(継承元 Object)

明示的なインターフェイスの実装

ICollection.CopyTo(Array, Int32)

StatusBar.StatusBarPanelCollection を互換性のある 1 次元配列にコピーします。コピー操作は、コピー先の配列の指定したインデックスから始まります。Copies the StatusBar.StatusBarPanelCollection to a compatible one-dimensional array, starting at the specified index of the target array.

ICollection.IsSynchronized

コレクションへのアクセスが同期されるかどうか (スレッドセーフかどうか) を示す値を取得します。Gets a value indicating whether access to the collection is synchronized (thread safe).

ICollection.SyncRoot

コレクションへのアクセスを同期するためのオブジェクトを取得します。Gets an object that can be used to synchronize access to the collection.

IList.Add(Object)

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

IList.Contains(Object)

指定したパネルがコレクション内にあるかどうかを確認します。Determines whether the specified panel is located within the collection.

IList.IndexOf(Object)

コレクション内の指定したパネルのインデックスを返します。Returns the index of the specified panel within the collection.

IList.Insert(Int32, Object)

コレクション内の指定したインデックス位置に、指定した StatusBarPanel を挿入します。Inserts the specified StatusBarPanel into the collection at the specified index.

IList.IsFixedSize

コレクションが固定サイズかどうかを示す値を取得します。Gets a value indicating whether the collection has a fixed size.

IList.Item[Int32]

指定されたインデックス位置にある要素を取得または設定します。Gets or sets the element at the specified index.

IList.Remove(Object)

指定した StatusBarPanel をコレクションから削除します。Removes the specified StatusBarPanel from the collection.

拡張メソッド

Cast<TResult>(IEnumerable)

IEnumerable の要素を、指定した型にキャストします。Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

指定された型に基づいて IEnumerable の要素をフィルター処理します。Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

クエリの並列化を有効にします。Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerableIQueryable に変換します。Converts an IEnumerable to an IQueryable.

適用対象

こちらもご覧ください