TextBox.AcceptsReturn Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit une valeur indiquant si le fait d'appuyer sur la touche ENTRÉE dans un contrôle TextBox multiligne entraîne la création d'une nouvelle ligne de texte dans le contrôle ou l'activation du bouton par défaut sur le formulaire.

public:
 property bool AcceptsReturn { bool get(); void set(bool value); };

public bool AcceptsReturn { get; set; }

member this.AcceptsReturn : bool with get, set

Public Property AcceptsReturn As Boolean

Valeur de propriété

Boolean

true si la touche ENTRÉE crée une ligne de texte dans un contrôle multiligne, false si elle active le bouton par défaut sur le formulaire. La valeur par défaut est false.

Exemples

L’exemple de code suivant crée un contrôle multiligne TextBox avec des barres de défilement verticales. Cet exemple utilise les propriétés et AcceptsReturnWordWrap les AcceptsTabpropriétés pour rendre le contrôle de zone de texte multiligne utile pour la création de documents texte.

public:
   void CreateMyMultilineTextBox()
   {
      // Create an instance of a TextBox control.
      TextBox^ textBox1 = gcnew TextBox;
      
      // Set the Multiline property to true.
      textBox1->Multiline = true;
      // Add vertical scroll bars to the TextBox control.
      textBox1->ScrollBars = ScrollBars::Vertical;
      // Allow the RETURN key to be entered in the TextBox control.
      textBox1->AcceptsReturn = true;
      // Allow the TAB key to be entered in the TextBox control.
      textBox1->AcceptsTab = true;
      // Set WordWrap to true to allow text to wrap to the next line.
      textBox1->WordWrap = true;
      // Set the default text of the control.
      textBox1->Text = "Welcome!";
   }

public void CreateMyMultilineTextBox()
 {
    // Create an instance of a TextBox control.
    TextBox textBox1 = new TextBox();
       
    // Set the Multiline property to true.
    textBox1.Multiline = true;
    // Add vertical scroll bars to the TextBox control.
    textBox1.ScrollBars = ScrollBars.Vertical;
    // Allow the RETURN key to be entered in the TextBox control.
    textBox1.AcceptsReturn = true;
    // Allow the TAB key to be entered in the TextBox control.
    textBox1.AcceptsTab = true;
    // Set WordWrap to true to allow text to wrap to the next line.
    textBox1.WordWrap = true;
    // Set the default text of the control.
    textBox1.Text = "Welcome!";
 }

Public Sub CreateMyMultilineTextBox()
    ' Create an instance of a TextBox control.
    Dim textBox1 As New TextBox()
    
    ' Set the Multiline property to true.
    textBox1.Multiline = True
    ' Add vertical scroll bars to the TextBox control.
    textBox1.ScrollBars = ScrollBars.Vertical
    ' Allow the RETURN key to be entered in the TextBox control.
    textBox1.AcceptsReturn = True
    ' Allow the TAB key to be entered in the TextBox control.
    textBox1.AcceptsTab = True
    ' Set WordWrap to true to allow text to wrap to the next line.
    textBox1.WordWrap = True
    ' Set the default text of the control.
    textBox1.Text = "Welcome!"
End Sub

Remarques

Si la valeur de cette propriété est false, l’utilisateur doit appuyer sur Ctrl+Entrée pour créer une ligne dans un contrôle multiligne TextBox . S’il n’existe aucun bouton par défaut pour le formulaire, la touche ENTRÉE crée toujours une nouvelle ligne de texte dans le contrôle, quelle que soit la valeur de cette propriété.