TextBoxBase.AppendText(String) メソッド

定義

テキスト ボックスの現在のテキストにテキストを追加します。Appends text to the current text of a text box.

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

パラメーター

text
String

テキスト ボックスの現在の内容に追加するテキスト。The text to append to the current contents of the text box.

次のコード例では、 AppendTextメソッドTextLengthとプロパティを使用して、1つTextBoxのから別のにテキストをコピーする方法を示します。The following code example demonstrates how to use the AppendText method and the TextLength property to copy text from one TextBox to another. この例では、 TextBox textBox1ととtextBox2いう名前の2つのコントロールがTextフォームtextBox1に追加され、そのプロパティにテキストが割り当てられている必要があります。This example requires that two TextBox controls named, textBox1 and textBox2, have been added to a form and that textBox1 has text assigned to its Text property.

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プロパティに連結する代わりに、コントロール内の既存のテキストにテキストを追加できます。You can use this method to add text to the existing text in the control instead of using the concatenation operator (+) to concatenate text to the Text property.

適用対象

こちらもご覧ください