ボタン型セル（ButtonCell）は、.NET FrameworkのButtonコントロール（System.Windows.Forms.Button）と同等の機能を提供します。ButtonCellを使用すると、ユーザーはクリックによってコマンドを実行できます。ボタンのサイズは、セルのサイズに合わせて自働的に調節されます。
機能
ButtonCellでは、基本セルの機能に加えて、次の機能を使用できます。
各機能の詳細はButtonCellクラスのリファレンスを参照してください。
- クリック可能なボタンの表示
- ボタンスタイルの変更
各機能の詳細はButtonCellクラスのリファレンスを参照してください。
データ型
ButtonCellはObject型の値を保持します。この型はButtonCell.ValueTypeプロパティで確認できます。
ボタンのキャプションの表示は、String型にキャストした値が使用されます。この型はButtonCell.FormattedValueTypeプロパティで確認できます。Object型のToStringメソッドをオーバーライドすると、キャストする際の動作を変更できます。セルに値が読み出される場合の動作を変更するには、ButtonCell.OnCellFormattingメソッドをオーバーライドします。セルから値が書き戻される場合の動作を変更するには、ButtonCell.OnCellParsingメソッドをオーバーライドします。
ボタンのキャプションの表示は、String型にキャストした値が使用されます。この型はButtonCell.FormattedValueTypeプロパティで確認できます。Object型のToStringメソッドをオーバーライドすると、キャストする際の動作を変更できます。セルに値が読み出される場合の動作を変更するには、ButtonCell.OnCellFormattingメソッドをオーバーライドします。セルから値が書き戻される場合の動作を変更するには、ButtonCell.OnCellParsingメソッドをオーバーライドします。
セル編集コントロール
ButtonCellのセル編集コントロールはありません。ButtonCell.EditTypeプロパティは常にnull参照(Visual BasicではNothing)を返します。
スタイル
ButtonCellはCellStyleクラスの次のメンバをサポートしています。セルのスタイルはButtonCell.Styleプロパティで設定します。
GDI+互換モードを有効にするには、UseCompatibleTextRenderingプロパティをTrueに設定します。
| CellStyleメンバ | 有効／無効 |
|---|---|
| BackColor | 有効 |
| BackgroundGradientEffect | 有効 |
| Border | 有効 |
| DataSourceNullValue | 有効 |
| DisabledBackColor | 有効 |
| DisabledForeColor | 有効 |
| DisabledGradientEffect | 有効 |
| EditingBackColor | - |
| EditingForeColor | - |
| Font | 有効 |
| ForeColor | 有効 |
| Format | 有効 |
| FormatProvider | 有効 |
| Image | 有効 |
| ImageAlign | 有効 |
| ImeMode | - |
| ImeSentenceMode | - |
| InputScope | - |
| LineAdjustment | GDI+互換モードの場合のみ有効 |
| Margin | 有効 |
| MouseOverBackColor | 有効 |
| MouseOverForeColor | 有効 |
| MouseOverGradientEffect | 有効 |
| Multiline | 有効 |
| NullValue | 有効 |
| Padding | 有効 |
| PatternColor | 有効 |
| PatternStyle | 有効 |
| SelectionBackColor | 有効 |
| SelectionForeColor | 有効 |
| SelectionGradientEffect | 有効 |
| Tag | 有効 |
| TextAdjustment | GDI+互換モードの場合のみ有効 |
| TextAlign | 有効 |
| TextAngle | GDI+互換モードの場合のみ有効 |
| TextEffect | 有効 |
| TextImageRelation | 有効 |
| TextIndent | 有効 |
| TextVertical | GDI+互換モードの場合のみ有効 |
| UseCompatibleTextRendering | 有効 |
| WordWrap | 有効 |
GDI+互換モードを有効にするには、UseCompatibleTextRenderingプロパティをTrueに設定します。
ショートカットキー
ButtonCellでは、Keys.Spaceはボタンのクリックに割り当てられています。それ以外のキーはGcMultiRowコントロールによって処理されます。
イベント
セルの内容領域のクリックに対応した処理を実装するには、GcMultiRow.CellContentClickイベントを使用します。ダブルクリックの場合はGcMultiRow.CellContentDoubleClickイベントです。
標準コントロールとの比較
次の表はButtonCellとSystem.Windows.Forms.Buttonコントロール、System.Windows.Forms.DataGridViewButtonCellの主要なプロパティの比較です。
| ButtonCell | Button | DataGridViewButtonCell |
|---|---|---|
| Ellipsis | AutoEllipsis | なし |
| なし | AutoSize | なし |
| Style.BackColor | BackColor | Style.BackColor |
| FlatStyle | FlatStyle | FlatStyle |
| FlatAppearance | FlatAppearance | なし |
| Style.ForeColor | ForeColor | Style.ForeColor |
| なし | なし | UseColumnTextForButtonValue |
| Style.Image | Image | なし |
| なし | ImageIndex | なし |
| なし | ImageKey | なし |
| なし | ImageList | なし |
| Style.ImageAlign | ImageAlign | なし |
| Style.ImeMode | ImeMode | なし |
| Value | Text | Value |
| Style.TextAlign | TextAlign | Style.Alignment |
| Style.TextImageRelation | TextImageRelation | なし |
| なし | UseCompatibleTextRendering | なし |
| なし | UseMnemonic | なし |
| UseVisualStyleBackColor | UseVisualStyleBackColor | なし |
使用例