StatusBarPanel クラス

定義

StatusBar コントロールのパネルを表します。

このクラスは、.NET 5.0 以降のバージョンでは使用できません。 代わりに StatusStrip コントロールを使用します。このコントロールは、 コントロールを置き換えて拡張 StatusBar します。

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
継承
実装

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

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

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

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

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

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

コンストラクター

StatusBarPanel()

StatusBarPanel クラスの新しいインスタンスを初期化します。

プロパティ

Alignment

ステータス バー パネル内のテキストおよびアイコンの配置を取得または設定します。

AutoSize

ステータス バー パネルのサイズを自動調整するかどうかを示す値を取得または設定します。

BorderStyle

ステータス バー パネルの境界線スタイルを取得または設定します。

CanRaiseEvents

コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。

(継承元 Component)
Container

IContainer を含む Component を取得します。

(継承元 Component)
DesignMode

Component が現在デザイン モードかどうかを示す値を取得します。

(継承元 Component)
Events

Component に結び付けられているイベント ハンドラーのリストを取得します。

(継承元 Component)
Icon

ステータス バー パネル内に表示するアイコンを取得または設定します。

MinWidth

StatusBar コントロール内のステータス バー パネルの最小有効幅を取得または設定します。

Name

StatusBarPanel に適用する名前を取得または設定します。

Parent

ステータス バー パネルをホストする StatusBar コントロールを取得します。

Site

ComponentISite を取得または設定します。

(継承元 Component)
Style

ステータス バー パネルのスタイルを取得または設定します。

Tag

StatusBarPanel に関するデータを格納するオブジェクトを取得または設定します。

Text

ステータス バー パネルのテキストを取得または設定します。

ToolTipText

ステータス バー パネルに関連付けられたツール ヒントのテキストを取得または設定します。

Width

StatusBar コントロール内のステータス バー パネルの幅を取得または設定します。

メソッド

BeginInit()

StatusBarPanel の初期化を開始します。

CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。

(継承元 MarshalByRefObject)
Dispose()

Component によって使用されているすべてのリソースを解放します。

(継承元 Component)
Dispose(Boolean)

StatusBarPanel によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。

EndInit()

StatusBarPanel の初期化を終了します。

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetLifetimeService()
互換性のために残されています。

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
GetService(Type)

Component またはその Container で提供されるサービスを表すオブジェクトを返します。

(継承元 Component)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
InitializeLifetimeService()
互換性のために残されています。

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。

(継承元 MarshalByRefObject)
ToString()

パネルに関する情報を含む文字列を取得します。

イベント

Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。

(継承元 Component)

適用対象

こちらもご覧ください