StatusBar.Panels プロパティ

定義

コントロール内に格納されている StatusBar パネルのコレクションを取得します。Gets the collection of StatusBar panels contained within the control.

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 コントロールの StatusBarPanel オブジェクトを格納している StatusBarA StatusBar.StatusBarPanelCollection containing the StatusBarPanel objects of the StatusBar control.

次のコード例では、フォームに @no__t 0 コントロールを作成し、2つの StatusBarPanel オブジェクトを追加します。The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. @No__t-1 という @no__t 0 オブジェクトの1つに、アプリケーションのステータステキストが表示されます。One of the StatusBarPanel objects, named panel1, displays status text for an application. 2番目の @no__t 0 オブジェクト (panel2) は、現在の日付を表示し、StatusBarPanel クラスの ToolTipText プロパティを使用して現在の時刻を表示します。The second StatusBarPanel object, named panel2, displays the current date and uses the ToolTipText property of the StatusBarPanel class to display the current time. この例では、ShowPanels プロパティを使用して、標準パネルではなくパネルが表示されるようにします。また、と Panels プロパティを使用して、StatusBar.StatusBarPanelCollectionAdd メソッドにアクセスし、パネルを @no__t に追加します。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 の各プロパティを使用して、@no__t 4 のオブジェクトを初期化します。The example also uses the AutoSize, BorderStyle, ToolTipText, and Text properties to initialize the StatusBarPanel objects. この例では、例で定義されているメソッドが、Form のコンストラクターから定義され、呼び出される必要があります。This example requires 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

注釈

@No__t 0 コントロールには、アプリケーションのユーザーに情報を提供するためのさまざまなパネルが表示されます。The StatusBar control can display a number of panels to provide information to the user of your application. たとえば、パネルには、現在の時刻またはファイルのダウンロードの進行状況が表示されます。For example, a panel could display the current time or the progress of a file download. @No__t 0 コントロールによって表示される各パネルは、StatusBarPanel クラスのインスタンスです。Each panel displayed by the StatusBar control is an instance of the StatusBarPanel class. @No__t-0 プロパティを使用すると、StatusBar コントロールに現在格納されている @no__t 1 つのオブジェクトのコレクションへの参照を取得できます。The Panels property enables you to obtain a reference to the collection of StatusBarPanel objects that are currently stored in the StatusBar control. この参照を使用して、パネルを追加したり、パネルを削除したり、コレクション内の特定のパネルにアクセスしたり、@no__t 0 コントロール内のパネルの数を取得したりできます。With this reference, you can add panels, remove panels, access a specific panel within the collection, and obtain a count of the panels in the StatusBar control. パネルコレクションで実行できるタスクの詳細については、StatusBar.StatusBarPanelCollection クラスのリファレンストピックを参照してください。For more information on the tasks that can be performed with the panel collection, see the StatusBar.StatusBarPanelCollection class reference topics.

適用対象

こちらもご覧ください