CalendarGcNumberCellType.SideButtonsプロパティを使用します。

ボタンの追加と削除

セルの左右両端にはサイドボタンとして自由にボタンを配置し機能を割り付けることができます。

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

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

• DropDownButton（ドロップダウンボタン）
  
  下向きの矢印が描かれたボタンです。主にドロップダウンウィンドウを表示するために用いられます。ドロップダウン電卓についての詳細は、「ドロップダウン電卓」を参照してください。
• SpinButton（スピンボタン）
  
  上下それぞれに矢印が描かれた２つのボタンが組み合わされたボタンです。主にセル内の値を増減するために用いられます。
  CalendarGcNumberCellTypeでは、Spinプロパティが参照するNumberSpinオブジェクトにより、スピン機能の動作を設定することができます。NumberSpinクラスでは次のプロパティを設定できます。
  
  • AllowSpinプロパティ（スピン機能を有効にするかどうか設定します。）
  • Incrementプロパティ（スピン時のフィールドの値の増減量を設定します。）
  • IncrementValueプロパティ（スピンアクション時の値の増減量を設定します。）
  • SpinModeプロパティ（アクティブなフィールドの値かセルの値を増減するかを設定します。）
  • SpinOnKeysプロパティ（キーの押下によって値の増減を行うかどうか設定します。）
  • SpinOnWheelプロパティ（マウスのホイールによって値の増減を行うかどうか設定します。）
  • Wrapプロパティ（スピン時に値の増減を有効範囲内でループさせるかどうか設定します。）
  
  SpinModeプロパティ次の３つの値を設定することができます。
  

  SpinModeの値	説明
  Field	アクティブなフィールドの値を増減します。
  Value	セルの値を増減します。
  Digits	カレットが置かれている桁の数値を増減します。

• SideButton（サイドボタン）
  
  標準のButtonコントロールと同じような外観を持つボタンです。ボタン上にはイメージとテキストを設定することができます。また、CheckOnClickプロパティを使用するとチェックボタンとして機能させることもできます。
• SymbolButton（シンボルボタン）
  
  SideButtonと同様、標準のButtonコントロールと似た外観を持ちますが、提供されたイメージの中からボタン上に表示する画像を設定することができます。イメージは、Symbolプロパティを使用して設定し、SymbolDirectionプロパティを使用してイメージの向きを設定することができます。
  シンボルボタンにはテキストは表示できません。
  

ボタンの追加や削除を行うには、デザイナのプロパティウィンドウから開かれるサイドボタン コレクション エディタから行うことができます。

また、コードでセルにボタンを追加するには、SideButtonCollectionクラスのAddまたはAddRangeメソッドを使用します。

以下は、Addメソッドを使用してCalendarGcNumberCellTypeにスピンボタンを追加する例です。

Imports InputManCell = GrapeCity.Win.CalendarGrid.InputMan

Dim today As DateTime = DateTime.Today
Dim GcNumberCellType As New InputManCell.CalendarGcNumberCellType()
' シンボルボタンを追加
GcNumberCellType.SideButtons.Add(New InputManCell.SymbolButton())

GcCalendarGrid1.Content(today).Rows(1).Cells(0).CellType = GcNumberCellType
GcCalendarGrid1.ScrollIntoView(today)

using InputManCell = GrapeCity.Win.CalendarGrid.InputMan;

var today = DateTime.Today;
var gcNumberCellType = new InputManCell.CalendarGcNumberCellType();
// シンボルボタンを追加
gcNumberCellType.SideButtons.Add(new InputManCell.SymbolButton());

gcCalendarGrid1.Content[today].Rows[1].Cells[0].CellType = gcNumberCellType;
gcCalendarGrid1.ScrollIntoView(today);

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

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

このサンプルでは、テンプレートのRowセクションに[gcNumberCell1]が配置されていることを前提とします。

Imports InputManCell = GrapeCity.Win.CalendarGrid.InputMan

Dim today As DateTime = DateTime.Today
Dim GcNumberCellType As InputManCell.CalendarGcNumberCellType = _
    DirectCast(GcCalendarGrid1.Content(today).Rows(1).Cells(0).CellType, InputManCell.CalendarGcNumberCellType)
' コレクションの先頭のボタンを削除
If GcNumberCellType.SideButtons.Count > 0 Then
    GcNumberCellType.SideButtons.RemoveAt(0)
End If

using InputManCell = GrapeCity.Win.CalendarGrid.InputMan;

var today = DateTime.Today;
InputManCell.CalendarGcNumberCellType gcMaskCell =
    (InputManCell.CalendarGcNumberCellType)gcCalendarGrid1.Content[today].Rows[1].Cells[0].CellType;
// コレクションの先頭のボタンを削除
if (gcMaskCell.SideButtons.Count > 0)
{
    gcMaskCell.SideButtons.RemoveAt(0);
}

デザイン機能

コントロールの機能のため、InputManCellでサポートされません。

外観の変更

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

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

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

(図) FlatStyle プロパティがFlatの場合

(図) FlatStyle プロパティがPopupの場合

プロパティによる動作の割り当て

各サイドボタンでは押されたときの動作をプロパティで割り当てることができます。

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

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

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

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

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

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

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

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

© MESCIUS inc. All rights reserved.