MaskInput プロパティ (UltraNumericEditorBase)

コントロールで使用される入力マスクを返すか、設定します。

シンタックス

Visual Basic

'宣言
 
Public Overridable Property MaskInput As String

C#

public virtual string MaskInput {get; set;}

解説

データを入力するときはプレースホルダ文字が表示され、ユーザーは入力マスクに指定された文字と同じタイプの文字を使用してプレースホルダを置き換えることができます。コントロールは数字やアルファベットなどの文字の種類は検証できますが、正確な月や日時というような内容の有効性は検証できません。

データマスキングを有効にすると、MaskClipMode プロパティによって、コントロールの内容をクリップボードにコピーする方法を指定できます。 また、MaskDataMode プロパティによって、コントロールの内容が Value プロパティからどのように返されるかを指定し、MaskDisplayMode プロパティによってセル値の表示方法を指定できます。

Character	説明
{double:i.f:c}	{double:i.f:c}は、浮動小数点の入力を許可するマスクのプレースホルダです。iとi.fのfは、それぞれ整数部分の桁数と小数部分の桁数を指定します。マスクの :c 部分はオプションで、値の整数部分と小数部分を連続して入力することを指定します。たとえば、マスクに :c を指定した場合、12.34 と入力するためには、ユーザーは「1234」とキー入力します。小数点区切り文字を入力しない点に注意してください。このように設定すると、ユーザーは小数点区切り文字を入力する必要がなくなります。
{double:-i.f:c}	負の数を指定できることを除いて double:i.f:c と同じです。
{currency:-i.f:c}	基になる書式プロバイダーまたはカルチャの現在の書式設定情報に基づいてマスクが構成される点以外は{double:i.f:c} と同じです。通常は通貨記号を含み、桁区切り文字も表示します。
{currency:-i.f:c}	負の数を指定できることを除いて currency:i.f:c と同じです。
。	小数のプレースホルダ。実際に使用される文字は、システムの国際設定によって小数のプレースホルダに指定されたものです。この文字はマスク用のリテラルとして扱われます。
,	千の位の区切り記号。実際に使用される文字は、システムの国際設定によって千の位の区切り文字に指定されたものです。この文字はマスク用のリテラルとして扱われます。
-	マイナス記号の後に一連の 'n' によって数字セクションを定義した場合 (例: "-nn,nnn.nn") は、負の数を指定できることを示します。'n' が後に続かない場合はリテラルと見なされます。マイナス記号は数が実際に負の場合のみ表示されます。
+	プラス記号の後に一連の 'n' によって数字セクションを定義した場合 (例："-nn,nnn.nn") は、負の数を指定できることを示します。"-"との違いは、数が正か負かに基づいて常に '+' または '-' 記号が表示されるという点です。
n	数字のプレースホルダ。n のグループを使用して、数字が右から左に入力される数字セクションを作成できます。文字は数字 (0 から 9) である必要がありますが、入力は必須ではありません。
リテラル	上記以外の記号はすべてリテラルとして (つまり、その記号自体として) 表示されます。

使用例

Visual Basic

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

C#

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

		}