Control.Text Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta il testo associato a questo controllo.

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

Valore della proprietà

String

Testo associato a questo controllo.

Attributi

BindableAttribute

Esempio

Nell'esempio di codice seguente viene creato un oggetto GroupBox e vengono impostate alcune delle relative proprietà comuni. Nell'esempio viene creato un oggetto TextBox e viene Location impostato all'interno della casella di gruppo. Imposta quindi la Text proprietà della casella di gruppo e ancora la casella di gruppo sulla parte superiore del modulo. Infine, disabilita la casella di gruppo impostando la Enabled proprietà su false, in modo che tutti i controlli contenuti nella casella di gruppo vengano disabilitati.

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

Commenti

La Text proprietà del controllo viene utilizzata in modo diverso da ogni classe derivata. Ad esempio, la Text proprietà di un Form oggetto viene visualizzata nella barra del titolo nella parte superiore della maschera, è piuttosto piccola nel numero di caratteri e in genere visualizza il nome dell'applicazione o del documento. Tuttavia, la Text proprietà di un RichTextBox oggetto può essere grande e può includere numerosi caratteri nonvisuali utilizzati per formattare il testo. Ad esempio, il testo visualizzato in un RichTextBox oggetto può essere formattato regolando le Font proprietà o mediante l'aggiunta di spazi o caratteri di tabulazione per allineare il testo.

Note per gli eredi

Quando si esegue l'override della Text proprietà in una classe derivata, utilizzare la proprietà della classe di base per estendere l'implementazione di Text base. In caso contrario, è necessario fornire tutte le implementazioni. Non è necessario eseguire l'override di entrambe le get funzioni di accesso e set della Text proprietà. Se necessario, è possibile eseguirne l'override.

Vedi anche

• TextLength