コマンド、メニュー、およびツールバー

[アーティクル]
11/15/2023

メニューとツールバーは、ユーザーが VSPackage 内のコマンドにアクセスする方法です。コマンドは、ドキュメントの印刷、ビューの更新、ファイルの新規作成などのタスクを実行する関数です。メニューとツールバーは、ユーザーにコマンドをグラフィカルに表示する便利な方法です。通常、関連するコマンドは、同じメニューやツールバーにまとめられます。

メニューは通常、統合開発環境 (IDE) やツールウィンドウの上部にある列にまとめられた 1 語の文字列として表示されます。メニューは、右クリックイベントの結果として表示することもでき、これはそのコンテキストのショートカットメニューと呼ばれます。クリックすると、メニューが展開して 1 つ以上のコマンドが表示されます。コマンドをクリックすると、タスクを実行したり、追加のコマンドを含むサブメニューを起動したりすることができます。よく知られているメニュー名には、[ファイル]、[編集]、[表示]、[ウィンドウ] などがあります。詳細については、「メニューとコマンドの拡張」を参照してください。
ツールバーは通常、ボタンと他のコントロール (コンボボックス、リストボックス、テキストボックス、メニューコントローラーなど) の行です。すべてのツールバーコントロールは、コマンドに関連付けられます。ツールバーボタンをクリックすると、関連付けられているコマンドがアクティブ化されます。ツールバーボタンには、通常、[印刷] コマンド用のプリンターなどの基になるコマンドを示すアイコンがあります。ドロップダウンリストコントロールでは、リスト内の各項目は、異なるコマンドに関連付けられています。メニューコントローラーは、コントロールの一方の側がツールバーボタン、もう一方の側が、クリックして追加のコマンドを表示する下矢印の組み合わせです。詳細については、「ツールバーにメニューコントローラーを追加する」を参照してください。
コマンドを作成するときは、コマンド用のイベントハンドラーも作成する必要があります。イベントハンドラーでは、コマンドをいつ表示または有効にするかを決定し、コマンドのテキストを変更し、アクティブ化したときにコマンドが適切に応答する (「ルーティングする」) ようにすることができます。ほとんどの場合、IDE では IOleCommandTarget インターフェイスを使用してコマンドを処理します。 Visual Studio ではコマンドは階層形式でルーティングし、ローカルの選択に基づいて最も内側のコマンドコンテキストから開始し、グローバルの選択に基づいて最も外側のコンテキストに進みます。メインメニューに追加したコマンドは、すぐにスクリプトに利用できます。詳細については、「Menucommands と OleMenuCommands に比較」および「選択コンテキストオブジェクト」を参照してください。

新しいメニューやツールバーを定義するには、それらを Visual Studio コマンドテーブル (.vsct) ファイルで記述する必要があります。 Visual Studio パッケージテンプレートでは、このファイルが、テンプレートで選択したすべてのコマンド、ツールバー、エディターをサポートするために必要な要素と共に作成されます。または、「VSCT XML スキーマリファレンス」で説明されている XML スキーマを使用して、独自の .vsct ファイルを作成することもできます。

.vsct ファイルの操作の詳細については、「Visual Studio コマンドテーブル (.vsct) ファイル」を参照してください。

このセクションのトピックでは、VSPackage でのコマンド、メニュー、およびツールバーの動作について説明します。