IVsOutputWindow Interface

Manages and controls functions specific to the Output tool window that has multiple panes.

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

Syntax

'Declaration
<InterfaceTypeAttribute()> _
<GuidAttribute("533FAD11-FE7F-41EE-A381-8B67792CD692")> _
Public Interface IVsOutputWindow
[InterfaceTypeAttribute()]
[GuidAttribute("533FAD11-FE7F-41EE-A381-8B67792CD692")]
public interface IVsOutputWindow
[InterfaceTypeAttribute()]
[GuidAttribute(L"533FAD11-FE7F-41EE-A381-8B67792CD692")]
public interface class IVsOutputWindow
[<InterfaceTypeAttribute()>]
[<GuidAttribute("533FAD11-FE7F-41EE-A381-8B67792CD692")>]
type IVsOutputWindow =  interface end
public interface IVsOutputWindow

The IVsOutputWindow type exposes the following members.

Methods

  Name Description
Public method CreatePane Creates an output window pane.
Public method DeletePane Deletes an output window pane.
Public method GetPane Returns an Output window pane, given its identifying GUID.

Top

Remarks

There are two standard output window panes owned by the environment, the Build output window pane and the General output window pane. The Build output window pane is often used by projects to display build errors and warnings. This pane is created by the SVsSolutionBuildManager service. The pointer or reference to the Build output window pane is passed to the projects as a part of IVsBuildableProjectCfg operations. The General output window is used to display miscellaneous informational messages. The General output window pane can be retrieved by calling QueryService (SID_SVsGeneralOutputWindowPane, IID_IVsOUtputWindowPane) as a global service.

To create your own output window, call CreatePane and pass in the GUID and name of your output window. Every output window pane must have an owner VSPackage that creates the pane using CreatePane.

The output tool window is extensible to hold multiple panes. Any VSPackage can introduce a new pane by adding entries to the registry in the following key:

[HKLM\Software\Microsoft\VisualStudio\7.0\OutputWindow]

Each pane is identified by its GUID. The environment owns the lifetime of the pane windows. They are created at startup and destroyed on shutdown. The VSPackage can control whether the pane is visible. By default all panes are visible unless the "InitiallyInvisible = 1" value is specified on the OutputWindow registry entry.

Alternatively, window panes can be created and deleted dynamically with the CreatePane and DeletePane methods.

An example of an output window pane is the Solution Build output window pane. All projects that participate in the build output broadcast messages to this pane.

Notes to Callers

Call this interface through SVsOutputWindow. This interface is implemented by the environment by the OutputWindow tool window.

See Also

Reference

Microsoft.VisualStudio.Shell.Interop Namespace