MaskedTextBox.SkipLiterals 屬性

  • 參考

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll

取得或設定值，指出是否允許使用者重新輸入常值。

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

屬性值

Boolean

true 表示允許重新輸入常值，否則為 false，表示防止使用者覆寫常值字元。 預設為 true。

備註

輸入遮罩通常包含常值。 當使用者在執行時間輸入字元時 MaskedTextBox ，目前的字元位置有時會落在常值上。 屬性 SkipLiterals 描述如何處理下一個字元的使用者輸入，如下所示：

  • 如果此屬性為 true ，則使用者可以重複輸入與目前位置常值相同的字元，也可以輸入下一個可編輯的字元，藉此將目前位置跳至該位置。

  • 如果此屬性為 false ，則使用者只能輸入下一個可編輯的字元。 例如，如果遮罩中的下一個位置不接受常值字元 (，則使用者輸入 「/」 且下一個位置只接受數位) ，控制項會引發 MaskInputRejected 事件。

例如，在 「90/90/0000」 日期專案遮罩中，正斜線字元是常值。 假設使用者已輸入兩個初始數位 「11」，因此遮罩中的目前位置位於第一個正斜線 (/) 常值。 如果 為 SkipLiteralstrue ，則使用者具有下列有效選擇：

  • 使用者可以輸入 「/」 字元。 這會導致位置移至下一個字元，在此範例中為第四個位置，即 9 個遮罩元素。

  • 使用者可以輸入下一個可編輯的字元，在此範例中為數字。 數位會經過驗證，而且目前的位置會自動移至第五個位置，也就是 0 個遮罩元素。

如果 SkipLiterals 為 false ，則只允許有效的資料輸入，在此範例中為數字。

適用於

另請參閱