MaskedTextBox.SkipLiterals Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob literale Werte erneut eingegeben werden können, oder legt diesen fest.

public:
 property bool SkipLiterals { bool get(); void set(bool value); };
public bool SkipLiterals { get; set; }
member this.SkipLiterals : bool with get, set
Public Property SkipLiterals As Boolean

Eigenschaftswert

Boolean

true, damit Literale erneut eingegeben werden können, andernfalls false, damit Literalzeichen nicht überschrieben werden können. Der Standardwert ist true.

Hinweise

Eingabemasken enthalten in der Regel Literale. Wenn der Benutzer zur Laufzeit Zeichen in eingibt MaskedTextBox , fällt die aktuelle Zeichenposition manchmal auf ein Literal. Die SkipLiterals -Eigenschaft beschreibt, wie Benutzereingaben für das nächste Zeichen wie folgt behandelt werden sollen:

  • Wenn diese Eigenschaft ist true, kann der Benutzer entweder redundant dasselbe Zeichen wie das Literal an der aktuellen Position eingeben oder das nächste bearbeitbare Zeichen eingeben, wodurch die aktuelle Position zu dieser Position springt.

  • Wenn diese Eigenschaft ist false, kann der Benutzer nur das nächste bearbeitbare Zeichen eingeben. Wenn die nächste Position in der Maske das Literalzeichen nicht akzeptiert (z. B. gibt der Benutzer "/" ein, und die nächste Position akzeptiert nur Ziffern), löst das Steuerelement das MaskInputRejected -Ereignis aus.

Im Datumseintragsformat "90/90/0000" sind beispielsweise die Schrägstrichzeichen Literale. Angenommen, der Benutzer hat zwei Anfangsziffern eingegeben, "11", sodass sich die aktuelle Position in der Maske am ersten Schrägstrich (/) befindet. Wenn SkipLiterals ist true, hat der Benutzer die folgenden gültigen Optionen:

  • Der Benutzer kann ein "/"-Zeichen eingeben. Dies führt dazu, dass die Position in das nächste Zeichen verschoben wird, das in diesem Beispiel die vierte Position ist, ein Maskierungselement mit 9.

  • Der Benutzer kann das nächste bearbeitbare Zeichen eingeben, das in diesem Beispiel eine Ziffer ist. Die Ziffer würde überprüft, und die aktuelle Position würde automatisch an die fünfte Position verschoben, die ein Maskierungselement 0 ist.

Wenn SkipLiterals ist false, ist nur eine gültige Dateneingabe zulässig, die in diesem Beispiel eine Ziffer wäre.

Gilt für:

Weitere Informationen