TextBoxBase.AppendText(String) Método

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Acrescenta texto ao texto atual de uma caixa de texto.

public:
 void AppendText(System::String ^ text);
public void AppendText(string text);
member this.AppendText : string -> unit
Public Sub AppendText (text As String)

Parâmetros

text
String

O texto a acrescentar ao conteúdo atual da caixa de texto.

Exemplos

O exemplo de código seguinte demonstra como usar o AppendText método e a TextLength propriedade para copiar texto de um TextBox para outro. Este exemplo exige que dois TextBox controlos textBox1 nomeados e textBox2, tenham sido adicionados a um formulário e que textBox1 tenha 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

Observações

Pode usar este método para adicionar texto ao texto existente no controlo, em vez de usar o operador de concatenação (+) para concatenar texto à Text propriedade.

Aplica-se a

Ver também