コントロールには次の4種類のボタンオブジェクトを追加できます。

DropDownButton （ドロップダウンボタン）

下向きの矢印が描かれたボタンです。主にドロップダウンウィンドウを表示するために用いられます。日付時刻コントロールでは、ドロップダウンカレンダーまたはドロップダウン日付時刻ピッカーが表示可能です。ドロップダウンの動作は、DropDown プロパティが 参照するDateTimeDropDown クラスにより次のようなプロパティを設定できます。

• AllowDrop プロパティ （ドロップダウンを許可するかどうか）
• AllowResize プロパティ（ウィンドウのサイズ変更を許可するかどうか）
• AutoDropDown プロパティ（フォーカス取得時に自動でドロップダウンを表示するかどうか）
• AutoHideTouchKeyboard プロパティ（ドロップダウンが開かれたときタッチキーボードを非表示にするかどうか）
• ClosingAnimation プロパティ（ドロップダウンウィンドウを閉じる時のアニメーション）
• Direction プロパティ（ドロップダウンウィンドウを表示する方向）
• DropDownType プロパティ（ドロップダウン表示するオブジェクト）
• OpeningAnimation プロパティ（ドロップダウンウィンドウを開く時のアニメーション）
• ShowShadow プロパティ（ドロップダウンウィンドウに影を表示するかどうか）

SpinButton （スピンボタン）

上下それぞれに矢印が描かれた２つのボタンが組み合わされたボタンです。主にコントロール内の値を増減するために用いられます。上側のボタンをクリックするとSpinUp イベント、下側のボタンをクリックするとSpinDown イベントが発生します。
日付時刻コントロールでは、Spin プロパティが参照する DateSpin クラスにより、次のようなスピン機能の動作を設定することができます。

• AllowSpin プロパティ （スピン機能を有効にするかどうか設定します。）
• Increment プロパティ （スピン時のフィールドの値の増減量を設定します。）
• IncrementValue プロパティ （スピンアクション時の値の増減量を設定します。）
• SpinMode プロパティ （アクティブなフィールドの値かコントロールの値を増減するかを設定します。）
• SpinOnKeys プロパティ （キーの押下によって値の増減を行うかどうか設定します。）
• SpinOnWheel プロパティ （マウスのホイールによって値の増減やドロップダウンカレンダーの変更を行うかどうか設定します。）
• Wrap プロパティ （スピン時に値の増減を有効範囲内でループさせるかどうか設定します。）

SideButton （サイドボタン）

標準のButtonコントロールと同じような外観を持つボタンです。ボタン上にはイメージとテキストを設定することができます。通常のボタンと同様Click イベントのイベントハンドラに処理を実装することが可能です。
また、CheckOnClick プロパティを使用するとチェックボタンとして機能させることもできます。 この場合、チェック状態が変化すると、CheckedChanged イベントが発生します。

SymbolButton （シンボルボタン）

SideButtonと同様、標準のButtonコントロールと似た外観を持ちますが、提供されたイメージの中からボタン上に表示する画像を設定することができます。イメージは、Symbolプロパティを使用して設定し、SymbolDirectionプロパティを使用してイメージの向きを設定することができます。
シンボルボタンにはテキストは表示できません。

コードによる設定

コントロールにボタンを追加するには、SideButtons プロパティが参照するSideButtonCollection クラスの Addまたは AddRangeメソッドを使用します。SideButtonCollectionクラスは、コントロールに追加するボタンオブジェクトのコレクションで、コントロールに追加可能なサイドボタンを追加、削除するためのメソッドを提供します。

以下は、Addメソッドを使用して日付時刻コントロールにスピンボタンを追加する例です。

' スピンボタンを追加します。
GcDateTime1.SideButtons.Add(New GrapeCity.Win.Editors.SpinButton())

// スピンボタンを追加します。
gcDateTime1.SideButtons.Add(new GrapeCity.Win.Editors.SpinButton());

また、追加したボタンオブジェクトのParent プロパティからは、ボタンが追加されたコントロールのオブジェクトを取得することができます。

追加したボタンを削除するには、SideButtonCollectionクラスのRemoveメソッドまたは、RemoveAtメソッドを使用します。また、Clearメソッドでコレクションに追加されたすべてのボタンをクリアすることができます。

以下は、RemoveAtメソッドを使用してコレクションの先頭に追加されたボタンを削除する例です。

' コレクションの先頭のボタンを削除します。
If  GcDateTime1.SideButtons.Count > 0 Then
    GcDateTime1.SideButtons.RemoveAt(0)
End If

// コレクションの先頭のボタンを削除します。
if (gcDateTime1.SideButtons.Count > 0)
{
    gcDateTime1.SideButtons.RemoveAt(0);
}

デザイン画面での設定

デザイン画面ではサイドボタンの追加や削除ができる「サイドボタンの編集」エディタから容易な設定が可能です。 このエディタは次のいずれかの方法で起動でき、日付時刻コントロールに追加するサイドボタンを設定できます。

• プロパティページの「サイドボタン」-「サイドボタン」を選択
• コントロールのスマート タグから「サイドボタンの編集...」を選択
• プロパティウィンドウのSideButtons プロパティをアクティブにした時に表示される「…」ボタンを押下

また、コントロールに追加されたボタンオブジェクトは、Visual Studioのデザインウィンドウ上で選択し、ボタン毎にプロパティウィンドウを使ってボタンのプロパティの変更やイベントハンドラの実装を行うことができます。
すべてのサイドボタンはデザイン画面上でダブルクリックすることで、自動的にClickイベントのイベントハンドラのコードが生成されます。

DropDownButton クラスは、既定のドロップダウン動作の割り当てを設定するIsDefaultBehavior プロパティを提供します。 日付時刻コントロールでは、IsDefaultBehaviorプロパティをTrueに設定すると、ドロップダウンボタンにはドロップダウンオブジェクトを表示する動作が割り当てられます。

日付時刻コントロールには、以下の２つのドロップダウンオブジェクトが表示可能です。

• ドロップダウンカレンダー
• ドロップダウン日付時刻ピッカー

どちらのドロップダウンオブジェクトを表示するかを設定するには、DropDown プロパティが参照するDateTimeDropDown クラスのDropDownType プロパティを使用します。既定値は、DateDropDownType.Calendar です。

次のサンプルコードは、ドロップダウンオブジェクトとして、日付時刻ピッカーを設定する方法を示します。

Imports GrapeCity.Win.Editors;

' サイドボタンにドロップダウンボタンを追加します。
GcDateTime1.SideButtons.Add(New DropDownButton())
' ドロップダウンオブジェクトに日付時刻ピッカーを設定します。
GcDateTime1.DropDown.DropDownType = DateDropDownType.Picker

using GrapeCity.Win.Editors;

// サイドボタンにドロップダウンボタンを追加します。
gcDateTime1.SideButtons.Add(new DropDownButton());
// ドロップダウンオブジェクトに日付時刻ピッカーを設定します。
gcDateTime1.DropDown.DropDownType = DateDropDownType.Picker;

なお、ドロップダウンオブジェクトを表示するには、次の4つの方法があります。

• ドロップダウンボタンをクリック
• キーボードで［Alt＋↓］キーまたは［F4］キーを押下
• ドロップダウンに割り当てられたショートカットキーを押下
• Drop メソッドを実行

AutoHideTouchKeyboard プロパティを使用すると、ドロップダウンオブジェクトがタッチキーボードの背面に隠れないよう、タッチキーボードを自動的に非表示にすることができます。詳細については「タッチキーボードの制御」を参照してください。

スピンボタン、サイドボタンおよびシンボルボタンには、プロパティの設定によりスピン動作の機能を割り当てることができます。

スピンボタンへの既定動作の割り当て

SpinButton クラスは、既定のスピン動作を割り当てるIsDefaultBehavior プロパティを提供します。
日付時刻コントロールでは、IsDefaultBehavior プロパティをTrue に設定すると、スピンボタンにはコントロールの値を増減する動作が割り当てられます。

サイドボタンへのスピン動作の割り当て

SideButton クラスは、サイドボタンにスピン動作を割り当てるBehavior プロパティを提供します。また、Behavior プロパティに設定した値により、Interval プロパティとText プロパティの初期値が自動的に変更されます。

Behavior プロパティに設定可能な値は以下の通りです。

サイドボタンに割り当てられるスピン機能の詳細については「スピンボタンの最適化」を参照してください。

シンボルボタンへのスピン動作の割り当て

SymbolButton クラスは、サイドボタンにスピン動作を割り当てるBehavior プロパティを提供します。また、Behavior プロパティに設定した値により、Interval プロパティ、Symbol プロパティおよびSymbolDirection プロパティの初期値が自動的に変更されます。

Behavior プロパティに設定可能な値は以下の通りです。

シンボルボタンに割り当てられるスピン機能の詳細については「スピンボタンの最適化」を参照してください。

サイドボタンの押下時にドロップダウン、スピン動作といった既定以外の動作を割り当てたい場合は、各ボタンが押されたときに発生するClick イベントなどに動作を実装する必要があります。

次のサンプルコードは、日付時刻コントロールにドロップダウンカレンダーを表示するためのドロップダウンボタンと、コントロールのフォントを変更するためのフォントダイアログを表示する2つのサイドボタンを追加する例です。
このサンプルでは、GcDateTime1（日付時刻コントロール）とFontDialog1がフォームに貼り付けられていることを前提にしています。

Imports GrapeCity.Win.Editors

' フォントボタンを定義します。
Private MyFontButton As New SideButton()

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    ' フォントボタンにイベントハンドラを関連付けます。 
    AddHandler MyFontButton.Click, AddressOf MyFontButton_Click
    ' フォントボタンにイメージを設定します。
    MyFontButton.Image = Image.FromFile("C:\\FontDialog.png")
    ' 日付時刻コントロールにフォントボタンを追加します。
    GcDateTime1.SideButtons.Add(MyFontButton)
    ' 日付時刻コントロールにドロップダウンボタンを追加します。
    GcDateTime1.SideButtons.Add(New DropDownButton())
End Sub

' フォントボタンのクリックイベントを定義します。
Private Sub MyFontButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
    If FontDialog1.ShowDialog() = Windows.Forms.DialogResult.OK Then
        ' コントロールにフォントを設定します。
        GcDateTime1.Font = FontDialog1.Font
    End If
End Sub

using GrapeCity.Win.Editors;

// フォントボタンを定義します。
private SideButton myFontButton = new SideButton();

private void form1_Load(object sender, EventArgs e)
{
    // フォントボタンにイベントハンドラを関連付けます。
    myFontButton.Click += new EventHandler(myFontButton_Click);
    // フォントボタンにイメージを設定します。
    myFontButton.Image = Image.FromFile("C:\\FontDialog.png");
    // 日付時刻コントロールにフォントボタンを追加します。
    gcDateTime1.SideButtons.Add(myFontButton);
    // 日付時刻コントロールにドロップダウンボタンを追加します。
    gcDateTime1.SideButtons.Add(new DropDownButton());
}

// フォントボタンのクリックイベントを定義します。
void myFontButton_Click(object sender, EventArgs e)
{
    if (fontDialog1.ShowDialog() == DialogResult.OK)
    {
        // コントロールにフォントを設定します。
        gcDateTime1.Font = fontDialog1.Font;
    }
}

各ボタンオブジェクトのPosition プロパティを使用するとボタンの表示位置を設定することができます。

それぞれの位置でのボタンの並びはコレクション内のインデックスによって決定されます。コレクション内のインデックスが小さい順に左から右へボタンが配置されます。
ボタンのサイズはコントロールの高さと各ボタンオブジェクトのButtonWidth プロパティによって設定されます。

サイドボタンの背景色は各ボタンオブジェクトのBackColor プロパティで、前景色はForeColor プロパティで設定します。背景色と前景色はコントロールのFlatStyle プロパティがFlatStyleEx.Flat、およびFlatStyleEx.Popup の場合のみ有効となります。FlatStyleEx.Standard の場合、背景色と前景色はSideButton オブジェクトとSymbleButton オブジェクトで有効になります。