StatusBar.Panels StatusBar.Panels StatusBar.Panels StatusBar.Panels Property

定義

コントロール内に格納されている 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 、フォームにコントロールを作成し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番StatusBarPanel目のオブジェクトpanel2は、 ToolTipText現在の日付を表示し、 StatusBarPanelクラスのプロパティを使用して現在の時刻を表示します。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 、プロパティを使用して、標準パネルではなくパネルが表示されるように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 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

注釈

StatusBarコントロールには、アプリケーションのユーザーに情報を提供するためのさまざまなパネルが表示されます。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. StatusBarコントロールによって表示される各パネルは、 StatusBarPanelクラスのインスタンスです。Each panel displayed by the StatusBar control is an instance of the StatusBarPanel class. プロパティを使用すると、 StatusBarコントロールに現在格納されStatusBarPanelているオブジェクトのコレクションへの参照を取得できます。 PanelsThe Panels property enables you to obtain a reference to the collection of StatusBarPanel objects that are currently stored in the StatusBar control. この参照を使用して、パネルの追加、パネルの削除、コレクション内の特定のパネルへのアクセス、およびStatusBarコントロール内のパネルの数の取得を行うことができます。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.

適用対象

こちらもご覧ください