MaskClipMode プロパティ (UltraNumericEditorBase)

クリップボードにコピーする時に、コントロールのテキストに適用するマスクを取得または設定します。

シンタックス

Visual Basic

'宣言
 
Public Property MaskClipMode As Infragistics.Win.UltraWinMaskedEdit.MaskMode

C#

public Infragistics.Win.UltraWinMaskedEdit.MaskMode MaskClipMode {get; set;}

解説

このプロパティは、コントロールのテキストを Windows のクリップボードにコピーするときに、マスクのリテラルとプロンプト文字がどのように処理されるかを決定します。クリップボードのテキストは、このプロパティの設定に基づいて次のいずれかになります。 すなわち、プロンプト文字もリテラルも一切含まない (生データのみ) 、データとリテラルのみを含む、データとプロンプト文字のみを含む、またはプロンプト文字もリテラルも含むテキスト全体のいずれかです。部分的マスク値の書式設定されたスペースは、リテラルをパディングと共に含むよう指定することで保持できます。 この場合、データとリテラル文字は含まれますが、プロンプト文字はスペースに置き換えられます。

MaskInput プロパティは、データ入力がコントロールでマスクされる方法を指定するために使用されます。マスクには通常、ユーザーが入力するデータを区切るためのリテラル文字が含まれます。このプロパティは、MaskInput プロパティが設定されている (つまり、データマスキングが有効である) 場合以外は効果がありません。

データ マスキングが有効である場合、MaskDataMode プロパティはどのようにコントロールの内容がコントロールの Value プロパティによって返されるかを決定し、MaskDisplayMode プロパティはコントロールの内容がどのように表示されるかを示します。

使用例

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

		}