Control.Text Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el texto asociado al 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; }

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

Public Overridable Property Text As String

Valor de propiedad

String

Texto asociado al control.

Atributos

BindableAttribute

Ejemplos

En el ejemplo de código siguiente se crea un GroupBox objeto y se establecen algunas de sus propiedades comunes. En el ejemplo se crea un TextBox objeto y se establece su Location dentro del cuadro de grupo. A continuación, establece la Text propiedad del cuadro de grupo y acopla el cuadro de grupo en la parte superior del formulario. Por último, deshabilita el cuadro de grupo estableciendo la Enabled propiedad falseen , lo que hace que todos los controles contenidos en el cuadro de grupo se deshabiliten.

   // 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

Comentarios

Cada Text clase derivada usa la propiedad del control de forma diferente. Por ejemplo, la Text propiedad de se Form muestra en la barra de título de la parte superior del formulario, es bastante pequeña en el recuento de caracteres y, normalmente, muestra el nombre de la aplicación o del documento. Sin embargo, la Text propiedad de un RichTextBox objeto puede ser grande y puede incluir numerosos caracteres novisuales usados para dar formato al texto. Por ejemplo, el texto que se muestra en un RichTextBox objeto se puede dar formato ajustando las Font propiedades o agregando espacios o caracteres de tabulación para alinear el texto.

Notas a los desarrolladores de herederos

Al invalidar la Text propiedad en una clase derivada, use la propiedad de Text la clase base para ampliar la implementación base. De lo contrario, debe proporcionar toda la implementación. No es necesario invalidar los get descriptores de acceso y set de la Text propiedad; solo puede invalidar uno si es necesario.

Consulte también

• TextLength