更新 : 2007 年 11 月
ユーザーが日時を選択し、書式を指定して日時を表示できる Windows コントロールを表します。
(System.Windows.Forms.dll 内)
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<DefaultBindingPropertyAttribute("Value")> _
<ComVisibleAttribute(True)> _
Public Class DateTimePicker _
Inherits Control
Dim instance As DateTimePicker
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[DefaultBindingPropertyAttribute("Value")]
[ComVisibleAttribute(true)]
public class DateTimePicker : Control
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)]
[DefaultBindingPropertyAttribute(L"Value")]
[ComVisibleAttribute(true)]
public ref class DateTimePicker : public Control
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
/** @attribute DefaultBindingPropertyAttribute("Value") */
/** @attribute ComVisibleAttribute(true) */
public class DateTimePicker extends Control
public class DateTimePicker extends Control
DateTimePicker コントロールを使用すると、ユーザーが日時を選択し、書式を指定してその日時を表示できます。MinDate プロパティと MaxDate プロパティを設定すると、選択できる日時を制限できます。
CalendarForeColor、CalendarFont、CalendarTitleBackColor、CalendarTitleForeColor、CalendarTrailingForeColor、CalendarMonthBackground の各プロパティを設定すると、コントロールの予定表部分の外観を変更できます。
Format プロパティは、コントロールの DateTimePickerFormat を設定します。日付の既定の Format は、DateTimePickerFormat..::.Long です。Format プロパティが DateTimePickerFormat..::.Custom に設定されている場合は、CustomFormat プロパティを設定し、カスタム書式指定文字列を作成することによって、独自の書式スタイルを作成できます。カスタム書式指定文字列は、カスタム フィールド文字とその他のリテラル文字を組み合わせて作成できます。たとえば、日付を "June 01, 2001 - Friday" と表示するには、CustomFormat プロパティを "MMMM dd, yyyy - dddd" に設定します。詳細については、「日付と時刻の書式指定文字列」を参照してください。
スピン ボタン コントロール (アップダウン コントロール) を使用して日付/時刻値を指定できるようにする場合は、ShowUpDown プロパティを true に設定します。予定表コントロールを選択しても、ドロップダウン リストは表示されません。日時を指定するには、各要素を個別に選択し、上向き矢印ボタンと下向き矢印ボタンを使用して値を変更します。
カスタムの日付書式 (たとえば、選択できる日を 1 日だけに制限する) が必要な場合には、MonthCalendar ではなく DateTimePicker コントロールを使用します。DateTimePicker を使用すると、日付/時刻値として指定され、検証対象とするデータが限定されます。
.gif "メモ") メモ : |
|---|
DateTimePicker コントロールはグレゴリオ暦だけをサポートしています。 |
.gif "Caution メモ") 注意 : |
|---|
DateTimePicker がデータ バインドされ、返された値が nullNothingnullptrnull 参照 (Visual Basic では Nothing) に変更された場合、DateTimePicker の値は更新されず、以前の値が保持されます。この動作が不適切な場合は (データ バインド コントロールのセットを使用してレコードセットをページングする場合など)、Binding クラスの Format イベントを使用して、DateTimePicker を nullNothingnullptrnull 参照 (Visual Basic では Nothing) として認識できる値に設定します。 |
DateTimePicker コントロールの新しいインスタンスを作成し、初期化するコード例を次に示します。コントロールの CustomFormat プロパティが設定されます。また、コントロールに CheckBox が表示されるように ShowCheckBox プロパティが設定され、コントロールがスピン ボタン コントロール (アップダウン コントロール) として表示されるように ShowUpDown プロパティが設定されます。この例を実行するには、次のコードをフォームに貼り付けて、フォームのコンストラクタまたは Load イベント処理メソッドで CreateMyDateTimePicker メソッドを呼び出します。
Public Sub CreateMyDateTimePicker()
' Create a new DateTimePicker control and initialize it.
Dim dateTimePicker1 As New DateTimePicker()
' Set the MinDate and MaxDate.
dateTimePicker1.MinDate = New DateTime(1985, 6, 20)
dateTimePicker1.MaxDate = DateTime.Today
' Set the CustomFormat string.
dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd"
dateTimePicker1.Format = DateTimePickerFormat.Custom
' Show the CheckBox and display the control as an up-down control.
dateTimePicker1.ShowCheckBox = True
dateTimePicker1.ShowUpDown = True
End Sub 'CreateMyDateTimePicker
public void CreateMyDateTimePicker()
{
// Create a new DateTimePicker control and initialize it.
DateTimePicker dateTimePicker1 = new DateTimePicker();
// Set the MinDate and MaxDate.
dateTimePicker1.MinDate = new DateTime(1985, 6, 20);
dateTimePicker1.MaxDate = DateTime.Today;
// Set the CustomFormat string.
dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd";
dateTimePicker1.Format = DateTimePickerFormat.Custom;
// Show the CheckBox and display the control as an up-down control.
dateTimePicker1.ShowCheckBox = true;
dateTimePicker1.ShowUpDown = true;
}
public:
void CreateMyDateTimePicker()
{
// Create a new DateTimePicker control and initialize it.
DateTimePicker^ dateTimePicker1 = gcnew DateTimePicker;
// Set the MinDate and MaxDate.
dateTimePicker1->MinDate = DateTime(1985,6,20);
dateTimePicker1->MaxDate = DateTime::Today;
// Set the CustomFormat string.
dateTimePicker1->CustomFormat = "MMMM dd, yyyy - dddd";
dateTimePicker1->Format = DateTimePickerFormat::Custom;
// Show the CheckBox and display the control as an up-down control.
dateTimePicker1->ShowCheckBox = true;
dateTimePicker1->ShowUpDown = true;
}
public void CreateMyDateTimePicker()
{
// Create a new DateTimePicker control and initialize it.
DateTimePicker dateTimePicker1 = new DateTimePicker();
// Set the MinDate and MaxDate.
dateTimePicker1.set_MinDate(new DateTime(1985, 6, 20));
dateTimePicker1.set_MaxDate(DateTime.get_Today());
// Set the CustomFormat string.
dateTimePicker1.set_CustomFormat("MMMM dd, yyyy - dddd");
dateTimePicker1.set_Format(DateTimePickerFormat.Custom);
// Show the CheckBox and display the control as an up-down control.
dateTimePicker1.set_ShowCheckBox(true);
dateTimePicker1.set_ShowUpDown(true);
} //CreateMyDateTimePicker
System..::.Object
System..::.MarshalByRefObject
System.ComponentModel..::.Component
System.Windows.Forms..::.Control
System.Windows.Forms..::.DateTimePicker
この型のすべてのパブリック static (Visual Basic では Shared) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
.NET Framework
サポート対象 : 3.5、3.0、2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 3.5、2.0
参照