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

注釈

AStatusBarPanelで個々 のパネルを表す、StatusBar.StatusBarPanelCollectionStatusBarコントロール。A StatusBarPanel represents an individual panel in the StatusBar.StatusBarPanelCollection of a StatusBar control. AStatusBarPanelテキストや、アプリケーションの状態を反映するために使用できるアイコンに含めることができます。A StatusBarPanel can contain text and/or an icon that can be used to reflect the status of an application. 使用、 StatusBar.StatusBarPanelCollection、を通じてアクセス可能なStatusBar.PanelsのプロパティをStatusBar取得、追加、または個人を削除する、制御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コントロールを通常使用すると、テキスト情報を表示、独自の型の表示を行うことができます、 StatusBarPanelAlthough 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() 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)

適用対象

こちらもご覧ください