WindowConfigurations-Schnittstelle

Die WindowConfigurations-Auflistung enthält alle benannten Fensterkonfigurationen, die für die Umgebung erstellt wurden.

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

Syntax

'Declaration
<GuidAttribute("E577442A-98E1-46C5-BD2E-D25807EC81CE")> _
Public Interface WindowConfigurations _
    Inherits IEnumerable
[GuidAttribute("E577442A-98E1-46C5-BD2E-D25807EC81CE")]
public interface WindowConfigurations : IEnumerable
[GuidAttribute(L"E577442A-98E1-46C5-BD2E-D25807EC81CE")]
public interface class WindowConfigurations : IEnumerable
[<GuidAttribute("E577442A-98E1-46C5-BD2E-D25807EC81CE")>]
type WindowConfigurations =  
    interface
        interface IEnumerable
    end
public interface WindowConfigurations extends IEnumerable

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

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft ActiveConfigurationName Ruft den Namen der momentan aktiven Fensterkonfiguration ab.
Öffentliche Eigenschaft Count Ruft einen Wert ab, der die Anzahl der in der Auflistung enthaltenen Objekte angibt.
Öffentliche Eigenschaft DTE Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab.
Öffentliche Eigenschaft Parent Ruft das unmittelbar übergeordnete Objekt einer WindowConfigurations-Auflistung ab.

Zum Seitenanfang

Methoden

  Name Beschreibung
Öffentliche Methode Add Erstellt auf der Grundlage der aktuellen Fensteranordnung eine neue benannte Fensterkonfiguration, fügt diese der WindowConfigurations-Auflistung hinzu und behält sie für einen zukünftigen Wiederaufruf bei.
Öffentliche Methode GetEnumerator() Gibt einen Enumerator zurück, der eine Auflistung durchläuft. (Von IEnumerable geerbt.)
Öffentliche Methode GetEnumerator() Ruft eine Enumeration für Elemente in einer Auflistung ab.
Öffentliche Methode Item Gibt einen indizierten Member einer WindowConfigurations-Auflistung zurück.

Zum Seitenanfang

Hinweise

Sie können das aktuelle Fensterlayout in der Visual Studio-Umgebung als benannte Fensterkonfiguration speichern. Die WindowConfigurations-Auflistung enthält alle derartigen Konfigurationen.

Beispiele

Sub WinConfigurationsExample(ByVal dte As DTE)
    ' This example lists all currently available named window 
    ' configurations.
    ' Set references to all necessary objects.
    Dim colWinConfig As WindowConfigurations
    Dim objWinConfig As WindowConfiguration

    colWinConfig = dte.WindowConfigurations

    MsgBox("Number of configurations: " & colWinConfig.Count)
    ' List all saved named window configurations
    FillMsg(colWinConfig)
    ' Create a new window configuration.
    objWinConfig = colWinConfig.Add("NewLayout")
    FillMsg(colWinConfig)
    ' Get rid of the new window configuration.
    objWinConfig.Delete()
    MsgBox("Number of configurations: " & colWinConfig.Count)
    FillMsg(colWinConfig)
End Sub

Sub FillMsg(ByVal colWinConfig As Object)
    ' Lists all currently available named window configurations.
    Dim lCtr As Integer
    Dim strMsg As String

    For lCtr = 1 To colWinConfig.Count
    strMsg = strMsg & "Configuration name " & lCtr & ": " & _
    colWinConfig.Item(lCtr).Name & vbCr
    Next lCtr
    strMsg = "Current Configurations: " & vbCr & strMsg
    MsgBox(strMsg)
End Sub
void WinConfigExample1(_DTE dte)
{
// Set references to all necessary objects.
    WindowConfigurations colWinConfig; 
    WindowConfiguration objWinConfig;

    colWinConfig = dte.WindowConfigurations;

    MessageBox.Show("Number of configurations: " + 
      colWinConfig.Count);

    // List all saved named window configurations.
    FillMsg(colWinConfig);
    // Create a new window configuration.
    objWinConfig = colWinConfig.Add("NewLayout");
    FillMsg(colWinConfig);
    // Get rid of the new window configuration.
    objWinConfig.Delete();
    MessageBox.Show("Number of configurations: " + colWinConfig.Count);
    FillMsg(colWinConfig);
}

void FillMsg(WindowConfigurations colWinConfig )
{
        // Lists all currently available named window configurations.
    int lCtr;
    string strMsg = null;

    for (lCtr = 1; lCtr < colWinConfig.Count + 1; lCtr ++)
    {
        strMsg = strMsg + "Configuration name " + lCtr + ": " + 
            colWinConfig.Item(lCtr).Name + "\n"; 
    }
    strMsg = "Current Configurations: \n" + strMsg;
    MessageBox.Show(strMsg);
}

Siehe auch

Referenz

EnvDTE-Namespace

Weitere Ressourcen

Beispiel für die WindowConfiguration-Erstellung

Beispiel für die WindowConfiguration-Auswahl