TextBox.MaxLines Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die maximale Anzahl sichtbarer Zeilen ab oder legt diese fest.

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

Eigenschaftswert

Int32

Die maximale Anzahl sichtbarer Zeilen. Der Standardwert ist Int32.MaxValue.

Ausnahmen

Exception

MaxLines ist kleiner als MinLines.

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein TextBox mit dem MaxLines Wert 5 erstellt wird.

<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

Hinweise

Beim Abrufen dieser Eigenschaft wird der aktuelle Wert von MaxLineszurückgegeben. Durch Festlegen dieser Eigenschaft wird die Größe des Textfelds geändert, wenn die Anzahl der sichtbaren Zeilen den von MaxLinesangegebenen Grenzwert überschreitet.

Diese Eigenschaft gilt nur für sichtbare Linien und schränkt die tatsächliche Anzahl von Zeilen nicht ein. Je nach Konfiguration kann ein Textfeld zusätzliche nicht sichtbare Zeilen enthalten, auf die durch Scrollen zugegriffen werden kann.

Wenn die Height -Eigenschaft explizit für ein TextBoxfestgelegt ist, werden die MaxLines Eigenschaftswerte und MinLines ignoriert.

Informationen zur Abhängigkeitseigenschaft


Bezeichnerfeld	MaxLinesProperty
Metadateneigenschaften auf `true` festgelegt	AffectsMeasure

Gilt für:

Freigeben über