StatusBarPanel クラス

定義

public ref class StatusBarPanel : System::ComponentModel::Component, System::ComponentModel::ISupportInitialize

public class StatusBarPanel : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

type StatusBarPanel = class
    inherit Component
    interface ISupportInitialize

Public Class StatusBarPanel
Inherits Component
Implements ISupportInitialize

継承

Object

MarshalByRefObject

Component

StatusBarPanel

実装

ISupportInitialize

例

次のコード例では、フォームにコントロールを StatusBar 作成し、2 つの StatusBarPanel オブジェクトを追加します。 という名前panel1の最初StatusBarPanelの は、アプリケーションの状態テキストを表示します。 という名前panel2の 2 番目StatusBarPanelの は、現在の日付を表示し、 クラスの プロパティをStatusBarPanel使用ToolTipTextして現在の時刻を表示します。 この例では、 プロパティをShowPanels使用して、標準パネルではなくパネルが表示されるようにし、 プロパティをPanels使用して の StatusBar.StatusBarPanelCollection メソッドにアクセスAddし、パネルを にStatusBar追加します。 また、および Text の各プロパティをToolTipTextAutoSizeBorderStyle使用してオブジェクトをStatusBarPanel初期化します。 この例では、例で定義されているメソッドが 定義され、 の 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

注釈

このクラスは、.NET 5 以降のバージョンでは使用できません。 代わりに コントロールを ToolStripStatusLabel 使用してください。

は StatusBarPanel 、コントロールの の StatusBar.StatusBarPanelCollection 個々のパネルを StatusBar 表します。 には StatusBarPanel 、アプリケーションの状態を反映するために使用できるテキストやアイコンを含めることができます。 コントロールの StatusBar.StatusBarPanelCollectionプロパティからStatusBar.Panelsアクセスできる を使用して、個々StatusBarPanelの StatusBar を取得、追加、または削除します。

には StatusBarPanel 、コントロール内のパネルの表示動作を変更できるプロパティが用意 StatusBar されています。 プロパティを Icon 使用すると、パネル内にアイコンを表示できます。 このプロパティを使用すると、アプリケーションの状態をグラフィカルに表現できます。 Alignmentプロパティを使用すると、パネル内でテキストやアイコンを配置する方法を指定できます。 パネルのテキストに合わせてパネルのサイズが適切に設定されるようにするには、 プロパティを AutoSize 使用して、パネルのテキストに合わせてパネルのサイズを自動的に変更したり、コントロール内の残りの領域を StatusBar 埋めたりすることができます。 MinWidthプロパティを使用すると、パネルの最小幅を指定して、表示するデータよりも小さくならないようにすることができます。

StatusBarこのコントロールは、通常、アプリケーションに関するヘルプ情報または状態情報を表示するために使用されます。 多くの場合、パネルに表示されるデータに関する追加情報を表示することが重要です。 プロパティを ToolTipText 使用すると、マウス ポインターがパネル上に置かれたときに情報を表示できます。

StatusBarコントロールは通常、テキスト情報を表示するために使用されますが、 に独自の種類の表示をStatusBarPanel指定することもできます。 Styleプロパティを使用すると、 の描画方法をStatusBarPanel指定できます。 既定では、 プロパティは Style 、プロパティの Text 値 (および プロパティで Icon 指定されている場合はアイコン) を表示するために使用されます。 プロパティが に OwnerDraw設定されている場合は、パネルに独自の情報を描画できます。 この機能を使用すると、パネルに進行状況バーまたはアニメーションアイコンを描画できます。

クラスの StatusBarPanel インスタンスを作成すると、読み取り/書き込みプロパティは初期値に設定されます。 これらの値の一覧については、 コンストラクターを StatusBarPanel 参照してください。

コンストラクター

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• StatusBarPanel