Package.CreateToolWindow Method

Creates a tool window of the specified type with the specified ID.

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

Syntax

'Declaration
Protected Function CreateToolWindow ( _
    toolWindowType As Type, _
    id As Integer _
) As WindowPane

protected WindowPane CreateToolWindow(
    Type toolWindowType,
    int id
)

protected:
WindowPane^ CreateToolWindow(
    Type^ toolWindowType, 
    int id
)

member CreateToolWindow : 
        toolWindowType:Type * 
        id:int -> WindowPane

protected function CreateToolWindow(
    toolWindowType : Type, 
    id : int
) : WindowPane

Parameters

• toolWindowType
  Type: Type

  The type of tool window to create.

• id
  Type: Int32

  The tool window ID. This is 0 for a single-instance tool window.

Return Value

Type: Microsoft.VisualStudio.Shell.WindowPane
An instance of the requested tool window.

Exceptions

Exception	Condition
ArgumentNullException	toolWindowType is null.
ArgumentException	id is less than 0. toolWindowType is not derived from ToolWindowPane type.

Remarks

The CreateToolWindow method creates an instance of the given tool window. This is used within the Package base class when implementing the Visual Studio interface tool window creation code as well as the FindToolWindow method.

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

Package Class

Microsoft.VisualStudio.Shell Namespace