DatePicker

DatePickerウィジェットは、タップするとスクロールホイール形式のピッカーが開き、年・月・日を選んで日付を入力できるコンパクトな入力コントロールです。
生年月日や予約日など、日付を1つだけ狭いスペースで選択させたいときに使います。

定義・役割

DatePickerウィジェットは、選択された日付（または案内文）とアイコンを含む入力エリアを描画します。エリアをタップするとピッカーが開き、日付を確定するとonDateSelectedに接続した動作が実行されます。表示形式・年の範囲・年/月/日の表示有無・アイコン・サイズなどを設定できます。

機能	説明
日付の選択	入力エリアをタップするとスクロールホイールのピッカーが開き、年・月・日を選んで確定します。確定すると`onDateSelected`に接続した動作が実行されます。
表示形式	`dateFormat`で選択された日付の表示形式を指定します。未設定の場合は`yyyy.MM.dd`形式で表示されます。
案内文	選択前に表示する案内文（`hintText`）と文字スタイルを設定します。
年の範囲	`minYear`〜`maxYear`で選択できる年の範囲を制限します。
ピッカー項目の表示	年/月/日それぞれの項目の表示有無を個別に切り替えます。
アイコン・見た目	入力エリアのアイコン（サイズ・カラー）とサイズ・余白・背景装飾を調整します。

注記

ヒントと日付の文字の詳細なスタイルはhintTextStyle・dateTextStyleで指定します。以下はDatePicker固有のプロパティです。

プロパティ	説明	デフォルト値	値 / タイプ
`Size`	入力エリアのサイズ - 幅（width）・高さ（height）をまとめて指定するグループプロパティ	幅`176`・高さ`36`	サイズ（幅・高さ、px単位の数値）
`padding`	内側の余白	未設定	余白値
`decoration`	背景装飾（カラー・枠線・角丸）	未設定	ボックス装飾
`hintText`	日付を選択する前に表示する案内文	`날짜를 선택하세요`	文字列
`hintTextStyle`	案内文の文字スタイル	未設定	テキストスタイル
`dateTextStyle`	選択された日付の文字スタイル	未設定	テキストスタイル
`dateFormat`	選択された日付の表示形式（未設定の場合は`yyyy.MM.dd`）	未設定	文字列
`icon`	入力エリアに表示するアイコン	未設定	アイコン設定
`iconSize`	アイコンのサイズ	`16`	数値（px）
`iconColor`	アイコンのカラー	`#9E9E9E`（グレー）	カラー
`minYear`	選択できる最小の年	`1900`	数値
`maxYear`	選択できる最大の年	`2099`	数値
`pickerYearVisible`	ピッカーに年を表示するかどうか	`true`	true / false
`pickerMonthVisible`	ピッカーに月を表示するかどうか	`true`	true / false
`pickerDayVisible`	ピッカーに日を表示するかどうか	`true`	true / false
`selectedDate`	初期の選択日付	未設定	文字列

警告

maxYearはminYear以上である必要があります。maxYearがminYearより小さい場合は、プロパティエラーとして表示されます。

ヒント

pickerYearVisible・pickerMonthVisible・pickerDayVisibleを個別にオフにすれば、年・月だけを選ぶピッカーのように表示項目を構成できます。

ヒント

このウィジェットをスクリプトで制御するWidget Control（Property・Method・Event）の全体は、DatePicker Widget Controlドキュメントで確認してください。