バージョン

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

xamDateTimeInput の使用

目的

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

前提条件

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

xamDateTimeInput の構成の概要

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

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

構成可能な動作

構成の詳細

構成プロパティ

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

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

なし

xamDateTimeInput の修正

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

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

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

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

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

  • Infragistics.WPF.Controls.Editors.XamDateTimeInput

    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. xamDateTimeInput コントロールを追加します。

XAML の場合:

<ig:XamDateTimeInput/>

Visual Basic の場合:

Dim input As XamDateTimeInput = New XamDateTimeInput()

C# の場合:

XamDateTimeInput DateTimeInput = new XamDateTimeInput();

xamDateTimeInput の修正

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

xamDateTimeInput の詳細を修正

  1. Mask の設定

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

XAML の場合:

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

Visual Basic の場合:

DateTimeInput.Mask = "[Your Mask]"

C# の場合:

DateTimeInput.Mask = "[Your Mask]";

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

  1. 無効な値が入力されたときにエラー メッセージを表示します。

ユーザーが無効な値を入力したときの xamDateTimeInput の動作方法には、複数のオプションがあります。InvalidValueBehavior プロパティを DisplayErrorMessage に設定した場合、ユーザーが無効な値を入力してから入力コントロールを終了しようとすると、常にエラー メッセージの詳細が表示されます。

  1. xamDateTimeInput が月と年を自動的に埋めるようにします。

AutoFillDate プロパティが MonthAndYear に設定されている場合、ユーザーが日付の日の部分に値を入力しからコントロールを終了すると、月と年の部分は現在の月と年で自動的に埋められます。同様に、AutoFillDate を Year に設定した場合、日と月を入力してユーザーがコントロールを終了すると、年は自動的に埋められます。

デフォルトで、マウス オーバーするとカレンダー ドロップダウン ボタンが表示されます。これを常に可視にするには、DropDownButtonDisplayMode を Always に設定します。3 番目のオプション、Focused を使用すると、コントロールにフォーカスがある場合にのみ、カレンダー ドロップダウン ボタンが表示されます。

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

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

  1. 増加値の変更。

SpinIncrement プロパティを指定しない場合、テキスト カーソルがある日付/時刻の部分の値が 1 つ増加/減少します。たとえば、テキスト カーソルが日付/時刻値の秒の部分にあり、エンドユーザーが増加ボタンをクリックすると、値は 1 秒増加します。ただし、SpinIncrement に、2 日などの特定の値を指定することができます。これを実現するには、SpinIncrement を「2d」に設定します。可能性のあるその他のパターンは、上記のプロパティ設定テーブルに示されています。また、コード ビハインドでは、SpinIncrement property を特定の TimeSpan 構造体オブジェクトに設定することができます。

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

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

注:

Note

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

xamDateTimeInput の修正例

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

プロパティ

設定

mm/dd/yyyy hh:mm:ss

DisplayErrorMessage

MonthAndYear

Always

Focused

1m

編集モード:

表示モード:

xamInputs xamDateTimeInput Using 2.png
xamInputs xamDateTimeInput Using 1.png

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

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