Window2 Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Das Window-Objekt stellt ein Fenster in der Umgebung dar.
public interface class Window2 : EnvDTE::Window
public interface class Window2 : EnvDTE::Window
__interface Window2 : EnvDTE::Window
[System.Runtime.InteropServices.Guid("25731932-3283-4AE0-B7CF-F4691B8BE523")]
[System.Runtime.InteropServices.TypeLibType(4160)]
public interface Window2 : EnvDTE.Window
[<System.Runtime.InteropServices.Guid("25731932-3283-4AE0-B7CF-F4691B8BE523")>]
[<System.Runtime.InteropServices.TypeLibType(4160)>]
type Window2 = interface
interface Window
Public Interface Window2
Implements Window
- Attribute
- Implementiert
Beispiele
In diesem Beispiel werden die Ausgabefenster, das Befehlsfenster und Projektmappen-Explorer miteinander verknüpft. Anschließend werden die Breite und Höhe dieser verknüpften Fenster manipuliert und schließlich alle aus dem verknüpften Fensterrahmen entfernt.
Imports EnvDTE
Imports EnvDTE80
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 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);
}
Eigenschaften
| AutoHides |
Ruft ab oder legt fest, ob das Toolfenster ausgeblendet werden kann. |
| Caption |
Ruft den Titel des Fensters ab oder legt diesen fest. |
| Collection |
Ruft die Auflistung mit dem Window-Objekt ab, das diese Eigenschaft unterstützt. |
| CommandBars |
Ruft eine Auflistung von |
| ContextAttributes |
Ruft eine Auflistung ab ContextAttributes , mit der Automatisierungs Clients den aktuellen, ausgewählten Elementen im Fenster Dynamische Hilfe neue Attribute hinzufügen und kontextbezogene Hilfe für zusätzliche Attribute bereitstellen können. |
| Document |
Ruft das Document-Objekt ab, das dem Element zugeordnet ist, falls ein solches existiert. |
| DocumentData[String] |
Nur Microsoft-interne Verwendung. |
| DTE |
Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab. |
| Height |
Ruft einen Wert ab, der die Abmessungen des Fensters in Pixeln angibt, oder legt diesen fest. |
| HWnd |
Nur Microsoft-interne Verwendung. |
| IsFloating |
Ruft einen Wert ab, der angibt, ob das Toolfenster über andere Fenster gleitet, oder legt diesen fest. |
| Kind |
Nur Microsoft-interne Verwendung. |
| Left |
Ruft den horizontalen Abstand zwischen dem inneren linken Rand eines Objekts und dem linken Rand des jeweiligen Containers ab oder legt diesen fest. |
| Linkable |
Ruft einen Wert ab, der angibt, ob das Toolfenster an andere Toolfenster angedockt werden kann, oder legt diesen fest. |
| LinkedWindowFrame |
Ruft ein Window-Objekt ab, das den Fensterrahmen darstellt, der das Fenster enthält. |
| LinkedWindows |
Ruft eine Auflistung aller verknüpften Fenster ab, die der verknüpfte Fensterrahmen enthält. |
| Object |
Ruft ein Objekt ab, auf das zur Laufzeit über den Namen zugegriffen werden kann. |
| ObjectKind |
Ruft den Typ des Object-Objekts ab. Dies ist eine GUID-Zeichenfolge, die das im Fenster enthaltene Tool darstellt. |
| Project |
Ruft das Project-Objekt ab, das dem Window-Objekt zugeordnet ist. |
| ProjectItem |
Ruft das ProjectItem-Objekt ab, das dem Window-Objekt zugeordnet ist. |
| Selection |
Ruft ein Objekt ab, das die aktuelle Auswahl im Window-Objekt darstellt. |
| Top |
Ruft den vertikalen Abstand zwischen dem inneren oberen Rand eines Objekts und dem oberen Rand des jeweiligen Containers ab oder legt diesen fest. |
| Type |
Nur Microsoft-interne Verwendung. |
| Visible |
Ruft die Sichtbarkeit des Fensters ab oder legt diese fest. |
| Width |
Ruft die Breite des Fensters in Zeicheneinheiten ab oder legt diese fest. |
| WindowState |
Ruft den Status des Fensters (minimiert, normal usw.) ab oder legt diesen fest. |
Methoden
| Activate() |
Verschiebt den Fokus auf das aktuelle Element. |
| Attach(Int32) |
Nur Microsoft-interne Verwendung. |
| Close(vsSaveChanges) |
Schließt das geöffnete Dokument, speichert es optional und zerstört das Fenster. |
| Detach() |
Nur Microsoft-interne Verwendung. |
| SetFocus() |
Nur Microsoft-interne Verwendung. |
| SetKind(vsWindowType) |
Nur Microsoft-interne Verwendung. |
| SetSelectionContainer(Object[]) |
Ermöglicht das Festlegen von Objekten im Eigenschaften Fenster , wenn dieses Fenster aktiv ist. |
| SetTabPicture(Object) |
Lädt eine Bitmap in ein Registerkartenbild in einem über Registerkarten verknüpften Toolfenster. |