IVsPackage::CreateTool Method (Guid)

Visual Studio 2015

Enables the environment to create on-demand tool windows that are implemented by VSPackages.

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

Syntax

C++

int CreateTool(
	[InAttribute] Guid% rguidPersistenceSlot
)

Parameters

rguidPersistenceSlot: Type: System::Guid
[in] Unique identifier of the Tool window.

Return Value

Type: System::Int32

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From vsshell.idl:

C++

HRESULT IVsPackage::CreateTool(
   [in] REFGUID rguidPersistenceSlot
);

A tool window can be configured to open automatically the next time the environment is launched if the window was open during the environment shutdown.

This method should not make the Tool window visible; that is, it should not call Show.

To automatically open Tool windows when the environment is launched, pass CTW_fForceCreate to CreateToolWindow. The tool windows and their configuration must be registered in the system registry. For specific registry entry format and values, see .8a933483-6a5f-49db-92dc-bb5405c05e93