Freigeben über


MaskedTextBox.ResetOnPrompt Eigenschaft

Definition

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 .

Gilt für:

Weitere Informationen