ToolWindows-Schnittstelle

Artikel
08/10/2011

Verbessert die Auffindbarkeit und Verwendbarkeit von Toolfenstern im Objektmodell, indem der Zugriff auf die Toolfenster der Shell in ihren systemeigenen Typen erleichert wird.

Namespace: EnvDTE80
Assembly: EnvDTE80 (in EnvDTE80.dll)

Syntax

'Declaration
<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

Der ToolWindows-Typ macht die folgenden Member verfügbar.

Eigenschaften

	Name	Beschreibung
	CommandWindow	Ruft das CommandWindow-Objekt ab.
	DTE	Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab.
	ErrorList	Ruft die Liste der Fehler ab, die in der IDE angezeigt werden.
	OutputWindow	Ruft das OutputWindow-Objekt ab.
	SolutionExplorer	Ruft ein UIHierarchy-Objekt ab, das den Projektmappen-Explorer darstellt.
	TaskList	Ruft das TaskList-Objekt ab.
	ToolBox	Ruft das ToolBox-Objekt ab.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	GetToolWindow	Damit kann der Benutzer ein Fenster über seinen Titel abrufen.

Zum Seitenanfang

Hinweise

Auf die Toolfenster von Visual Studio kann über die Membereigenschaften zugegriffen werden. Andere Toolfenster können mit der GetToolWindow-Funktion gefunden werden.

Beispiele

In diesem Beispiel wird ein Ausgabefenster mit dem Titel "My output" hinzugefügt, das Fenster wird aktiviert, und alle Toolfenster werden angezeigt, auf die über das Collection-Objekt des übergeordneten ToolWindows-Objekts zugegriffen werden kann. Weitere Informationen zum Ausführen dieses Beispiels als Add-In finden Sie unter Gewusst wie: Kompilieren und Ausführen der Codebeispiele für das Automatisierungsobjektmodell.

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);
}

Siehe auch

Referenz

EnvDTE80-Namespace

Freigeben über