Control.Text 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

取得或設定這個控制項的相關文字。

public:
 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Bindable(true)]
public virtual string Text { get; set; }

[<System.ComponentModel.Bindable(true)>]
member this.Text : string with get, set

Public Overridable Property Text As String

屬性值

String

與這個控制項關聯的文字。

屬性

BindableAttribute

範例

下列程式碼範例會建立 ， GroupBox 並設定其一些通用屬性。 此範例會建立 ， TextBox 並在群組方塊中設定其 Location 。 接下來，它會設定 Text 群組方塊的 屬性，並將群組方塊停駐在表單頂端。 最後，它會將 屬性設定 Enabled 為 false 來停用群組方塊，這會導致停用群組方塊中包含的所有控制項。

   // 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 的 屬性會由每個衍生類別以不同的方式使用。 例如， Text 的 Form 屬性會顯示在表單頂端的標題列中、在字元計數中相當小，而且通常會顯示應用程式或檔案名稱。 不過， Text 的 RichTextBox 屬性可能很大，而且可以包含許多用來格式化文字的非visual 字元。 例如，可以藉由調整 Font 屬性，或新增空格或定位字元來對齊文字，來格式化 中顯示的 RichTextBox 文字。

給繼承者的注意事項

在衍生類別中覆 Text 寫 屬性時，請使用基類的 Text 屬性來擴充基底實作。 否則，您必須提供所有實作。 您不需要同時覆寫 get 屬性的 Text 和 set 存取子;您可以視需要只覆寫一個。

另請參閱

• TextLength