コマンドボタン型セルを使用すると、セル内にコマンドボタンを表示できます。 コマンドボタン型セルは、デフォルトでは、長方形のボタンをデフォルト色で表示します。コマンドボタンはテキスト、色、および画像をカスタマイズできるほか、クリックされたときの動作に関するさまざまな属性も指定できます。

コマンドボタン型セルとその各属性を設定するには、ButtonCellTypeクラスを使用します。

コマンドボタン型セルに表示するテキスト、およびその外観を指定できます。 コマンドボタンに表示するテキストは、ピクチャに対してどの位置に配置するか、および複数行に折り返して表示するかどうかを指定できます。

次に、コマンドボタン型セルの表示テキストに関連するプロパティの一覧を示します。

プロパティ	説明
HotkeyPrefix	ショートカットキー（ホットキー）を示す下線を表示するかどうかを設定します。
Text	コマンドボタンに表示するテキストを設定します。
TextAlign	ピクチャに対するテキストの配置を設定します。
TextColor	コマンドボタンのテキスト色を設定します。
TextDown	2状態のコマンドボタンに対し、押された状態のボタンに表示するテキストを設定します。
TextOrientation	コマンドボタンに表示するテキストの方向を設定します。 さまざまな表示方向の例については、次の表を参照してください。
WordWrap	テキストを複数行にわたって折り返し表示するかどうかを設定します。

次に、TextOrientationプロパティのさまざまな設定結果を示します。

テキストの方向	コマンドボタンの例	テキストの方向	コマンドボタンの例
水平方向（TextHorizontal）		水平方向、反転（TextHorizontalFlipped）
垂直方向（TextVertical）		垂直方向、反転（TextVerticalFlipped）
上から下、左から右（TextTopDown）		上から下、右から左（TextTopDownRTL）
カスタム回転（TextRotateCustom）	指定した角度で回転表示

ButtonCellTypeクラスが持つプロパティのほか、FpSpreadクラスのButtonDrawModeプロパティが、ボタンの動作に影響を与えます。このプロパティは、コマンドボタン型セル、およびコンボボックス型セルで有効です。ボタンを常時表示するのか、または現在の行、列、およびセル内でのみ表示するのかを設定できます。

特定のセル型において、一部のグラフィカル要素がビジュアルスタイルの影響を受けることに注意してください。 FpSpreadクラスのVisualStylesプロパティを「Off」に設定すると、これらのグラフィカルなセル型の視覚的なカスタマイズを、指定したとおりに機能させることができます。詳細については、「ビジュアルスタイル」を参照してください。 ユーザーがボタンをクリックしたときに発生するイベントの詳細については、FpSpreadクラスのButtonClickedイベントを参照してください。

設定方法

ButtonCellType クラスのインスタンスを作成して、クラスの各プロパティ（Text、TwoState、ButtonColor など）を設定します。セルに設定する場合はCellクラスの、行に設定する場合はRowクラスの、列に設定する場合はColumnクラスの、あるいはスタイルに設定する場合はStyleInfoクラスのCellTypeプロパティに、定義したButtonCellTypeクラスのインスタンスを割り当てます。

サンプルコード

次のサンプルコードは、テキストを表示した青色のコマンドボタンを作成します。 ボタンが押されると、別のテキストが表示されるように設定します。 これは、このページの最初に図示したコマンドボタンサンプルのコードです。

FarPoint.Win.Spread.CellType.ButtonCellType bttncell = new FarPoint.Win.Spread.CellType.ButtonCellType();
bttncell.ButtonColor = Color.Cyan;
bttncell.DarkColor = Color.DarkCyan;
bttncell.LightColor = Color.AliceBlue;
bttncell.TwoState = false;
bttncell.Text = "Click and Hold";
bttncell.TextDown = "...now let go.";
bttncell.ShadowSize = 3;
fpSpread1.Sheets[0].Cells[0,2].CellType = bttncell;

Dim bttncell As New FarPoint.Win.Spread.CellType.ButtonCellType()
bttncell.ButtonColor = Color.Cyan
bttncell.DarkColor = Color.DarkCyan
bttncell.LightColor = Color.AliceBlue
bttncell.TwoState = False
bttncell.Text = "Click and Hold"
bttncell.TextDown = "...now let go."
bttncell.ShadowSize = 3
FpSpread1.Sheets(0).Cells(0,2).CellType = bttncell

SPREAD デザイナの使用

1. 作業領域内のセルまたはセル範囲を選択します。
2. プロパティ リストの「その他」カテゴリから、CellType プロパティを選択します。 ドロップダウン リストからコマンドボタン型を選択します。 これによって CellType プロパティが展開され、このセル型に固有のさまざまなプロパティが表示されます。 このリストから、必要に応じてプロパティを選択および設定します。
   または、セルまたはセル範囲を右クリックして［セル型］を選択します。 セル型の一覧からコマンドボタン型を選択します。 セル型エディタで、必要なプロパティを設定します。 〈適用〉ボタンをクリックします。
3. ［ファイル］メニューから［適用して終了］を選択し、変更をコンポーネントに適用して SPREAD デザイナを終了します。

© 2004-2015, GrapeCity inc. All rights reserved.