MaskedTextBox.SkipLiterals Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che indica se all'utente è consentita la reimmissione di valori letterali.
public:
property bool SkipLiterals { bool get(); void set(bool value); };public bool SkipLiterals { get; set; }member this.SkipLiterals : bool with get, setPublic Property SkipLiterals As BooleanValore della proprietà
true per consentire la reimmissione dei valori letterali; in caso contrario, false per impedire la sovrascrittura dei caratteri letterali. Il valore predefinito è true.
Commenti
Le maschere di input contengono in genere valori letterali. Quando l'utente immette caratteri in MaskedTextBox fase di esecuzione, la posizione del carattere corrente a volte rientra in un valore letterale. La SkipLiterals proprietà descrive come deve essere gestito l'input dell'utente per il carattere successivo, come indicato di seguito:
Se questa proprietà è
true, l'utente può immettere in modo ridondante lo stesso carattere del valore letterale nella posizione corrente oppure può immettere il carattere modificabile successivo, passando così la posizione corrente a tale posizione.Se questa proprietà è
false, l'utente può immettere solo il carattere modificabile successivo. Se la posizione successiva nella maschera non accetterà il carattere letterale ( ad esempio, l'utente digita "/" e la posizione successiva accetta solo cifre), il controllo genererà l'evento MaskInputRejected .
Ad esempio, nella maschera di immissione della data "90/90/0000", i caratteri barra sono valori letterali. Si supponga che l'utente abbia immesso due cifre iniziali, "11", quindi la posizione corrente nella maschera si trova al primo valore letterale barra (/). Se SkipLiterals è true, l'utente ha le opzioni valide seguenti:
L'utente può immettere un carattere "/". Ciò comporta lo spostamento della posizione al carattere successivo, che in questo esempio è la quarta posizione, un elemento mascheramento 9.
L'utente può immettere il carattere modificabile successivo, che in questo esempio è una cifra. La cifra viene convalidata e la posizione corrente viene automaticamente spostata nella quinta posizione, ovvero un elemento mascheramento 0.
Se SkipLiterals è false, è consentito solo un input di dati valido, che in questo esempio sarebbe una cifra.
