ToolWindows (Interfaz)

Mejora la capacidad para detectar y utilizar ventanas de herramientas en el modelo de objetos proporcionando un acceso sencillo a las ventanas de herramientas de shell en sus tipos nativos.

Espacio de nombres:  EnvDTE80
Ensamblado:  EnvDTE80 (en EnvDTE80.dll)

Sintaxis

'Declaración
<GuidAttribute("19AC6F68-3019-4D65-8D98-404DFB96B8E2")> _
Public Interface ToolWindows

[GuidAttribute("19AC6F68-3019-4D65-8D98-404DFB96B8E2")]
public interface ToolWindows

[GuidAttribute(L"19AC6F68-3019-4D65-8D98-404DFB96B8E2")]
public interface class ToolWindows

[<GuidAttribute("19AC6F68-3019-4D65-8D98-404DFB96B8E2")>]
type ToolWindows =  interface end

public interface ToolWindows

El tipo ToolWindows expone los siguientes miembros.

Propiedades

	Nombre	Descripción
	CommandWindow	Obtiene el objeto CommandWindow.
	DTE	Obtiene el objeto de extensibilidad de nivel superior.
	ErrorList	Obtiene la lista de errores mostrados en el IDE.
	OutputWindow	Obtiene el objeto OutputWindow.
	SolutionExplorer	Obtiene un objeto UIHierarchy que representa al Explorador de soluciones.
	TaskList	Obtiene el objeto TaskList.
	ToolBox	Obtiene el objeto ToolBox.

Arriba

Métodos

	Nombre	Descripción
	GetToolWindow	Permite al usuario recuperar una ventana por su título.

Arriba

Comentarios

Se puede tener acceso a las ventanas de herramientas de Visual Studio a través de las propiedades miembro. Otras ventanas de herramientas se pueden buscar con la función GetToolWindow.

Ejemplos

En este ejemplo se agrega una Ventana de salida, denominada "My output", se activa y se muestran todas las ventanas de herramientas obtenidas a través del objeto Collection del objeto ToolWindows primario. Para obtener más información sobre cómo ejecutar este ejemplo como un complemento, vea Cómo: Compilar y ejecutar los ejemplos de código del modelo de objetos de automatización.

Imports EnvDTE
Imports EnvDTE80
Public Sub OnConnection(ByVal application As Object, _
 ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
 ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    _applicationObject = CType(application, DTE2)
    _addInInstance = CType(addInInst, AddIn)
    OutputToolWindow(_applicationObject)
End Sub
Public Sub OutputToolWindow(ByVal dte As DTE2)
    Dim myOut As OutputWindow
    myOut = _applicationObject.ToolWindows.OutputWindow
    Dim myPane As OutputWindowPane
    Dim txt As String
    txt = ""
    MsgBox("Creating an output window.")
    myPane = myOut.OutputWindowPanes.Add("My output")
    myPane.Activate()
    MsgBox("Adding some text to the output window...")
    myPane.OutputString("This is the collection of tool windows, _
 reached through the Output Window object:" & vbCr)
    For Each tempWindow As EnvDTE80.Window2 In myOut.Parent.Collection
        txt = txt & (tempWindow.Caption & vbCr)
    Next tempWindow
    MsgBox("Displaying all the tool window captions _
 in the Output window...")
    myPane.OutputString(txt)
End Sub

using EnvDTE;
using EnvDTE80;
using System.Windows.Forms;
public void OnConnection(object application, 
ext_ConnectMode connectMode, object addInInst, ref Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    OutputToolWindow(_applicationObject);
}
public void OutputToolWindow(DTE2 dte)
{
    OutputWindow myOut;
    myOut = _applicationObject.ToolWindows.OutputWindow;
    OutputWindowPane myPane;
    String txt = null;
    MessageBox.Show("Creating an output window.");
    myPane = myOut.OutputWindowPanes.Add("My output");
    myPane.Activate();
    MessageBox.Show("Adding some text to the output window...");
    myPane.OutputString("This is the collection of tool
 windows,reached through the Output Window object:" + "\n");
    foreach (EnvDTE80.Window2 tempWindow in myOut.Parent.Collection)
    {
        txt = txt + (tempWindow.Caption + "\n");
    }
    MessageBox.Show("Displaying all the tool window captions 
in the output window...");
    myPane.OutputString(txt);
}

Vea también

Referencia

EnvDTE80 (Espacio de nombres)