Control.Text Control.Text Control.Text Control.Text Property

定義

このコントロールに関連付けられているテキストを取得または設定します。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. たとえばTextFormのプロパティは、フォームの上部にあるタイトルバーに表示され、文字数が非常に小さいため、通常はアプリケーション名またはドキュメント名が表示されます。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. ただし、 Text RichTextBoxのプロパティは大きくなる可能性があり、テキストの書式設定に使用される多くの非表示文字を含めることができます。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. プロパティのset get アクセサーとアクセサーの両方をオーバーライドする必要はありません。必要な場合は、1つだけをオーバーライドできます。TextYou are not required to override both the get and set accessors of the Text property; you can override only one if needed.

適用対象

こちらもご覧ください