Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

MaskDisplayMode Property (UltraDateTimeEditor)

Gets/sets the mask that is applied to the text displayed by the control when the control does not have the input focus.
Syntax
'Declaration
 
Public Property MaskDisplayMode As Infragistics.Win.UltraWinMaskedEdit.MaskMode
public Infragistics.Win.UltraWinMaskedEdit.MaskMode MaskDisplayMode {get; set;}
Remarks

This property is used to determine how mask literals and prompt characters are displayed when the control is not in edit mode. Based on the setting of this property, the text of the control will contain no prompt characters or literals (just the raw data), the data and just the literals, the data and just the prompt characters, or all the text including both prompt characters and literals. The formatted spacing of partially masked values can be preserved by indicating to include literals with padding, which includes data and literal characters, but replaces prompt characters with pad characters (usually spaces).

Generally, prompt characters disappear when the control does not have the input focus, as a visual cue to the user. In some cases, however, it may be appropriate in your application to display mask literals as well as data when the control does not have the input focus.

Note: Since the MaskDisplayMode property could potentially conflict with the control's FormatString property, the MaskDisplayMode property is not applicable when the control's FormatString property is set to a non-empty string.

Example
This example sets the masking-related properties of the UltraDateTimeEditor, UltraNumericEditor, and UltraCurrencyEditor controls.

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 = ' ';

		}
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also