TextBoxBase.WordWrap Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Indica se um controle de caixa de texto de várias linhas automaticamente quebra o texto para o início da próxima linha, quando necessário.
public:
property bool WordWrap { bool get(); void set(bool value); };
public bool WordWrap { get; set; }
member this.WordWrap : bool with get, set
Public Property WordWrap As Boolean
Valor da propriedade
true
se o controle de caixa de texto de várias linhas quebra o texto; false
se o controle de caixa de texto automaticamente rolar horizontalmente quando o usuário digitar além da borda direita do controle. O padrão é true
.
Exemplos
O exemplo de código a seguir usa TextBoxuma classe derivada para criar um controle de várias linhas TextBox com barras de rolagem verticais. Este exemplo também usa as AcceptsTabpropriedades e WordWrap , AcceptsReturnpara tornar o controle de caixa de texto de várias linhas útil para a criação de documentos de texto.
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 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!" + Environment::NewLine + "Second Line";
}
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 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!" + Environment.NewLine + "Second Line";
}
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 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!" & Environment.NewLine & "Second Line"
End Sub
Comentários
Se essa propriedade estiver definida como true
, as barras de rolagem horizontal não serão exibidas independentemente da configuração da ScrollBars propriedade.
Observação
Na classe derivada, TextBoxo texto dentro do controle sempre será encapsulado independentemente da configuração da propriedade dessa propriedade, a menos que a TextAlign propriedade esteja definida como HorizontalAlignment.Left
.