TextBox.AcceptsReturn Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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é.