'宣言 Public Property MaskDisplayMode As Infragistics.Win.UltraWinMaskedEdit.MaskMode
public Infragistics.Win.UltraWinMaskedEdit.MaskMode MaskDisplayMode {get; set;}
このプロパティは、コントロールが編集モードでないときにマスクのリテラルとプロンプト文字がどのように表示されるかを決定します。コントロールに表示されるテキストは、このプロパティの設定に基づいて次のいずれかになります。すなわち、プロンプト文字もリテラルも一切含まない(rawデータのみ)、データとリテラルのみを含む、データとプロンプト文字のみを含む、またはプロンプト文字もリテラルも含むテキスト全体のいずれかです。部分的マスク値の書式設定されたスペースは、リテラルをパディングと共に含むよう指定することで保持できます。 この場合、データとリテラル文字は含まれますが、プロンプト文字はスペースに置き換えられます。
通常、コントロールが編集モードでなくなると、ユーザーへの視覚的な合図として、プロンプト文字は非表示になります。ただしアプリケーションによっては、コントロールが編集モードでなくなっても、データと共にマスクのリテラルも表示する方が適切な場合があります。
MaskInput プロパティは、データ入力がコントロールでマスクされる方法を指定するために使用されます。マスクには通常、ユーザーが入力するデータを区切るためのリテラル文字が含まれます。このプロパティは、MaskInput プロパティが設定されている(つまり、データ マスキングが有効である)場合以外は効果がありません。
データ マスキングが有効である場合、MaskClipMode プロパティはどのようにコントロールの内容がクリップボードにコピーされるかを決定し、MaskDataMode プロパティはコントロールの内容が Value プロパティによってどのように返されるかを示します。
Imports Infragistics.Win Imports Infragistics.Win.UltraWinEditors Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click Me.SetupMasking() End Sub Private Sub SetupMasking() ' Set the UltraDateTimeEditor to display the 2-digit representation of the year Me.UltraDateTimeEditor1.MaskInput = "mm/dd/yy" ' Set the UltraNumericEditor to display a thousands separator Me.UltraNumericEditor1.MaskInput = "n,nnn,nnn" ' Set the UltraCurrencyEditor to display a thousands separator, ' and no currency symbol Me.UltraCurrencyEditor1.MaskInput = "n,nnn.nn" ' Set the masking modes of the UltraDateTimeEditor to include literals, ' because the "/" character is part of the data in that it separates the ' components of the date (year, month, day) Me.UltraDateTimeEditor1.MaskDataMode = MaskMode.IncludeLiterals Me.UltraDateTimeEditor1.MaskClipMode = MaskMode.IncludeLiterals Me.UltraDateTimeEditor1.MaskDisplayMode = MaskMode.IncludeLiterals ' For the UltraNumericEditor and UltraCurrencyEditor, we don't ' want the thousands separator to be considered part of the data, ' so set the MaskDataMode to Raw. For the clipboard and display, ' however, we will display the literals. Me.UltraNumericEditor1.MaskDataMode = MaskMode.Raw Me.UltraNumericEditor1.MaskClipMode = MaskMode.IncludeLiterals Me.UltraNumericEditor1.MaskDisplayMode = MaskMode.IncludeLiterals Me.UltraCurrencyEditor1.MaskDataMode = MaskMode.Raw Me.UltraCurrencyEditor1.MaskClipMode = MaskMode.IncludeLiterals Me.UltraCurrencyEditor1.MaskDisplayMode = MaskMode.IncludeLiterals ' Set the PromptChar to the space character for all Me.UltraDateTimeEditor1.PromptChar = Chr(32) Me.UltraNumericEditor1.PromptChar = Chr(32) Me.UltraCurrencyEditor1.PromptChar = Chr(32) End Sub
using System.Diagnostics; using Infragistics.Win; using Infragistics.Win.UltraWinEditors; private void button1_Click(object sender, System.EventArgs e) { this.SetupMasking(); } private void SetupMasking() { // Set the UltraDateTimeEditor to display the 2-digit representation of the year this.ultraDateTimeEditor1.MaskInput = "mm/dd/yy"; // Set the UltraNumericEditor to display a thousands separator this.ultraNumericEditor1.MaskInput = "n,nnn,nnn"; // Set the UltraCurrencyEditor to display a thousands separator, // and no currency symbol this.ultraCurrencyEditor1.MaskInput = "n,nnn.nn"; // Set the masking modes of the UltraDateTimeEditor to include literals, // because the "/" character is part of the data in that it separates the // components of the date (year, month, day) this.ultraDateTimeEditor1.MaskDataMode = MaskMode.IncludeLiterals; this.ultraDateTimeEditor1.MaskClipMode = MaskMode.IncludeLiterals; this.ultraDateTimeEditor1.MaskDisplayMode = MaskMode.IncludeLiterals; // For the UltraNumericEditor and UltraCurrencyEditor, we don't // want the thousands separator to be considered part of the data, // so set the MaskDataMode to Raw. For the clipboard and display, // however, we will display the literals. this.ultraNumericEditor1.MaskDataMode = MaskMode.Raw; this.ultraNumericEditor1.MaskClipMode = MaskMode.IncludeLiterals; this.ultraNumericEditor1.MaskDisplayMode = MaskMode.IncludeLiterals; this.ultraCurrencyEditor1.MaskDataMode = MaskMode.Raw; this.ultraCurrencyEditor1.MaskClipMode = MaskMode.IncludeLiterals; this.ultraCurrencyEditor1.MaskDisplayMode = MaskMode.IncludeLiterals; // Set the PromptChar to the space character for all this.ultraDateTimeEditor1.PromptChar = ' '; this.ultraNumericEditor1.PromptChar = ' '; this.ultraCurrencyEditor1.PromptChar = ' '; }