MaskedTextBox.SkipLiterals Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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, set
Public Property SkipLiterals As Boolean

Valore della proprietà

Boolean

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.

Si applica a

Vedi anche