MaskedTextBox.ResetOnPrompt Eigenschaft
Definition
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 einen Wert ab, der bestimmt, wie ein dem Aufforderungszeichen entsprechendes Eingabezeichen behandelt werden soll, oder legt diesen Wert fest.
public:
property bool ResetOnPrompt { bool get(); void set(bool value); };
public bool ResetOnPrompt { get; set; }
member this.ResetOnPrompt : bool with get, set
Public Property ResetOnPrompt As Boolean
Eigenschaftswert
true
, wenn die Eingabe des Aufforderungszeichens die Zurücksetzung der aktuellen bearbeitbaren Position in der Maske zur Folge hat, andernfalls false
, um anzugeben, dass das Aufforderungszeichen wie ein normales Eingabezeichen verarbeitet werden soll. Der Standardwert ist true
.
Hinweise
Die MaskedTextBox kann zwei Kategorien von Zeichen behandeln - Leerzeichen und Eingabeaufforderungszeichen - speziell. In der Regel wird jedes Eingabezeichen anhand der Maske getestet und entweder akzeptiert oder abgelehnt. Wenn die PromptChar -Eigenschaft auf "nicht"null
festgelegt ist, führt das Festlegen der ResetOnPrompt Eigenschaft auf zu true
einer speziellen Verarbeitung für das Eingabeaufforderungszeichen. Wenn der Benutzer das Eingabeaufforderungszeichen in die Maske eingibt, wird die aktuelle Maskenzeichenposition gelöscht und die aktuelle Position zum nächsten bearbeitbaren Zeichen erweitert.
ResetOnPrompt hat Vorrang vor der AllowPromptAsInput -Eigenschaft, wie in der folgenden Tabelle gezeigt.
ResetOnPrompt-Wert | AllowPromptAsInput-Wert | Resultierendes Verhalten |
---|---|---|
true |
true |
Das Eingabeaufforderungszeichen kann eingegeben werden und bewirkt, dass die aktuelle Maskenposition zurückgesetzt wird. Dies ist die Standardoption. |
true |
false |
Das Eingabeaufforderungszeichen kann eingegeben werden und bewirkt, dass die aktuelle Maskenposition zurückgesetzt wird. |
false |
true |
Das Eingabeaufforderungszeichen wird als Standardeingabezeichen verarbeitet. |
false |
false |
Das Eingabeaufforderungszeichen ist ungültig und löst ein Ereignis aus MaskInputRejected . |