ユーザーが日付を選択できるコントロール。
Description
テキスト入力コントロールではなく日付選択コントロールを追加する場合は、ユーザーが正しい形式で日付を指定するようにします。
重要なプロパティ
DefaultDate – ユーザーが変更しない限り、日付コントロールの初期値。
SelectedDate – 日付コントロールで現在選択されている日付。 この日付はローカル時間で表されます。
書式 – コントロールが日付を表示し、ユーザーが日付を指定するテキスト形式。 このプロパティを ShortDate (既定) または LongDate に設定すると、このコントロールの Language プロパティに基づいて日付を書式設定できます。 言語に関係なく同じ形式が必要な場合は、このプロパティを yyyy/mm/dd などの式に設定することもできます。 例えば次が挙げられます。
- ユーザーが 2017 年の最終日をクリックまたはタップした場合、コントロールに 2017 年 12 月 31 日が表示されます。 Format プロパティは ShortDate に設定され、 Language プロパティは en-usに設定されます。
- コントロールには、ユーザーが 2017 年の最終日をクリックまたはタップした場合に 、2017 年 31 月 1 日が表示されます。 Format プロパティは LongDate に設定され、 Language プロパティは fr-frに設定されます。
言語 – 月の名前を含め、日付の書式設定に使用される言語を決定します。 このプロパティが指定されていない場合、ユーザーのデバイス設定によって言語が決まります。 サポートされる値には、"EN-us" と "FR" があります。
追加のプロパティ
AccessibleLabel – スクリーン リーダーのラベル。
BorderColor – コントロールの境界線の色。
BorderStyle – コントロールの境界線が Solid、Dashed、Doted、None のいずれであるか。
BorderThickness – コントロールの境界線の太さ。
色 – コントロール内のテキストの色。
DateTimeZone – 日付を UTC で表示するか、ユーザーの 現地 時刻で表示するかを指定します。
DisplayMode – コントロールでユーザー入力 (編集) を許可するか、データのみを表示するか (表示)、無効 (無効) にするかを指定します。
DisabledBorderColor – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロールの境界線の色。
DisabledColor – DisplayMode プロパティが Disabled に設定されている場合のコントロール内のテキストの色。
DisabledFill – DisplayMode プロパティが Disabled に設定されている場合のコントロールの背景色。
EndYear – ユーザーが日付選択コントロールの値を設定できる最新の年。
塗りつぶし – コントロールの背景色。
FocusedBorderColor – コントロールがフォーカスされている場合のコントロールの境界線の色。
FocusedBorderThickness – コントロールがフォーカスされたときのコントロールの境界線の太さ。
フォント – テキストが表示されるフォントファミリの名前。
FontWeight – コントロール内のテキストの重み: 太字、 半ボルト、 標準、 または太さ。
Height – コントロールの上端と下端の間の距離。
IconFill – 日付選択アイコンの前景色。
IconBackground – 日付ピッカー アイコンの背景色。
InputTextPlaceholder – 日付が入力されていない場合に表示される説明テキスト。
IsEditable – 日付ピッカーのテキストを編集できるかどうかを指定します。 false の場合、日付はカレンダーを使用してのみ変更できます。
斜体 – コントロール内のテキストが斜体かどうかを指定します。
OnSelect – ユーザーがコントロールをタップまたはクリックしたときに実行するアクション。
OnChange – ユーザーがコントロールの値を変更したときに実行するアクション。
OnChange と OnSelect の違い: ユーザーのクリックによって変更が発生した場合、同じユーザー アクションで OnSelect トリガーと OnChange トリガーがトリガーされます。 この場合、OnSelect は OnChange の 前に トリガーされます。
PaddingBottom – コントロール内のテキストとそのコントロールの下端との間の距離。
PaddingLeft – コントロール内のテキストとそのコントロールの左端との間の距離。
PaddingRight – コントロール内のテキストとそのコントロールの右端との間の距離。
PaddingTop – コントロール内のテキストとそのコントロールの上端との間の距離。
リセット - 日付選択コントロールを DefaultDate 値にリセットするかどうかを指定します。
サイズ – コントロールに表示されるテキストのフォント サイズ。
StartOfWeek – 日付選択コントロールの最初の日の列に表示する曜日。
StartYear – ユーザーが日付選択コントロールの値を設定できる最も早い年。
TabIndex – 他のコントロールに対するキーボード ナビゲーションの順序。
表示 – コントロールが表示されるか非表示になっているか。
幅 – コントロールの左端と右端の間の距離。
X – コントロールの左端とその親コンテナー (親コンテナーがない場合は画面) の左端間の距離。
Y – コントロールの上端と親コンテナーの上端との間の距離 (親コンテナーがない場合は画面)。
関連する関数
Year( DateTimeValue )
例示
基本的な日付の選択
日付選択コントロールを追加し、"Deadline" という名前を付けます。
Label コントロールを追加し、Text プロパティを次の数式に設定します。
DateDiff(Today(), Deadline.SelectedDate) & " days to go!"F5 キーを押し、[期限] で日付を選択し、[OK] を選択します。
[ラベル] コントロールには、今日から選択した日付までの日数が表示されます。
既定のワークスペースに戻すには、Esc キーを押します。
日付ピッカーを既定の日付にリセットする
日付選択コントロールを追加し、"DateTimeReset" という名前を付けます。
Button コントロールを追加し、その OnChange プロパティを次の式に設定します。
Reset(DateTimeReset)F5 キーを押し、DateTimeReset で新しい日付を選択し、[OK] を選択します。
ボタンを押します。 日付は DefaultDate (Today) にリセットされます。
既定のワークスペースに戻すには、Esc キーを押します。
アクセシビリティ ガイドライン
色のコントラスト
- 標準の色コントラスト要件 が適用されます。
スクリーン リーダーのサポート
- AccessibleLabel が存在する必要があります。
- IsEditable が true で、Format がユーザーが期待する内容でない場合は、ラベルを追加して、受け入れ可能な日付形式を説明します。
キーボードのサポート
- キーボード ユーザーが移動できるようにするには、TabIndex を 0 以上にする必要があります。
- フォーカス インジケーターは明確に表示する必要があります。 これを実現するには、FocusedBorderColor と FocusedBorderThickness を使用します。
ヒント
カレンダーが開いている場合は、 Page Up キーと Page Down キーを押して月間を移動し、 Shift + Page を上 に移動し、 Shift + Page キーを押 して年の間を移動します。