xamDateTimeInput の使用

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

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

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

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

XAML の場合:

Visual Basic の場合:

C# の場合:

XAML の場合:

Visual Basic の場合:

C# の場合:

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

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

XAML の場合:

Visual Basic の場合:

C# の場合:

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

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

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

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

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

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

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

注:

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

以下は、その他の役立つトピックです。