TextBox.AcceptsReturn Propriété

Définition

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.Gets or sets a value indicating whether pressing ENTER in a multiline TextBox control creates a new line of text in the control or activates the default button for the form.

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é

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.true if the ENTER key creates a new line of text in a multiline version of the control; false if the ENTER key activates the default button for the form. Par défaut, il s’agit de false.The default is false.

Exemples

L’exemple de code suivant crée un contrôle de TextBox multiligne avec des barres de défilement verticales.The following code example creates a multiline TextBox control with vertical scroll bars. Cet exemple utilise les propriétés AcceptsTab, AcceptsReturnet WordWrap pour rendre le contrôle de zone de texte multiligne utile pour la création de documents texte.This example uses the AcceptsTab, AcceptsReturn, and WordWrap properties to make the multiline text box control useful for creating text documents.

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 nouvelle ligne dans un contrôle de TextBox multiligne.If the value of this property is false, the user must press CTRL+ENTER to create a new line in a multiline TextBox control. S’il n’existe pas de 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é.If there is no default button for the form, the ENTER key will always create a new line of text in the control, regardless of the value of this property.

S’applique à