Package.FindToolWindow Method

Gets the tool window corresponding to the specified type and ID.

Namespace:  Microsoft.VisualStudio.Shell
Assembly:  Microsoft.VisualStudio.Shell.10.0 (in Microsoft.VisualStudio.Shell.10.0.dll)

public ToolWindowPane FindToolWindow(
	Type toolWindowType,
	int id,
	bool create
)

Parameters

toolWindowType
Type: System.Type
The type of tool window to create.
id
Type: System.Int32
The tool window ID. This is 0 for a single-instance tool window.
create
Type: System.Boolean
If true, the tool window is created if it does not exist.

Return Value

Type: Microsoft.VisualStudio.Shell.ToolWindowPane
An instance of the requested tool window. If create is false and the tool window does not exist, null is returned.

ExceptionCondition
ArgumentNullException

toolWindowType is null.

ArgumentException
  • toolWindowType is not derived from ToolWindowPane.

  • toolWindowType does not have a public constructor .

The FindToolWindow method returns a tool window and creates it if requested.

private void OnMyMenuCommand(object sender, EventArgs e)
{

    // Locates the tool window. This uses IVSUIShell.FindToolWindow
    // to locate an existing tool window. Because true is passed
    // here as the last parameter, the tool window is created
    // if it does not exist in Visual Studio.
    ToolWindowPane w = _package.FindToolWindow(typeof(MyToolWindow), 0, true);

// Shows the tool window. This calls CreateToolWindow
// on IVSUIShell if the tool window does not exist yet.
    w.Show();

}

Community Additions

ADD
Show: