ShowToolWindowルーチンを呼び出すコマンドを追加する必要があります。
パッケージvsctファイルの先頭には、いくつかの外部参照が必要です。
<!--This is the file that defines the IDs for all the commands exposed by VisualStudio. -->
<Extern href="stdidcmd.h"/>
<!--This header contains the command ids for the menus provided by the shell. -->
<Extern href="vsshlids.h"/>
このファイルはいくつかのシンボルを定義する必要があります。
<Symbols>
<!-- Use your package guid. -->
<GuidSymbol name="guidPackage" value="{00000000-0000-0000-0000-000000000000}" />
<!-- Use a new GUID to uniquely identify your package commands -->
<GuidSymbol name="guidCmdSet" value="{11111111-1111-1111-1111-111111111111}">
<IDSymbol name="cmdidViewMyToolWindow" value="0x0500" />
</GuidSymbol>
</Symbols>
Buttons
パッケージのvsctファイルのブロックに、次のようなものを追加します。
<Button guid="guidCmdSet" id="cmdidViewMyToolWindow" priority="0x0100" type="Button">
<!--IDG_VS_WNDO_OTRWNDWS0 is the first group in "View|Other Windows". See
C:\Program Files (x86)\Microsoft Visual Studio 2010 SDK SP1\VisualStudioIntegration\Common\Inc
for other options. -->
<Parent guid="guidSHLMainMenu" id="IDG_VS_WNDO_OTRWNDWS0"/>
<CommandFlag>DynamicVisibility</CommandFlag>
<CommandFlag>DefaultInvisible</CommandFlag>
<Strings>
<ButtonText>View &My Tool Window</ButtonText>
</Strings>
</Button>
これにより、[表示]メニューの上部に[ツールウィンドウの表示]が表示されます。今、誰かがそれをクリックしたときに行動を起こす必要があります。
パッケージはIOleCommandTarget
、コマンドの可視性と有効化を処理するために実装する必要があります。
public class MyPackage : Package, IOleCommandTarget
{
#region IOleCommandTarget implementation
/// <summary>
/// The VS shell calls this function to know if a menu item should be visible and
/// if it should be enabled/disabled.
/// This is called only when the package is active.
/// </summary>
/// <param name="guidCmdGroup">Guid describing which set of commands the current command(s) belong to</param>
/// <param name="cCmds">Number of commands for which status are being asked</param>
/// <param name="prgCmds">Information for each command</param>
/// <param name="pCmdText">Used to dynamically change the command text</param>
/// <returns>HRESULT</returns>
public int QueryStatus(ref Guid guidCmdGroup, uint cCmds, OLECMD[] prgCmds, IntPtr pCmdText)
{
// Filter out commands that are not defined by this package
if ( guidCmdGroup != new Guid("{00000000-0000-0000-0000-000000000000}"))
return (int)(Constants.OLECMDERR_E_NOTSUPPORTED);
if ( cCmds == 0 || prgCmds == null || prgCmds.Length == 0 || cCmds != prgCmds.Length )
return VSConstants.E_INVALIDARG;
// Show and enable all commands.
OLECMDF cmdf = OLECMDF.OLECMDF_SUPPORTED | OLECMDF.OLECMDF_ENABLED;
for ( int i = 0; i < cCmds; i++ )
prgCmds[i].cmdf = (uint)cmdf;
return VSConstants.S_OK;
}
#endregion
}
そして最後に、パッケージ初期化ルーチンで、コマンドがクリックされたときに何をするかをシェルに指示します。
protected override void Initialize()
{
base.Initialize();
// Add our command handlers (commands must exist in the .vsct file)
OleMenuCommandService mcs = GetService(typeof(IMenuCommandService)) as OleMenuCommandService;
if ( null != mcs )
{
// "View My Tool Window" command callback
CommandID menuCommandID = new CommandID(new Guid("{11111111-1111-1111-1111-111111111111}"), (int)0x500);
MenuCommand menuItem = new MenuCommand(ShowToolWindow, menuCommandID);
mcs.AddCommand(menuItem);
}
}
「実際の」コードでは、vsctで定義されたシンボルと一致するいくつかのGUID定数をC#で定義し、それらを全体で使用することをお勧めします。