StatusBarPanel クラス

リファレンス

定義

名前空間:: System.Windows.Forms

アセンブリ:: System.Windows.Forms.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

このクラスは、.NET 5 以降のバージョンでは使用できません。代わりにコントロールを ToolStripStatusLabel 使用します。これにより、コントロールが置き換えられ、拡張されます 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 の各プロパティをToolTipText AutoSize BorderStyle使用してオブジェクトを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()

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

プロパティ

Alignment	ステータスバーパネル内のテキストおよびアイコンの配置を取得または設定します。
AutoSize	ステータスバーパネルのサイズを自動調整するかどうかを示す値を取得または設定します。
BorderStyle	ステータスバーパネルの境界線スタイルを取得または設定します。
CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 (継承元 Component)
Container	IContainer を含む Component を取得します。 (継承元 Component)
DesignMode	Component が現在デザインモードかどうかを示す値を取得します。 (継承元 Component)
Events	Component に結び付けられているイベントハンドラーのリストを取得します。 (継承元 Component)
Icon	ステータスバーパネル内に表示するアイコンを取得または設定します。
MinWidth	StatusBar コントロール内のステータスバーパネルの最小有効幅を取得または設定します。
Name	StatusBarPanel に適用する名前を取得または設定します。
Parent	ステータスバーパネルをホストする StatusBar コントロールを取得します。
Site	Component の ISite を取得または設定します。 (継承元 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)

適用対象

こちらもご覧ください

StatusBarPanel