StatusBarPanel クラス

定義

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

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

A StatusBarPanel は、コントロールの個々のパネルをStatusBar.StatusBarPanelCollectionStatusBar表します。 アプリケーションの 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)

適用対象

こちらもご覧ください