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 Function FindToolWindow ( _
    toolWindowType As Type, _
    id As Integer, _
    create As Boolean _
) As ToolWindowPane
public ToolWindowPane FindToolWindow(
    Type toolWindowType,
    int id,
    bool create
ToolWindowPane^ FindToolWindow(
    Type^ toolWindowType, 
    int id, 
    bool create
member FindToolWindow : 
        toolWindowType:Type * 
        id:int * 
        create:bool -> ToolWindowPane 
public function FindToolWindow(
    toolWindowType : Type, 
    id : int, 
    create : boolean
) : ToolWindowPane


  • 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, nulla null reference (Nothing in Visual Basic) is returned.


Exception Condition

toolWindowType is nulla null reference (Nothing in Visual Basic).

  • 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.


.NET Framework Security

See Also


Package Class

Microsoft.VisualStudio.Shell Namespace