![](images/userguide/CellType_DateTimePickerCell_01.png)
日付型セル(DateTimePickerCell)は、.NET FrameworkのDateTimePickerコントロール(System.Windows.Forms.DateTimePicker)と同等の機能を提供します。日付型セルを使用すると、ユーザーは日付と時刻を入力できます。日付型セルのドロップダウンウインドウの外観は、Windowsの設定に依存します。
機能
DateTimePickerCellでは、基本セルの機能に加えて、次の機能を使用できます。
各機能の詳細はDateTimePickerCellクラスのリファレンスを参照してください。
- 日付と時刻の入力
- ドロップダウン カレンダーの表示
- 入力可能な日付範囲の指定
各機能の詳細はDateTimePickerCellクラスのリファレンスを参照してください。
データ型
DateTimePickerCellはObject型の値を保持します。この型はDateTimePickerCell.ValueTypeプロパティで確認できます。入力と表示には、DateTimePickerCell.Formatプロパティの書式を元にDate型(C#ではSystem.DateTime型)に整形された値が使用されます。この型はDateTimePickerCell.FormattedValueTypeプロパティで確認できます。セルに値が読み出される場合の動作を変更するには、DateTimePickerCell.OnCellFormattingメソッドをオーバーライドします。セルから値が書き戻される場合の動作を変更するには、DateTimePickerCell.OnCellParsingメソッドをオーバーライドします。
セル編集コントロール
DateTimePickerCellの値はDateTimePickerEditingControlコントロールで編集できます。このコントロールはIEditingControlインタフェースとSystem.Windows.Forms.DateTimePickerクラスを継承しています。セル編集コントロールの型はDateTimePickerCell.EditTypeプロパティで確認できます。
スタイル
DateTimePickerCellはCellStyleクラスの次のメンバをサポートしています。セルのスタイルはDateTimePickerCell.Styleプロパティで設定します。
GDI+互換モードを有効にするには、UseCompatibleTextRenderingプロパティをTrueに設定します。
CellStyleメンバ | 非編集時 | 編集時 |
---|---|---|
BackColor | 有効 | - |
Border | 有効 | 有効 |
DataSourceNullValue | 有効 | 有効 |
DisabledBackColor | 有効 | - |
DisabledForeColor | 有効 | - |
Font | 有効 | 有効 |
ForeColor | 有効 | - |
Format | - | - |
FormatProvider | - | - |
GradientColors | 有効 | - |
GradientDirection | 有効 | - |
GradientStyle | 有効 | - |
Image | 有効 | - |
ImageAlign | 有効 | - |
ImeMode | 有効 | 有効 |
ImeSentenceMode | 有効 | 有効 |
InputScope | 有効 | 有効 |
LineAdjustment | GDI+互換モードの場合のみ有効 | - |
Margin | 有効 | 有効 |
Multiline | 有効 | 有効 |
NullValue | 有効 | 有効 |
Padding | 有効 | 有効 |
PatternColor | 有効 | - |
PatternStyle | 有効 | - |
SelectionBackColor | 有効 | - |
SelectionForeColor | 有効 | - |
Tag | 有効 | 有効 |
TextAdjustment | GDI+互換モードの場合のみ有効 | - |
TextAlign | 有効 | 垂直方向のみ有効 |
TextAngle | GDI+互換モードの場合のみ有効 | - |
TextEffect | 有効 | - |
TextImageRelation | 有効 | - |
TextIndent | 有効 | - |
TextVertical | GDI+互換モードの場合のみ有効 | - |
UseCompatibleTextRendering | 有効 | - |
WordWrap | 有効 | - |
GDI+互換モードを有効にするには、UseCompatibleTextRenderingプロパティをTrueに設定します。
ショートカットキー
次の表はDateTimePickerCellの編集時に処理されるキーとGcMultiRowコントロールで処理されるキーの一覧です。
Keys.Control+Keys.Cは複数のセルが選択されている場合はGcMultiRowコントロールによって処理されます。
DateTimePicker.ShowUpDownプロパティがTrueのとき、次のキーは処理されません。
修飾子 | キー | 日付型セル | GcMultiRow |
---|---|---|---|
なし | Keys.PageUp | - | - |
Keys.PageDown | - | - | |
Keys.End | 有効 | - | |
Keys.Home | 有効 | - | |
Keys.Left | 有効 | - | |
Keys.Right | 有効 | - | |
Keys.Up | 有効 | - | |
Keys.Down | 有効 | - | |
Keys.Insert | - | - | |
Keys.Delete | - | - | |
Keys.BackSpace | - | - | |
Keys.F4 | 有効 | - | |
Keys.Control | Keys.PageUp | - | - |
Keys.PageDown | - | - | |
Keys.End | 有効 | - | |
Keys.Home | 有効 | - | |
Keys.Left | - | 有効 | |
Keys.Right | - | 有効 | |
Keys.Up | - | 有効 | |
Keys.Down | - | 有効 | |
Keys.A | - | - | |
Keys.C | - | - | |
Keys.V | - | - | |
Keys.X | - | - | |
Keys.Shift | Keys.Left | 有効 | - |
Keys.Right | 有効 | - | |
Keys.Up | 有効 | - | |
Keys.Down | 有効 | - | |
Keys.Home | 有効 | - | |
Keys.End | 有効 | - | |
Keys.Alt | Keys.Up | 有効 | - |
Keys.Down | 有効 | - |
Keys.Control+Keys.Cは複数のセルが選択されている場合はGcMultiRowコントロールによって処理されます。
DateTimePicker.ShowUpDownプロパティがTrueのとき、次のキーは処理されません。
修飾子 | キー | 日付型セル | GcMultiRow |
---|---|---|---|
なし | Keys.F4 | - | - |
Keys.Alt | Keys.Up | - | - |
Keys.Down | - | - |
イベント
セルの内容領域のクリックに対応した処理を実装するには、GcMultiRow.CellContentClickイベントを使用します。ダブルクリックの場合はGcMultiRow.CellContentDoubleClickイベントです。
セルの値が変更されたときの処理を実装するには、GcMultiRow.CellEditedFormattedValueChangedイベントを使用します。
DateTimePickerCellを編集中のイベントに対応した処理は、DateTimePickerEditingControlクラスのイベントを使用します。DateTimePickerEditingControlクラスでは、System.Windows.Forms.DateTimePickerクラスと同じイベントを使用できます。
セルの値が変更されたときの処理を実装するには、GcMultiRow.CellEditedFormattedValueChangedイベントを使用します。
DateTimePickerCellを編集中のイベントに対応した処理は、DateTimePickerEditingControlクラスのイベントを使用します。DateTimePickerEditingControlクラスでは、System.Windows.Forms.DateTimePickerクラスと同じイベントを使用できます。
標準コントロールとの比較
次の表はDateTimePickerCellとSystem.Windows.Forms.DateTimePickerコントロールの主要なプロパティの比較です。
DateTimePickerCell | DateTimePicker |
---|---|
CalendarFont | CalendarFont |
CalendarForeColor | CalendarForeColor |
CalendarMonthBackground | CalendarMonthBackground |
CalendarTitleBackColor | CalendarTitleBackColor |
CalendarTitleForeColor | CalendarTitleForeColor |
CalendarTrailingForeColor | CalendarTrailingForeColor |
CustomFormat | CustomFormat |
DropDownAlign | DropDownAlign |
Format | Format |
MaxDate | MaxDate |
MinDate | MinDate |
ShowUpDown | ShowUpDown |
ShowDropDownButton | なし |
なし | PreferredHeight |
なし | RightToLeftLayout |
なし | ShowCheckBox |
なし | Checked |
DisplayText | Text |
Value | Value |
使用例