カレンダーの操作

ドロップダウンカレンダーの基本的な使用方法について解説します。

ナビゲーションとスクロール

ドロップダウンカレンダーでは、ShowNavigatorプロパティの設定によって３種類のナビゲータを利用できます。これらのナビゲータを使用することで、表示されている年や月を自由に切り替えられます。

また、３つのナビゲータに表示されているスキップボタンの１回の操作で移動する月の数は、ScrollRateプロパティで設定します。

ShowNavigatorプロパティをCalendarNavigators.Scrollbarに設定しているときは、ShowScrollTipプロパティを設定することで、スクロールチップを表示できます。さらに、ScrollTipAlignプロパティでスクロールチップの配置も指定可能です。

カレンダーのスクロール時にはアニメーション効果を適用でき、スクロールアニメーションの方向は、NavigatorOrientationプロパティの設定が適用されます。アニメーション効果を無効にする場合は、EnableScrollAnimationプロパティをFalseに設定します。

次のサンプルコードは、スクロール型のナビゲータを設定する方法を示します。

Visual Basic
C#

Imports GrapeCity.Win.MultiRow
Imports InputManCell = GrapeCity.Win.MultiRow.InputMan

Dim GcDateTimeCell1 As New InputManCell.GcDateTimeCell()
GcDateTimeCell1.Name = "GcDateTimeCell1"

' スクロールバースタイルのナビゲータを表示します。 
GcDateTimeCell1.DropDownCalendar.ShowNavigator = GrapeCity.Win.Editors.CalendarNavigators.ScrollBar
' 表示するナビゲータをコントロールの下側に配置します。  
GcDateTimeCell1.DropDownCalendar.NavigatorOrientation = GrapeCity.Win.Editors.NavigatorOrientation.Bottom
' スクロールバーの使用時に、スクロールチップを表示します。 
GcDateTimeCell1.DropDownCalendar.ShowScrollTip = True
' スクロールチップをドロップダウンカレンダーのナビゲータと隣接するように表示します。 
GcDateTimeCell1.DropDownCalendar.ScrollTipAlign = GrapeCity.Win.Editors.ScrollTipAlignment.BottomRight

GcMultiRow1.Template = Template.CreateGridTemplate(New Cell() {GcDateTimeCell1})

using GrapeCity.Win.MultiRow;
using InputManCell = GrapeCity.Win.MultiRow.InputMan;

InputManCell.GcDateTimeCell gcDateTimeCell1 = new InputManCell.GcDateTimeCell();
gcDateTimeCell1.Name = "gcDateTimeCell1";

// スクロールバースタイルのナビゲータを表示します。 
gcDateTimeCell1.DropDownCalendar.ShowNavigator = GrapeCity.Win.Editors.CalendarNavigators.ScrollBar;
// 表示するナビゲータをコントロールの下側に配置します。  
gcDateTimeCell1.DropDownCalendar.NavigatorOrientation = GrapeCity.Win.Editors.NavigatorOrientation.Bottom;
// スクロールバーの使用時に、スクロールチップを表示します。 
gcDateTimeCell1.DropDownCalendar.ShowScrollTip = true;
// スクロールチップをドロップダウンカレンダーのナビゲータと隣接するように表示します。 
gcDateTimeCell1.DropDownCalendar.ScrollTipAlign = GrapeCity.Win.Editors.ScrollTipAlignment.BottomRight;

gcMultiRow1.Template = Template.CreateGridTemplate(new Cell[] { gcDateTimeCell1 });

カレンダータイプの切り替え

カレンダーは、日付を選択するMonthDayカレンダーと月を選択するYearMonthカレンダーの２つのタイプがあります。カレンダーのタイプはCalendarTypeプロパティで設定します。既定値はMonthDayカレンダーです。

また、ズームイン/ズームアウトの２つのアイコンによって、カレンダーのタイプを実行時に切り替えることができます。これらのアイコンを表示するには、ShowZoomButtonプロパティをTrueに設定する必要があります。ズームイン/ズームアウトの２つのアイコンは、ShowNavigatorプロパティがNoneまたはOutLookのときはカレンダーのヘッダに表示されます。ButtonsまたはScrollBarに設定した場合は、ナビゲータ上にアイコンが表示されます。ナビゲータ上にアイコンが表示されるとヘッダにはアイコンが表示されなくなります。

（図）ヘッダにアイコンを表示

（図） ShowNavigator.Buttonsに設定したナビゲータにアイコンを表示

（図） ShowNavigator.ScrollBarに設定したナビゲータにアイコンを表示

カレンダータイプ

ドロップダウンによって表示するカレンダーは、日付を選択するMonthDayカレンダーと月を選択するYearMonthカレンダーの２つのタイプがあります。既定値はMonthDayカレンダーです。

カレンダーのタイプは、DropDownCalendarオブジェクトのCalendarType プロパティで設定します。

キーボード操作

ドロップダウンカレンダーでは、以下のキーボード操作が可能です。

キー	説明
［←］	選択枠が前の日に戻ります。
［→］	選択枠が次の日に進みます。
［↑］	選択枠が１週間前に戻ります。
［↓］	選択枠が１週間先に進みます。
［Home］	選択枠がその週の最初の日に戻ります。
［End］	選択枠がその週の最後の日に進みます。
［Ctrl］+［Home］	選択枠が表示されている月の最初の日に戻ります。
［Ctrl］+［End］	選択枠が表示されている月の最後の日に進みます。
［PageUp］	選択枠が１か月前に戻ります。
［PageDown］	選択枠が１か月先に進みます。
［Ctrl］+［PageUp］	選択枠が１年前に戻ります。
［Ctrl］+［PageDown］	選択枠が１年先に進みます。
［Space］または［Enter］	日付を選択します。

参照