StatusBarPanel クラス

定義

StatusBar コントロールのパネルを表します。Represents a panel in a StatusBar control. StatusStrip コントロールでは、以前のバージョンの StatusBar コントロールの機能が置換および追加されていますが、下位互換性を維持し、今後必要に応じて使用できるように、StatusBar が保持されています。Although the StatusStrip control replaces and adds functionality to the StatusBar control of previous versions, StatusBar is retained for both backward compatibility and future use if you choose.

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 オブジェクトを追加します。The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. 最初の StatusBarPanelpanel1という名前で、アプリケーションのステータステキストを表示します。The first StatusBarPanel, named panel1, displays status text for an application. 2番目の panel2StatusBarPanelは、現在の日付を表示し、StatusBarPanel クラスの ToolTipText プロパティを使用して現在の時刻を表示します。The second StatusBarPanel, named panel2, displays the current date and uses the ToolTipText property of the StatusBarPanel class to display the current time. この例では、ShowPanels プロパティを使用して、標準パネルではなくパネルが表示されるようにします。また、Panels プロパティを使用して StatusBar.StatusBarPanelCollectionAdd メソッドにアクセスし、パネルを StatusBarに追加します。The example uses the ShowPanels property to ensure that the panels are displayed instead of a standard panel, and it uses the Panels property to access the Add method of the StatusBar.StatusBarPanelCollection to add the panels to the StatusBar. また、この例では、AutoSizeBorderStyleToolTipText、および Text プロパティを使用して、StatusBarPanel オブジェクトを初期化します。The example also uses the AutoSize, BorderStyle, ToolTipText, and Text properties to initialize the StatusBarPanel objects. この例では、例で定義されているメソッドが、Formのコンストラクターから定義および呼び出されていることを前提としています。This example assumes 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 コントロールの StatusBar.StatusBarPanelCollection 内の個々のパネルを表す StatusBarPanelA StatusBarPanel represents an individual panel in the StatusBar.StatusBarPanelCollection of a StatusBar control. StatusBarPanel には、アプリケーションの状態を反映するために使用できるテキストやアイコンを含めることができます。A StatusBarPanel can contain text and/or an icon that can be used to reflect the status of an application. StatusBar コントロールの StatusBar.Panels プロパティを使用してアクセスできる StatusBar.StatusBarPanelCollectionを使用して、個々の StatusBarPanelを取得、追加、または削除します。Use the StatusBar.StatusBarPanelCollection, accessible through the StatusBar.Panels property of a StatusBar control, to retrieve, add, or remove an individual StatusBarPanel.

StatusBarPanel には、StatusBar コントロール内のパネルの表示動作を変更できるようにするプロパティが用意されています。The StatusBarPanel provides properties that enable you to modify the display behavior of a panel within a StatusBar control. Icon プロパティを使用して、パネル内にアイコンを表示できます。You can use the Icon property to display an icon within a panel. このプロパティを使用すると、アプリケーションの状態をグラフィカルに表示できます。This property can be used to provide a graphical representation of state in an application. Alignment プロパティを使用すると、パネル内でのテキストやアイコンの調整方法を指定できます。The Alignment property enables you to specify how text and/or an icon is aligned within the panel. パネルのサイズがパネルのテキストに合わせて適切に設定されていることを確認するには、[AutoSize] プロパティを使用して、パネルのテキストに合わせてパネルのサイズを自動的に変更するか、StatusBar コントロール内の残りの領域を塗りつぶすことができます。To ensure that your panel is sized properly to fit the text of the panel, you can use the AutoSize property to automatically resize the panel to fit the text of the panel or to fill the remaining space within the StatusBar control. MinWidth プロパティを使用すると、パネルの最小幅を指定して、表示するデータよりも小さくならないようにすることができます。The MinWidth property enables you to specify a minimum width for the panel to ensure that it does not get smaller than the data it is intended to display.

StatusBar コントロールは、通常、アプリケーションに関するヘルプ情報や状態情報を表示するために使用されます。The StatusBar control is typically used to display Help information or state information about your application. 多くの場合、パネルに表示されるデータに関する追加情報を表示することが重要です。Often, it is important to display additional information about data that is presented in a panel. ToolTipText プロパティを使用すると、マウスポインターがパネル上にあるときに情報を表示できます。You can use the ToolTipText property to display information whenever the mouse pointer rests on a panel.

StatusBar コントロールは通常、テキストの情報を表示するために使用されますが、独自の種類の表示を StatusBarPanelに提供することもできます。Although the StatusBar control is typically used to display textual information, you can also provide your own type of display to a StatusBarPanel. Style プロパティを使用すると、StatusBarPanel の描画方法を指定できます。The Style property enables you to specify how the StatusBarPanel will be drawn. 既定では、Style プロパティを使用して Text プロパティの値 (および Icon プロパティで指定されている場合はアイコン) が表示されます。By default, the Style property is used to display the value of the Text property (and an icon, if specified in the Icon property). プロパティが OwnerDrawに設定されている場合は、独自の情報をパネルに描画できます。If the property is set to OwnerDraw, you can draw your own information into the panel. この機能を使用すると、パネルにプログレスバーまたはアニメーションアイコンを描画できます。You can use this feature to draw a progress bar or an animated icon in the panel.

StatusBarPanel クラスのインスタンスを作成すると、読み取り/書き込みプロパティが初期値に設定されます。When you create an instance of the StatusBarPanel class, the read/write properties are set to initial values. これらの値の一覧については、StatusBarPanel コンストラクターを参照してください。For a list of these values, see the StatusBarPanel constructor.

コンストラクター

StatusBarPanel()

StatusBarPanel クラスの新しいインスタンスを初期化します。Initializes a new instance of the StatusBarPanel class.

プロパティ

Alignment

ステータス バー パネル内のテキストおよびアイコンの配置を取得または設定します。Gets or sets the alignment of text and icons within the status bar panel.

AutoSize

ステータス バー パネルのサイズを自動調整するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the status bar panel is automatically resized.

BorderStyle

ステータス バー パネルの境界線スタイルを取得または設定します。Gets or sets the border style of the status bar panel.

CanRaiseEvents

コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。Gets a value indicating whether the component can raise an event.

(継承元 Component)
Container

IContainer を格納している Component を取得します。Gets the IContainer that contains the Component.

(継承元 Component)
DesignMode

Component が現在デザイン モードかどうかを示す値を取得します。Gets a value that indicates whether the Component is currently in design mode.

(継承元 Component)
Events

Component に結び付けられているイベント ハンドラーのリストを取得します。Gets the list of event handlers that are attached to this Component.

(継承元 Component)
Icon

ステータス バー パネル内に表示するアイコンを取得または設定します。Gets or sets the icon to display within the status bar panel.

MinWidth

StatusBar コントロール内のステータス バー パネルの最小有効幅を取得または設定します。Gets or sets the minimum allowed width of the status bar panel within the StatusBar control.

Name

StatusBarPanel に適用する名前を取得または設定します。Gets or sets the name to apply to the StatusBarPanel.

Parent

ステータス バー パネルをホストする StatusBar コントロールを取得します。Gets the StatusBar control that hosts the status bar panel.

Site

ISiteComponent を取得または設定します。Gets or sets the ISite of the Component.

(継承元 Component)
Style

ステータス バー パネルのスタイルを取得または設定します。Gets or sets the style of the status bar panel.

Tag

StatusBarPanel に関するデータを格納するオブジェクトを取得または設定します。Gets or sets an object that contains data about the StatusBarPanel.

Text

ステータス バー パネルのテキストを取得または設定します。Gets or sets the text of the status bar panel.

ToolTipText

ステータス バー パネルに関連付けられたツール ヒントのテキストを取得または設定します。Gets or sets ToolTip text associated with the status bar panel.

Width

StatusBar コントロール内のステータス バー パネルの幅を取得または設定します。Gets or sets the width of the status bar panel within the StatusBar control.

メソッド

BeginInit()

StatusBarPanel の初期化を開始します。Begins the initialization of a StatusBarPanel.

CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(継承元 MarshalByRefObject)
Dispose()

Component によって使用されているすべてのリソースを解放します。Releases all resources used by the Component.

(継承元 Component)
Dispose(Boolean)

StatusBarPanel によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the StatusBarPanel and optionally releases the managed resources.

EndInit()

StatusBarPanel の初期化を終了します。Ends the initialization of a StatusBarPanel.

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判定します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(継承元 MarshalByRefObject)
GetService(Type)

Component またはその Container で提供されるサービスを表すオブジェクトを返します。Returns an object that represents a service provided by the Component or by its Container.

(継承元 Component)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(継承元 MarshalByRefObject)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(継承元 MarshalByRefObject)
ToString()

パネルに関する情報を含む文字列を取得します。Retrieves a string that contains information about the panel.

イベント

Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されると発生します。Occurs when the component is disposed by a call to the Dispose() method.

(継承元 Component)

適用対象

こちらもご覧ください