TextBox.MaxLines Propriedade

Definição

Obtém ou define o número máximo de linhas visíveis ao qual deve ser dimensionado.

public:
 property int MaxLines { int get(); void set(int value); };
public int MaxLines { get; set; }
member this.MaxLines : int with get, set
Public Property MaxLines As Integer

Valor da propriedade

O número máximo de linhas visíveis. O padrão é Int32.MaxValue.

Exceções

MaxLines é menor que MinLines.

Exemplos

O exemplo a seguir mostra como criar um TextBox com um MaxLines valor de 5.

<Page  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <StackPanel>
    <TextBox 
      Text="Initial text in TextBox" 
      Width="200" 
      TextAlignment="Center"
      TextWrapping="Wrap" 
      MaxLength="500"
      MinLines="1" 
      MaxLines="5" />
  </StackPanel>
</Page>
StackPanel myStackPanel = new StackPanel();

//Create TextBox
TextBox myTextBox = new TextBox();
myTextBox.Width = 200;

// Put some initial text in the TextBox.
myTextBox.Text = "Initial text in TextBox";

// Set the maximum characters a user can manually type
// into the TextBox.
myTextBox.MaxLength = 500;
myTextBox.MinLines = 1;

// Set the maximum number of lines the TextBox will expand to 
// accomidate text. Note: This does not constrain the amount of 
// text that can be typed. To do that, use the MaxLength property.
myTextBox.MaxLines = 5;

// The text typed into the box is aligned in the center.
myTextBox.TextAlignment = TextAlignment.Center;

// When the text reaches the edge of the box, go to the next line.
myTextBox.TextWrapping = TextWrapping.Wrap;

myStackPanel.Children.Add(myTextBox);
this.Content = myStackPanel;
Dim myStackPanel As New StackPanel()

'Create TextBox
Dim myTextBox As New TextBox()
myTextBox.Width = 200

' Put some initial text in the TextBox.
myTextBox.Text = "Initial text in TextBox"

' Set the maximum characters a user can manually type
' into the TextBox.
myTextBox.MaxLength = 500
myTextBox.MinLines = 1

' Set the maximum number of lines the TextBox will expand to 
' accomidate text. Note: This does not constrain the amount of 
' text that can be typed. To do that, use the MaxLength property.
myTextBox.MaxLines = 5

' The text typed into the box is aligned in the center.
myTextBox.TextAlignment = TextAlignment.Center

' When the text reaches the edge of the box, go to the next line.
myTextBox.TextWrapping = TextWrapping.Wrap

myStackPanel.Children.Add(myTextBox)
Me.Content = myStackPanel

Comentários

Obter essa propriedade retorna o valor atual de MaxLines. Definir essa propriedade fará com que a caixa de texto seja redimensionada se o número de linhas visíveis exceder o limite especificado por MaxLines.

Essa propriedade se aplica apenas a linhas visíveis e não restringe o número real de linhas. Dependendo de sua configuração, uma caixa de texto pode conter linhas adicionais não visíveis que podem ser acessadas pela rolagem.

Se a Height propriedade for definida explicitamente em um TextBox, os valores de MaxLines propriedade e MinLines serão ignorados.

Informações da propriedade de dependência

Campo Identificador MaxLinesProperty
Propriedades de metadados definidas como true AffectsMeasure

Aplica-se a

Confira também