Window2-Schnittstelle

Artikel
10/24/2012

Das Window-Objekt stellt ein Fenster der Umgebung dar.

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

Syntax

'Declaration
<GuidAttribute("25731932-3283-4AE0-B7CF-F4691B8BE523")> _
Public Interface Window2 _
    Inherits Window

[GuidAttribute("25731932-3283-4AE0-B7CF-F4691B8BE523")]
public interface Window2 : Window

[GuidAttribute(L"25731932-3283-4AE0-B7CF-F4691B8BE523")]
public interface class Window2 : Window

[<GuidAttribute("25731932-3283-4AE0-B7CF-F4691B8BE523")>]
type Window2 =  
    interface
        interface Window
    end

public interface Window2 extends Window

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

Eigenschaften

	Name	Beschreibung
	AutoHides	(Von Window geerbt.)
	AutoHides	Legt fest oder gibt zurück, ob das Toolfenster ausgeblendet werden kann.
	Caption	(Von Window geerbt.)
	Caption	Ruft den Titel des Fensters ab oder legt ihn fest.
	Collection	(Von Window geerbt.)
	Collection	Ruft die Auflistung mit dem Window-Objekt ab, das diese Eigenschaft unterstützt.
	CommandBars	Ruft eine Auflistung von Microsoft.VisualStudio.CommandBars im aktuellen Fenster ab.
	ContextAttributes	(Von Window geerbt.)
	ContextAttributes	Ruft eine ContextAttributes-Auflistung ab, über die Automatisierungsclients den derzeit im Fenster Dynamische Hilfe ausgewählten Elementen neue Attribute hinzufügen und kontextbezogene Hilfe für die zusätzlichen Attribute bereitstellen können.
	Document	(Von Window geerbt.)
	Document	Ruft das dem Element zugeordnete Document-Objekt ab, falls eines vorhanden ist.
	DocumentData[String]	(Von Window geerbt.)
	DocumentData[String]	Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
	DTE	(Von Window geerbt.)
	DTE	Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab.
	Height	(Von Window geerbt.)
	Height	Ruft einen Wert ab oder legt ihn fest, der die Abmessungen des Fensters in Pixel anzeigt.
	HWnd	(Von Window geerbt.)
	HWnd	Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
	IsFloating	(Von Window geerbt.)
	IsFloating	Ruft einen Wert ab oder legt diesen fest, der angibt, ob das Toolfenster unverankert über anderen Fenstern angezeigt werden kann.
	Kind	(Von Window geerbt.)
	Kind	Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
	Left	(Von Window geerbt.)
	Left	Ruft den horizontalen Abstand zwischen dem inneren linken Rand eines Objekts und dem linken Rand des zugehörigen Containers ab oder legt ihn fest.
	Linkable	(Von Window geerbt.)
	Linkable	Ruft einen Wert ab bzw. legt diesen fest, der angibt, ob das Toolfenster an andere Toolfenster angedockt werden kann.
	LinkedWindowFrame	(Von Window geerbt.)
	LinkedWindowFrame	Ruft ein Window-Objekt ab, das den Fensterrahmen darstellt, in dem sich das Fenster befindet.
	LinkedWindows	(Von Window geerbt.)
	LinkedWindows	Ruft eine Auflistung aller im verknüpften Rahmenfenster enthaltenen verknüpften Fenster ab.
	Object	(Von Window geerbt.)
	Object	Ruft ein Objekt ab, auf das zur Laufzeit über den Namen zugegriffen werden kann.
	ObjectKind	(Von Window geerbt.)
	ObjectKind	Ruft den Typ des Window.Object-Objekts ab, bei dem es sich um eine GUID-Zeichenfolge handelt, die das im Fenster enthaltene Tool darstellt.
	Project	(Von Window geerbt.)
	Project	Ruft das mit dem Window-Objekt verknüpfte Project-Objekt ab.
	ProjectItem	(Von Window geerbt.)
	ProjectItem	Ruft das mit dem Window-Objekt verknüpfte ProjectItem-Objekt ab.
	Selection	(Von Window geerbt.)
	Selection	Ruft ein Objekt ab, das die aktuelle Auswahl im Window-Objekt darstellt.
	Top	(Von Window geerbt.)
	Top	Ruft den vertikalen Abstand zwischen dem inneren oberen Rand eines Objekts und dem oberen Rand des zugehörigen Containers ab oder legt ihn fest.
	Type	(Von Window geerbt.)
	Type	Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
	Visible	(Von Window geerbt.)
	Visible	Ruft die Sichtbarkeit eines Fensters ab oder legt sie fest.
	Width	(Von Window geerbt.)
	Width	Ruft die Breite des Fensters in Zeicheneinheiten ab oder legt sie fest.
	WindowState	(Von Window geerbt.)
	WindowState	Ruft den Zustand des Fensters ab oder legt ihn fest (minimiert, normal usw.).

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Activate()	(Von Window geerbt.)
	Activate()	Verschiebt den Fokus auf das aktuelle Element.
	Attach(Int32)	(Von Window geerbt.)
	Attach(Int32)	Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
	Close(vsSaveChanges)	(Von Window geerbt.)
	Close(vsSaveChanges)	Schließt das geöffnete Dokument und speichert es optional oder schließt und zerstört das Fenster.
	Detach()	(Von Window geerbt.)
	Detach()	Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
	SetFocus()	(Von Window geerbt.)
	SetFocus()	Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
	SetKind(vsWindowType)	(Von Window geerbt.)
	SetKind(vsWindowType)	Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
	SetSelectionContainer(array<Object[]%)	(Von Window geerbt.)
	SetSelectionContainer(array<Object[]%)	Ermöglicht das Aktivieren von Objekten im Eigenschaftenfenster, wenn dieses Fenster aktiv ist.
	SetTabPicture(Object)	(Von Window geerbt.)
	SetTabPicture(Object)	Lädt eine Bitmap in ein Bild im Registerkartenformat, das sich in einem Toolfenster befindet, das über Registerkarten verknüpft ist.

Zum Seitenanfang

Beispiele

In diesem Beispiel werden das Ausgabefenster, das Befehlsfenster und der Projektmappen-Explorer miteinander verknüpft.Dann wird die Breite und die Höhe der verknüpften Fenster geändert. Schließlich werden alle Fenster vom verknüpften Fensterrahmen abgedockt.

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)
    LinkedWindowsExample(_applicationObject)
End Sub
Sub LinkedWindowsExample(ByVal dte As DTE2)
    Dim Frame As Window2
    Dim wins As Windows2
    wins = CType(_applicationObject.Windows, EnvDTE80.Windows2)
    Dim w1 As Window2 = _
 CType(_applicationObject.Windows.Item _
(Constants.vsWindowKindSolutionExplorer), EnvDTE80.Window2)
    Dim w2 As Window2 = _
 CType(_applicationObject.Windows.Item _
(Constants.vsWindowKindOutput), EnvDTE80.Window2)
    Dim w3 As Window2 = _
 CType(_applicationObject.Windows.Item _
(Constants.vsWindowKindCommandWindow), EnvDTE80.Window2)
    ' Create a linked window frame and dock Solution Explorer 
    ' and the Ouput window together inside it.
    Frame = CType(wins.CreateLinkedWindowFrame _
(w1, w2, vsLinkedWindowType.vsLinkedWindowTypeDocked), _
 EnvDTE80.Window2)
    MsgBox("Total number of windows in the linked window frame: " _
 & Frame.LinkedWindows.Count)
    ' Add another tool window, the Command window, to the frame with 
    ' the other two.
    Frame.LinkedWindows.Add(w3)
    MsgBox("Total number of windows in the linked window frame: " _
    & Frame.LinkedWindows.Count)
    ' Resize the entire linked window frame.
    Frame.Width = 500
    Frame.Height = 600
    MsgBox("Frame height and width changed. Now changing _
     Command window height.")
    ' Resize the height of the Command window.
    Frame.LinkedWindows.Item(3).Height = 800
    MsgBox("Now undocking the Command window from the frame.")
    ' Undock the Command window from the frame.
    Frame.LinkedWindows.Remove(w3)
    MsgBox("Now undocking the rest of the windows from the frame.")
    Frame.LinkedWindows.Remove(w2)
    Frame.LinkedWindows.Remove(w1)
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;
    LinkedWindowsExample(_applicationObject);
}
public void LinkedWindowsExample(DTE2 dte)
{
    Window2 Frame;
    Windows2 wins;
    wins = (EnvDTE80.Windows2)_applicationObject.Windows;
    Window2 w1 = 
(EnvDTE80.Window2)_applicationObject.Windows.Item
(Constants.vsWindowKindSolutionExplorer);
Window2 w2 =
 (EnvDTE80.Window2)_applicationObject.Windows.Item
(Constants.vsWindowKindOutput);
    Window2 w3 = 
(EnvDTE80.Window2)_applicationObject.Windows.Item
(Constants.vsWindowKindCommandWindow);
    // Create a linked window frame and dock Solution Explorer
    // and the Output window together inside it.
    Frame = (EnvDTE80.Window2)wins.CreateLinkedWindowFrame
(w1, w2, vsLinkedWindowType.vsLinkedWindowTypeDocked);
    MessageBox.Show("Total number of windows in the linked 
window frame: " + Frame.LinkedWindows.Count);
    // Add another tool window, the Command window, to the frame with
    // the other two.
    Frame.LinkedWindows.Add(w3);
    MessageBox.Show("Total number of windows in the linked 
window frame: " + Frame.LinkedWindows.Count);
    // Resize the entire linked window frame.
    Frame.Width = 500;
    Frame.Height = 600;
    MessageBox.Show("Frame height and width changed.
 Now changing Command window height.");
    // Resize the height of the Command window.
    Frame.LinkedWindows.Item(3).Height = 800;
    MessageBox.Show("Now undocking the Command window from 
the frame.");
    // Undock the Command window from the frame.
    Frame.LinkedWindows.Remove(w3);
    MessageBox.Show("Now undocking the rest of the windows 
from the frame.");
    Frame.LinkedWindows.Remove(w2);
    Frame.LinkedWindows.Remove(w1);
}

Siehe auch

Referenz

EnvDTE80-Namespace

Freigeben über