StatusBar.StatusBarPanelCollection.Add メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
StatusBarPanel をコレクションに追加します。
オーバーロード
Add(String) |
テキストが指定されている StatusBarPanel をコレクションに追加します。 |
Add(StatusBarPanel) |
StatusBarPanel をコレクションに追加します。 |
Add(String)
テキストが指定されている StatusBarPanel をコレクションに追加します。
public:
virtual System::Windows::Forms::StatusBarPanel ^ Add(System::String ^ text);
public virtual System.Windows.Forms.StatusBarPanel Add (string text);
abstract member Add : string -> System.Windows.Forms.StatusBarPanel
override this.Add : string -> System.Windows.Forms.StatusBarPanel
Public Overridable Function Add (text As String) As StatusBarPanel
パラメーター
- text
- String
追加されている StatusBarPanel のテキスト。
戻り値
コレクションに追加されたパネルを表す StatusBarPanel。
注釈
パネルをコントロールに追加して StatusBar 、複数の種類の情報を表示できます。 このバージョンのメソッドは、 Add パラメーターで指定されたテキストを使用して新しい StatusBarPanel メソッドを text
作成し、コレクションに追加します。 パネルが配置 StatusBar.StatusBarPanelCollection されている順序は、パネルがコントロール内に表示される順序を StatusBar 表します。 パネルは、コレクション内の最初のパネルから左から右に表示されます。 コントロールのプロパティは RightToLeft 、 StatusBar パネルが表示される順序を StatusBar変更しません。 コレクション内の特定の位置にパネルを挿入するには、メソッドを Insert 使用します。 1 回の操作で一連のパネルをコレクションに追加するには、メソッドを AddRange 使用します。
こちらもご覧ください
適用対象
Add(StatusBarPanel)
StatusBarPanel をコレクションに追加します。
public:
virtual int Add(System::Windows::Forms::StatusBarPanel ^ value);
public virtual int Add (System.Windows.Forms.StatusBarPanel value);
abstract member Add : System.Windows.Forms.StatusBarPanel -> int
override this.Add : System.Windows.Forms.StatusBarPanel -> int
Public Overridable Function Add (value As StatusBarPanel) As Integer
パラメーター
- value
- StatusBarPanel
コレクションに追加するパネルを表す StatusBarPanel。
戻り値
コレクション内のアイテムの 0 から始まるインデックスです。
例外
コレクションに追加しようとした StatusBarPanel が null
でした。
value
パラメーターで指定された StatusBarPanel の親が null
ではありません。
例
次のコード例では、フォームにコントロールを StatusBar 作成し、2 つの StatusBarPanel オブジェクトを追加します。 名前付 StatusBarPanel きの panel1
オブジェクトの 1 つは、アプリケーションの状態テキストを表示します。 2 つ目StatusBarPanelの名前panel2
は、現在の日付を表示し、クラスのプロパティをStatusBarPanel使用ToolTipTextして現在の時刻を表示します。 この例では、このプロパティをShowPanels使用して、標準パネルの代わりにパネルが表示されるようにし、そのプロパティをPanels使用してパネルを追加するメソッドStatusBar.StatusBarPanelCollectionにStatusBarアクセス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
注釈
パネルをコントロールに追加して StatusBar 、複数の種類の情報を表示できます。 このバージョンのメソッドは、Add指定されたパラメーターをvalue
コレクションに追加StatusBarPanelします。 パネルが配置 StatusBar.StatusBarPanelCollection されている順序は、パネルがコントロール内に表示される順序を StatusBar 表します。 パネルは、コレクション内の最初のパネルから左から右に表示されます。 コントロールのプロパティは RightToLeft 、 StatusBar パネルが表示される順序を StatusBar変更しません。 コレクション内の特定の位置にパネルを挿入するには、メソッドを Insert 使用します。 1 回の操作で一連のパネルをコレクションに追加するには、メソッドを AddRange 使用します。