Freigeben über


Window2-Schnittstelle

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
Öffentliche Eigenschaft AutoHides Legt fest oder gibt zurück, ob das Toolfenster ausgeblendet werden kann.
Öffentliche Eigenschaft Caption Ruft den Titel des Fensters ab oder legt ihn fest.
Öffentliche Eigenschaft Collection Ruft die Auflistung mit dem Window-Objekt ab, das diese Eigenschaft unterstützt.
Öffentliche Eigenschaft CommandBars Ruft eine Auflistung von Microsoft.VisualStudio.CommandBars im aktuellen Fenster ab.
Öffentliche Eigenschaft 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.
Öffentliche Eigenschaft Document Ruft das dem Element zugeordnete Document-Objekt ab, falls eines vorhanden ist.
Öffentliche Eigenschaft DocumentData Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Eigenschaft DTE Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab.
Öffentliche Eigenschaft Height Ruft einen Wert ab oder legt ihn fest, der die Abmessungen des Fensters in Pixel anzeigt.
Öffentliche Eigenschaft HWnd Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Eigenschaft IsFloating Ruft einen Wert ab oder legt diesen fest, der angibt, ob das Toolfenster unverankert über anderen Fenstern angezeigt werden kann.
Öffentliche Eigenschaft Kind Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Eigenschaft 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.
Öffentliche Eigenschaft Linkable Ruft einen Wert ab bzw. legt diesen fest, der angibt, ob das Toolfenster an andere Toolfenster angedockt werden kann.
Öffentliche Eigenschaft LinkedWindowFrame Ruft ein Window-Objekt ab, das den Fensterrahmen darstellt, in dem sich das Fenster befindet.
Öffentliche Eigenschaft LinkedWindows Ruft eine Auflistung aller im verknüpften Rahmenfenster enthaltenen verknüpften Fenster ab.
Öffentliche Eigenschaft Object Ruft ein Objekt ab, auf das zur Laufzeit über den Namen zugegriffen werden kann.
Öffentliche Eigenschaft 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.
Öffentliche Eigenschaft Project Ruft das dem Window-Objekt zugeordnete Project-Objekt ab.
Öffentliche Eigenschaft ProjectItem Ruft das dem Window-Objekt zugeordnete ProjectItem-Objekt ab.
Öffentliche Eigenschaft Selection Ruft ein Objekt ab, das die aktuelle Auswahl im Window-Objekt darstellt.
Öffentliche Eigenschaft 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.
Öffentliche Eigenschaft Type Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Eigenschaft Visible Ruft die Sichtbarkeit eines Fensters ab oder legt sie fest.
Öffentliche Eigenschaft Width Ruft die Breite des Fensters in Zeicheneinheiten ab oder legt sie fest.
Öffentliche Eigenschaft WindowState Ruft den Zustand des Fensters ab oder legt ihn fest (minimiert, normal usw.).

Zum Seitenanfang

Methoden

  Name Beschreibung
Öffentliche Methode Activate Verschiebt den Fokus auf das aktuelle Element.
Öffentliche Methode Attach Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Methode Close Schließt das geöffnete Dokument und speichert es optional oder schließt und zerstört das Fenster.
Öffentliche Methode Detach Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Methode SetFocus Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Methode SetKind Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Methode SetSelectionContainer Ermöglicht das Aktivieren von Objekten im Eigenschaftenfenster, wenn dieses Fenster aktiv ist.
Öffentliche Methode SetTabPicture 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