Control.Text 속성

아티클
08/21/2007

이 컨트롤과 관련된 텍스트를 가져오거나 설정합니다.

네임스페이스: System.Windows.Forms
어셈블리: System.Windows.Forms(system.windows.forms.dll)

구문

‘선언
<LocalizableAttribute(True)> _
<BindableAttribute(True)> _
Public Overridable Property Text As String
‘사용 방법
Dim instance As Control
Dim value As String

value = instance.Text

instance.Text = value

[LocalizableAttribute(true)] 
[BindableAttribute(true)] 
public virtual string Text { get; set; }

[LocalizableAttribute(true)] 
[BindableAttribute(true)] 
public:
virtual property String^ Text {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_Text ()

/** @property */
public void set_Text (String value)

public function get Text () : String

public function set Text (value : String)

속성 값

이 컨트롤과 관련된 텍스트입니다.

설명

컨트롤의 Text 속성은 각 파생 클래스에서 서로 다르게 사용됩니다. 예를 들어, Form의 Text 속성은 폼의 위쪽에 있는 제목 표시줄에 나타나며, 비교적 문자 수가 적고, 대개 응용 프로그램이나 문서 이름을 표시합니다. 그러나 RichTextBox의 Text 속성은 문자 수가 많을 수 있고 텍스트의 서식을 지정하는 데 사용되는 보이지 않는 문자가 여러 개 포함될 수 있습니다. 예를 들어, RichTextBox에 표시되는 텍스트는 Font 속성을 조정하거나 공백 또는 탭 문자를 추가한 다음 텍스트를 정렬하여 서식을 지정할 수 있습니다.

상속자 참고 사항 파생 클래스에서 Text 속성을 재정의하는 경우 기본 클래스의 Text 속성을 사용하여 기본 구현을 확장합니다. 그렇지 않으면 모든 구현을 제공해야 합니다. Text 속성의 get 및 set 접근자를 모두 재정의할 필요는 없습니다. 필요에 따라 하나의 접근자만 재정의하면 됩니다.

예제

다음 코드 예제에서는 GroupBox를 만들고 해당 공용 속성 중 일부를 설정합니다. 이 예제에서는 TextBox를 만든 다음 텍스트 상자의 Location을 그룹 상자 내에 설정합니다. 다음에는 그룹 상자의 Text 속성을 설정하고 폼의 상단에 그룹 상자를 도킹시킵니다. 마지막으로 Enabled 속성을 false로 설정하여 그룹 상자를 비활성화합니다. 이렇게 하면 그룹 상자에 포함된 모든 컨트롤도 비활성화됩니다.

' 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

// 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:
   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.set_Location(new Point(15, 15));
    groupBox1.get_Controls().Add(textBox1);
    // Set the Text and Dock properties of the GroupBox.
    groupBox1.set_Text("MyGroupBox");
    groupBox1.set_Dock(DockStyle.Top);
    // Disable the GroupBox (which disables all its child controls)
    groupBox1.set_Enabled(false);
    // Add the Groupbox to the form.
    this.get_Controls().Add(groupBox1);
} //AddMyGroupBox

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

Control 클래스
Control 멤버
System.Windows.Forms 네임스페이스
TextBoxBase.TextLength

다음을 통해 공유