Control.Text プロパティ

定義

このコントロールに関連付けられているテキストを取得または設定します。Gets or sets the text associated with this control.

public:
 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public virtual string Text { get; set; }
member this.Text : string with get, set
Public Overridable Property Text As String

プロパティ値

このコントロールに関連付けられたテキスト。The text associated with this control.

属性

次のコード例では、GroupBox を作成し、その共通プロパティのいくつかを設定します。The following code example creates a GroupBox and sets some of its common properties. この例では、TextBox を作成し、その Location をグループボックス内に設定します。The example creates a TextBox and sets its Location within the group box. 次に、グループボックスの Text プロパティを設定し、グループボックスをフォームの上部にドッキングします。Next, it sets the Text property of the group box, and docks the group box to the top of the form. 最後に、Enabled プロパティを false に設定してグループボックスを無効にします。これにより、グループボックス内に含まれるすべてのコントロールが無効になります。Lastly, it disables the group box by setting the Enabled property to false, which causes all controls contained within the group box to be disabled.

   // Add a GroupBox to a form and set some of its common properties.
private:
   void AddMyGroupBox()
   {
      // Create a GroupBox and add a TextBox to it.
      GroupBox^ groupBox1 = gcnew GroupBox;
      TextBox^ textBox1 = gcnew TextBox;
      textBox1->Location = Point(15,15);
      groupBox1->Controls->Add( textBox1 );

      // Set the Text and Dock properties of the GroupBox.
      groupBox1->Text = "MyGroupBox";
      groupBox1->Dock = DockStyle::Top;

      // Disable the GroupBox (which disables all its child controls)
      groupBox1->Enabled = false;

      // Add the Groupbox to the form.
      this->Controls->Add( groupBox1 );
   }
// Add a GroupBox to a form and set some of its common properties.
private void AddMyGroupBox()
{
   // Create a GroupBox and add a TextBox to it.
   GroupBox groupBox1 = new GroupBox();
   TextBox textBox1 = new TextBox();
   textBox1.Location = new Point(15, 15);
   groupBox1.Controls.Add(textBox1);

   // Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox";
   groupBox1.Dock = DockStyle.Top;

   // Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = false;

   // Add the Groupbox to the form.
   this.Controls.Add(groupBox1);
}
' Add a GroupBox to a form and set some of its common properties.
Private Sub AddMyGroupBox()
   ' Create a GroupBox and add a TextBox to it.
   Dim groupBox1 As New GroupBox()
   Dim textBox1 As New TextBox()
   textBox1.Location = New Point(15, 15)
   groupBox1.Controls.Add(textBox1)
   
   ' Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox"
   groupBox1.Dock = DockStyle.Top
   
   ' Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = False
   
   ' Add the Groupbox to the form.
   Me.Controls.Add(groupBox1)
End Sub

注釈

コントロールの Text プロパティは、各派生クラスによって異なる方法で使用されます。The Text property of the control is used differently by each derived class. たとえば、FormText プロパティは、フォームの上部にあるタイトルバーに表示され、文字数が非常に小さいため、通常はアプリケーション名またはドキュメント名が表示されます。For example the Text property of a Form is displayed in the title bar at the top of the form, is fairly small in character count, and usually displays the application or document name. ただし、RichTextBoxText プロパティは大きくなる可能性があり、テキストの書式設定に使用される非表示の文字が多数含まれることがあります。However, the Text property of a RichTextBox can be large and can include numerous nonvisual characters used to format the text. たとえば、RichTextBox に表示されるテキストは、Font プロパティを調整するか、テキストを配置するためのスペースまたはタブ文字を追加することによって書式設定できます。For example, the text displayed in a RichTextBox can be formatted by adjusting the Font properties, or by the addition of spaces or tab characters to align the text.

注意 (継承者)

派生クラスの Text プロパティをオーバーライドする場合は、基本クラスの Text プロパティを使用して、基本実装を拡張します。When overriding the Text property in a derived class, use the base class's Text property to extend the base implementation. それ以外の場合は、すべての実装を指定する必要があります。Otherwise, you must provide all the implementation. Text プロパティの getset の両方のアクセサーをオーバーライドする必要はありません。必要に応じて、オーバーライドできるのは1つだけです。You are not required to override both the get and set accessors of the Text property; you can override only one if needed.

適用対象

こちらもご覧ください