SPREAD for Windows Formsのリボンコントロールの使い方（1）

Windows Forms用スプレッドシートコンポーネント「SPREAD for Windows Forms（スプレッド）」の新バージョン「17.0J」では、新たに「リボンコントロール」が追加されています。

そこで今回は、「.NET 8」環境でリボンコントロールを使用してExcelライクなアプリケーションを作成してみたいと思います。SPREADコントロールとリボンコントロールを組み合わせて使用することで、機能豊富なExcelのようなユーザーインターフェイスを簡単に作成することができます。

開発環境
コントロールの配置
- リボンコントロール
- SPREADコントロール
リボンコントロールの各機能
- 新旧スタイルシステムの表示の違い
- 拡張シェイプエンジンを有効にする
Excelライクなアプリケーションの完成！
さいごに

開発環境

使用する開発環境は以下です。.NET 6／8に対応しているVisual Studio 2022を使用します。SPREADの .NET 6／8対応モジュールはNuGetパッケージで提供されており、NuGetのサイトまたはインストーラによってインストールされるパッケージ（*.nupkg）を使用することが可能です。

Visual Studio 2022（バージョン17.10.3）
GrapeCity.Spread.WinForms.ja（バージョン17.0.1）

SPREAD for Windows Forms 17.0Jを使用するには、製品版またはトライアル版をインストールして製品の認証を行う必要があります。トライアル版は以下からダウンロード可能です。

https://developer.mescius.jp/download#spreadsheet

Visual Studio 2022でのプロジェクトの作成方法や、NuGetパッケージのインストール方法は以下の記事を参考にしてください。

コントロールの配置

NuGetパッケージのインストールが完了すると、ツールボックスには「Spread for Windows Forms」のタブが表示され次のような項目が追加されています。

この中から今回は以下の2つのコントロールを使用します。

コントロール名	ツールボックス内の記述
SPREADコントロール	FpSpread（FarPoint.Win.Spread）
リボンコントロール	RibbonBar（GrapeCity.Spreadsheet.WinForms.Ribbon）

リボンコントロール

リボンコントロールをドラッグ＆ドロップしてフォームに追加します。コントロールを配置すると親フォームにドッキングされます。リボンコントロールのDockプロパティはTopになりExcelのようにフォームの上部全体を占有する使い方が想定されています。

SPREADコントロール

次にSPREADコントロールをドラッグ＆ドロップしてフォームに追加します。SPREADコントロールはリボンコントロールとは異なり親フォームにはドッキングされません。そのため追加したコントロールのスマートタグから手動で「親コンテナにドッキングする」を選択してフォームにドッキングします。

最後にリボンコントロールとSPREADコントロールを関連付けします。リボンコントロールのスマートタグから「AttachTo」項目で配置したSPREADコントロールのオブジェクトである「fpSpread1」を選択します。

リボンコントロールとSPREADコントロールの関連付けは実行時に行うことも可能です。次のサンプルコードではフォームのLoadイベントで関連付けを行っています。

private void Form1_Load(object sender, EventArgs e)
{
    // リボンコントロールとSPREADコントロールの関連付け
    ribbonBar1.Attach(fpSpread1);
}

リボンコントロールの各機能

リボンコントロールにはExcelに備えられているものと同じようなリボンメニューが搭載されています。そのためExcelのリボンと同等のメニューや、一部のメニューを簡単にアプリケーションに組み込むことが可能です。

新旧スタイルシステムの表示の違い

SPREAD for Windows Formsには、新しいスタイルシステム（LegacyBehaviors.Styleがオフ）と旧スタイルシステム（LegacyBehaviors.Styleがオン）が用意されており、提供されている機能が異なります。新旧スタイルシステムの使い分けや使用可能な機能は製品ヘルプに記載されています。