ClipMode プロパティ

データ マスキングが有効なときに、コントロールのコンテンツをどのようにクリップボードにコピーするのかを決める値を設定します。

シンタックス

Visual Basic

'宣言
 
Public Property ClipMode As MaskMode

C#

public MaskMode ClipMode {get; set;}

解説

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

使用例

Visual Basic

Private Sub Button1_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.maskedEditor1.Mask = "###-##-####"
    Me.maskedEditor1.Value = "111-22-"
    Me.maskedEditor1.StartEditMode()
    Me.maskedEditor1.SelectAll()

    Me.maskedEditor1.ClipMode = MaskMode.Raw
    Debug.WriteLine("SelectedText with Raw clip mode = '" & Me.maskedEditor1.SelectedText & "'")

    Me.maskedEditor1.ClipMode = MaskMode.IncludeLiterals
    Debug.WriteLine("SelectedText with IncludeLiterals clip mode = '" & Me.maskedEditor1.SelectedText & "'")

    Me.maskedEditor1.ClipMode = MaskMode.IncludePromptChars
    Debug.WriteLine("SelectedText with IncludeLiterals clip mode = '" & Me.maskedEditor1.SelectedText & "'")

    Me.maskedEditor1.ClipMode = MaskMode.IncludeLiteralsWithPadding
    Debug.WriteLine("SelectedText with IncludeLiteralsWithPadding clip mode = '" & Me.maskedEditor1.SelectedText & "'")

    Me.maskedEditor1.ClipMode = MaskMode.IncludeBoth
    Debug.WriteLine("SelectedText with IncludeBoth clip mode = '" & Me.maskedEditor1.SelectedText & "'")
End Sub

C#

public void button1_Click( object sender, RoutedEventArgs e )
{
	this.maskedEditor1.Mask = "###-##-####";
	this.maskedEditor1.Value = "111-22-";
	this.maskedEditor1.StartEditMode( );
	this.maskedEditor1.SelectAll( );
	
	this.maskedEditor1.ClipMode = MaskMode.Raw;
	Debug.WriteLine( "SelectedText with Raw clip mode = '" + this.maskedEditor1.SelectedText + "'" );

	this.maskedEditor1.ClipMode = MaskMode.IncludeLiterals;
	Debug.WriteLine( "SelectedText with IncludeLiterals clip mode = '" + this.maskedEditor1.SelectedText + "'" );

	this.maskedEditor1.ClipMode = MaskMode.IncludePromptChars;
	Debug.WriteLine( "SelectedText with IncludeLiterals clip mode = '" + this.maskedEditor1.SelectedText + "'" );

	this.maskedEditor1.ClipMode = MaskMode.IncludeLiteralsWithPadding;
	Debug.WriteLine( "SelectedText with IncludeLiteralsWithPadding clip mode = '" + this.maskedEditor1.SelectedText + "'" );

	this.maskedEditor1.ClipMode = MaskMode.IncludeBoth;
	Debug.WriteLine( "SelectedText with IncludeBoth clip mode = '" + this.maskedEditor1.SelectedText + "'" );
}

XAML

<igEditors:XamMaskedEditor x:Name="maskedEditor1"  />