StatusBarPanel StatusBarPanel StatusBarPanel StatusBarPanel Class

定義

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 、フォームにコントロールを作成しStatusBarPanel 、2つのオブジェクトを追加します。The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. 1つStatusBarPanel目のpanel1名前は、アプリケーションのステータステキストを表示します。The first StatusBarPanel, named panel1, displays status text for an application. 2番StatusBarPanelpanel2のは、 ToolTipText現在の日付を表示し、 StatusBarPanelクラスのプロパティを使用して現在の時刻を表示します。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ます。 Addまた、プロパティStatusBar.StatusBarPanelCollectionを使用してのメソッドにアクセスし、パネルをに追加します。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. また、この例でAutoSizeBorderStyle ToolTipText、、、 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

注釈

StatusBarPanel StatusBar.StatusBarPanelCollection 、コントロールStatusBarの内の個々のパネルを表します。A 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.Panels通じてアクセス可能なを使用して、個々StatusBarPanelのを取得、追加、または削除します。 StatusBar.StatusBarPanelCollection StatusBarUse 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.

通常、 StatusBarPanelコントロールはテキスト情報を表示するために使用されますが、独自の種類の表示をに提供することもできます。 StatusBarAlthough the StatusBar control is typically used to display textual information, you can also provide your own type of display to a StatusBarPanel. プロパティを使用すると、のStatusBarPanel描画方法を指定できます。 StyleThe 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() StatusBarPanel() StatusBarPanel()

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

プロパティ

Alignment Alignment Alignment Alignment

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

AutoSize AutoSize AutoSize AutoSize

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

BorderStyle BorderStyle BorderStyle BorderStyle

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

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

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

(Inherited from Component)
Container Container Container Container

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

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

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

(Inherited from Component)
Events Events Events Events

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

(Inherited from Component)
Icon Icon Icon Icon

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

MinWidth MinWidth MinWidth MinWidth

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

Name Name Name Name

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

Parent Parent Parent Parent

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

Site Site Site Site

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

(Inherited from Component)
Style Style Style Style

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

Tag Tag Tag Tag

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

Text Text Text Text

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

ToolTipText ToolTipText ToolTipText ToolTipText

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

Width Width Width Width

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

メソッド

BeginInit() BeginInit() BeginInit() BeginInit()

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

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

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

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

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

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

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

EndInit() EndInit() EndInit() EndInit()

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

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

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

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

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

(Inherited from Component)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

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

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

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

イベント

Disposed Disposed Disposed Disposed

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

(Inherited from Component)

適用対象

こちらもご覧ください