TextBoxBase.TextLength Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém o comprimento do texto no controle.

public:
 virtual property int TextLength { int get(); };

[System.ComponentModel.Browsable(false)]
public virtual int TextLength { get; }

[<System.ComponentModel.Browsable(false)>]
member this.TextLength : int

Public Overridable ReadOnly Property TextLength As Integer

Valor da propriedade

Int32

O número de caracteres contidos no texto do controle.

Atributos

BrowsableAttribute

Exemplos

O exemplo de código a seguir demonstra como usar o AppendText método e a TextLength propriedade para copiar texto de um TextBox para outro. Este exemplo requer que dois TextBox controles nomeados textBox1 e textBox2, foram adicionados a um formulário e que textBox1 tem texto atribuído à sua Text propriedade.

void AppendTextBox1Text()
{
   // Determine if text is selected in textBox1.
   if ( textBox1->SelectionLength == 0 )

   // No selection made, return.
   return;

   // Determine if the text being appended to textBox2 exceeds the MaxLength property.
   if ( (textBox1->SelectedText->Length + textBox2->TextLength) > textBox2->MaxLength )
         MessageBox::Show( "The text to paste in is larger than the maximum number of characters allowed" ); // Append the text from textBox1 into textBox2.
   else
         textBox2->AppendText( textBox1->SelectedText );
}

private void AppendTextBox1Text()
{
   // Determine if text is selected in textBox1.
   if(textBox1.SelectionLength == 0)
      // No selection made, return.
      return;
   
   // Determine if the text being appended to textBox2 exceeds the MaxLength property.
   if((textBox1.SelectedText.Length + textBox2.TextLength) > textBox2.MaxLength)
      MessageBox.Show("The text to paste in is larger than the maximum number of characters allowed");
   else
      // Append the text from textBox1 into textBox2.
      textBox2.AppendText(textBox1.SelectedText);
}

Private Sub AppendTextBox1Text()
   ' Determine if text is selected in textBox1.
   If textBox1.SelectionLength = 0 Then
      ' No selection made, return.
      Return
   End If
   ' Determine if the text being appended to textBox2 exceeds the MaxLength property.
   If textBox1.SelectedText.Length + textBox2.TextLength > textBox2.MaxLength Then
      MessageBox.Show("The text to paste in is larger than the maximum number of characters allowed")
      ' Append the text from textBox1 into textBox2.
   Else
      textBox2.AppendText(textBox1.SelectedText)
   End If
End Sub

Comentários

Você pode usar essa propriedade para determinar o número de caracteres em uma cadeia de caracteres para tarefas como pesquisar cadeias de caracteres específicas de texto dentro do texto do controle, em que o conhecimento do número total de caracteres é necessário.

Confira também

• Text