バージョン

xamNumericInput の使用

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

目的

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

前提条件

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

xamNumericInput の構成の概要

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

以下の表は、xamNumericInput コントロールの構成可能な動作の一部を示しています。

構成可能な動作 構成の詳細 構成プロパティ

xamNumericInput コントロールをアプリケーションに追加

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

なし

xamNumericInput の修正

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

xamNumericInput コントロールをアプリケーションに追加

xamNumericInput コントロールをアプリケーションの詳細に追加

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

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

xamNumericInput コントロールをアプリケーションに追加するには、以下の NuGet パッケージへの参照をプロジェクトに追加する必要があります。

  • Infragistics.WPF.Controls.Editors.XamMaskedInput

    NuGet フィードのセットアップと NuGet パッケージの追加の詳細については、NuGet フィード ドキュメントを参照してください。

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

XAML の場合:

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

Visual Basic の場合:

Imports Infragistics.Controls.Editors

C# の場合:

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

XAML の場合:

<ig:XamNumericInput/>

Visual Basic の場合:

Dim input As XamNumericInput = New XamNumericInput()

C# の場合:

XamNumericInput NumericInput = new XamNumericInput();

xamNumericInput の修正

xamNumericInput プロパティ設定の修正

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

xamNumericInput の詳細を修正

  1. Mask の設定

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

XAML の場合:

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

Visual Basic の場合:

NumericInput.Mask = "[Your Mask]"

C# の場合:

NumericInput.Mask = "[Your Mask]";

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

  1. 無効な場合は、入力された値を取り消します。

ユーザーが無効な値を入力したときの xamNumericInput の動作方法には、複数のオプションがあります。InvalidValueBehavior プロパティを RevertValue に設定すると、ユーザーが無効な値を入力して入力コントロールを終了すると、常にその値は元の値に戻ります。

  1. すべての追加記号を含め、ユーザーはコントロールのコンテンツをコピーできます。

ClipMode プロパティを IncludeBoth に設定すると、すべてのプロンプト文字とマスク リテラルを含む、入力コントロールのコンテンツがクリップボードにコピーされます。

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

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

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

xamNumericInput で使用されるデフォルトのプロンプト文字は下線ですが、PromptChar プロパティを自分が選択した文字に設定することによって、この動作を変更することができます。

  1. 値を増加/減少するためのボタンを表示します。

xamNumericInput コントロールの値を増加または減少させるためのボタンを表示したい場合、SpinButtonDisplayMode を Always、Focused、または MouseOver に設定する必要があります。

  1. 増加値の変更。

SpinIncrement プロパティを指定しない場合は、SpinButtons がクリックされたときに使用されるデフォルトの増加/減少値は 1 になります。ただし、別の値を使用したい場合は、SpinIncrement として希望の値を設定することによって、値を変えることができます。

  1. 値の最後にある小数のゼロを保持するように入力を設定します。

xamNumericInput コントロールの値の小数の場所の最後のゼロを表示したい場合は、TrimFractionalZeros プロパティを False に設定します。

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

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

注:

Note

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

xamNumericInput の修正例

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

プロパティ

設定

{double:-5.3:c}

RevertValue

IncludeBoth

Enter double

n

Focused

0.01

False

編集モード:

表示モード:

xamInputs xamNumericInput Using 2.png
xamInputs xamNumericInput Using 1.png

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

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