バージョン

xamMaskedInput コントロールの代わりに xamMaskedEditor コントロールを使用してください。xamMaskedInput は数年内に廃止する予定のため、新しい機能の追加はありません。xamMaskedInput のサポートおよび重要なバグ修正は廃止時まで提供されます。コードベースの xamMaskedEditorへの移動に関する質問は、サポートまでお問い合わせてください。

xamMaskedInput の使用

トピックの概要

目的

このトピックでは、xamMaskedInput コントロールをアプリケーションに追加し、その有益なプロパティを使用する方法について説明します。

必要な背景

まず以下のトピックを読む必要があります。

xamMaskedInput の構成の概要

コントロールの構成チャート

以下の表は、xamMaskedInput コントロールの構成可能ないくつかの動作を示しています。

構成可能な動作

構成の詳細

構成プロパティ

xamMaskedInput をアプリケーションに追加

xamMaskedInput コントロールをアプリケーションに追加するために必要な手順

なし

xamMaskedInput を修正

コントロールの主なプロパティの一部を構成します。

xamMaskedInput をアプリケーションに追加

  1. Infragistics 名前空間を追加します。

    1. 必要な参照を追加します

xamMaskedInput コントロールをアプリケーションに追加するには、以下のアセンブリをプロジェクトに追加する必要があります:

  • InfragisticsWPF4.Controls.Editors.XamMaskedInput.v20.1.dll

  • InfragisticsWPF4.v20.1.dll

    1. Infragistics 名前空間を追加します

XAML の場合:

xmlns:ig=http://schemas.infragistics.com/xaml

Visual Basic の場合:

Imports Infragistics.Controls.Editors

C# の場合:

using Infragistics.Controls.Editors;
  1. xamMaskedInput コントロールを追加します。

XAML の場合:

<ig:XamMaskedInput/>

Visual Basic の場合:

Dim maskedInput As XamMaskedInput = New XamMaskedInput()

C# の場合:

XamMaskedInput maskedInput = new XamMaskedInput();

xamMaskedInput を修正

以下の表は、プロパティ設定の推奨構成をマップしています。プロパティは xamMaskedInput コントロールから直接アクセスします。

xamMaskedInput の詳細を修正

  1. Mask の設定

入力コントロールの設定の最も重要な要素は、Mask プロパティの構成です。によって、自分のニーズに合ったマスクを設定します:

XAML の場合:

<ig:XamMaskedInput Mask="[Your Mask]"/>

Visual Basic の場合:

maskedInput.Mask = "[Your Mask]"

C# の場合:

maskedInput.Mask = "[Your Mask]";

マスクの作成方法の詳細は、 マスクトピックを参照してください。

  1. 有効ではない場合でも、入力された値を保持します

ユーザーが無効な値を入力したときの xamMaskedInput の動作方法に関して、複数のオプションがあります。InvalidValueBehavior プロパティを RetainValue に設定した場合、ユーザーが無効な値を入力してから入力コントロールを終了しようとすると、その値は保持されます。

  1. ユーザーにマスクのリテラルをクリップボードにコピーさせ、値と共にパッドします

ClipMode プロパティを IncludeLiteralsWithPadding に設定することによって、ユーザーが入力内容をクリップボードにコピーすると、その値はマスク リテラルおよびパディングと共にコピーされます。

  1. 値が null の場合、特定の文字列を表示します

コントロールに値が入力されない場合、または値が null 値にバインドされている場合、表示される文字列を設定することができます。NullText プロパティを希望の文字列に設定することで、これを実行することができます。このように、入力内容や、値が入力されていないことを明示的にユーザーに知らせることができます。

  1. 下線以外の様々なプロンプト文字を表示します

xamMaskedInput で使用されるデフォルトのプロンプト文字は下線ですが、PromptChar プロパティを希望の文字に設定することでこの動作を変更することができます。

  1. 元に戻す/やり直し操作を有効/無効にします。

xamInputs は CTRL + Z および CTRL + Y キーの組み合わせによってトリガーされた元に戻す/やり直し操作をデフォルトでサポートします。この機能を無効にするには、IsUndoEnabled プロパティを False に設定します。

注:

Note

IsUndoEnabled プロパティを無効にすると、元に戻す/やり直すスタックをクリアします。元に戻す/やり直すを無効にした後に再び有効にする場合、元に戻す/やり直すの履歴がクリアされるためコマンドは実行されません。

xamMaskedInput の修正例

以下の画像は、以下の設定の結果として、編集モードと表示モードの xamMaskedInput コントロールを示しています。

プロパティ

設定

>aaaa (XAML に設定した場合)

>aaaa (プロシージャー コードに設定した場合)

RetainValue

IncludeLiteralsWithPadding

コードの入力

~

編集モード:

表示モード:

xamInputs xamMaskedInput Using 2.png
xamInputs xamMaskedInput Using 1.png

xamMaskedInput プロパティの参照の修正

これらのプロパティの詳細情報は、プロパティ参照セクションのリストを参照してください。