TextBoxBase.AppendText(String) Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Добавляет текст в конец текущего текста в текстовом поле.

public:
 void AppendText(System::String ^ text);

public void AppendText (string? text);

member this.AppendText : string -> unit

Public Sub AppendText (text As String)

Параметры

text

String

Текст, добавляемый в конец текущего содержимого в текстовом поле.

Примеры

В следующем примере кода показано, как использовать AppendText метод и TextLength свойство для копирования текста из одного TextBox в другой. В этом примере требуется, textBox1 чтобы в форму textBox1 были добавлены два TextBox элемента управления с именами и textBox2, для которых свойству Text назначен текст.

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

Комментарии

Этот метод можно использовать для добавления текста в существующий текст в элементе управления вместо использования оператора объединения (+) для сцепления текста со свойством Text .

См. также раздел

• Copy()
• Paste()