DTE-Eigenschaftsauflistungen

Add-Ins für Visual Studio sind in Visual Studio 2013 veraltet. Sie müssen für Ihre Add-Ins ein Upgrade auf VSPackage-Erweiterungen durchführen. Weitere Informationen über das Durchführen eines Upgrades finden Sie unter FAQ: Konvertieren von Add-Ins in VSPackage-Erweiterungen.

Die Eigenschaften auf Umgebungsebene sind in Kategorien unterteilt, die der jeweils im Dialogfeld Optionen angezeigten Hierarchie entsprechen. Beispielsweise stellt DTE.Properties("TextEditor", "Basic") die Einstellungen im Knoten Basic dar, der sich im Dialogfeld Optionen unter dem Knoten Text-Editor befindet. Viele Einstellungen auf den Seiten im Dialogfeld werden auch durch Eigenschaften dargestellt. Eine Einstellung auf der Seite Tabstopps im Knoten Standard unter dem Knoten Text-Editor lautet z. B. Tabulatorgröße. Diese Einstellung wird durch die TabSize-Eigenschaft und die TabSize-Eigenschaft dargestellt. Jedes Eigenschaftenelement weist einen oder mehrere Werte auf, die durch die Value-Eigenschaft dargestellt werden. Informationen zum Ändern der Werte mithilfe von Eigenschaften finden Sie unter Steuern der Einstellungen im Dialogfeld "Optionen" (Menü "Extras").

Die folgenden Dokumente enthalten vordefinierte Kategorien von Einstellungen, die in Visual Studio enthalten sind.

• Optionsseite, Eigenschaften des Knotens "Umgebung"

• Optionsseite, Eigenschaften des Knotens "Schriftarten und Farben"

• Optionsseite, Eigenschaften des Knotens "Text-Editor"

• Optionen, Text-Editor, C#, Formatierung

Um Einstellungen zu einer vorhandenen Seite mit Optionen oder eine benutzerdefinierte Seite im Dialogfeld Optionen hinzuzufügen, verwenden Sie Visual Studio SDK. Weitere Informationen finden Sie auf der Website vom Partnerportal für Entwicklungstoolökosysteme.

Hinweis

Einige Seiten im Dialogfeld Optionen bieten keine Unterstützung für Automatisierung.Informationen dazu, welche Eigenschaftenseiten die Automatisierung unterstützen, finden Sie unter Bestimmen der Namen von Eigenschaftenelementen auf Optionsseiten.

Um das Dialogfeld Optionen in der integrierten Entwicklungsumgebung (IDE) zu öffnen, klicken Sie im Menü Extras auf Optionen.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie die barrierefreien Eigenschaftenelemente auf der Seite Allgemein im Knoten C# unter dem Knoten Text-Editor im Dialogfeld Optionen angezeigt werden können. Beachten Sie, dass der Knoten "C#" in Code als "CSharp" dargestellt werden muss. Weitere Informationen zum Ausführen des Add-In-Beispiels finden Sie unter Gewusst wie: Kompilieren und Ausführen der Codebeispiele für das Automatisierungsobjektmodell.

' Add-in code.
Public Sub OnConnection(ByVal application As Object, ByVal connectMode _
As Extensibility.ext_ConnectMode, ByVal addInInst As Object, ByRef _
custom As System.Array) Implements Extensibility.IDTExtensibility2.OnConnection

    applicationObject = CType(application, EnvDTE.DTE)
    addInInstance = CType(addInInst, EnvDTE.AddIn)
    ' Pass the applicationObject member variable to the code example.
    PropertiesExample (applicationObject)
    End Sub

Sub PropertiesExample(ByVal dte As DTE)
    ' Create and initialize a variable to represent the C# 
    ' text editor options page.
    Dim txtEdCS As EnvDTE.Properties = _
    DTE.Properties("TextEditor", "CSharp")
    Dim prop As EnvDTE.Property
    Dim msg As String

    ' Loop through each item in the C# text editor options page. 
    For Each prop In txtEdCS
        msg += ("PROP NAME: " & prop.Name & "   VALUE: " & _
        prop.Value) & vbCr
    Next
    MsgBox(msg)
End Sub

// Add-in code.
Using System.Windows.Forms;
public void OnConnection(object application,
 Extensibility.ext_ConnectMode connectMode, object addInInst,
 ref System.Array custom)
{
    applicationObject = (_DTE)application;
    addInInstance = (AddIn)addInInst;
    // Pass the applicationObject member variable to the code example.
    PropertiesExample((DTE)applicationObject); 
}

public void PropertiesExample( DTE dte ) 
{ 
    // Create and initialize a variable to represent the C# 
    // text editor options page.
    EnvDTE.Properties txtEdCS =
 dte.get_Properties( "TextEditor", "CSharp" ); 
    EnvDTE.Property prop = null; 
    string msg = null; 

    // Loop through each item in the C# text editor options page. 
    foreach ( EnvDTE.Property temp in txtEdCS ) 
    { 
        prop = temp; 
        msg += ( "PROP NAME: " + prop.Name + "   VALUE: " 
+ prop.Value ) + "\n"; 
    }
    MessageBox.Show( msg); 
}

Im folgenden Beispiel, das eine leichte Änderung zum vorherigen Beispiel enthält, können Sie die Einstellungen eines geschachtelten Knotens anzeigen, in diesem Fall den Knoten Formatierung im Knoten C# unter dem Knoten Text-Editor. Um die Änderung auszuführen, ändern Sie den Wert des zweiten Properties-Parameters zu der Einstellung, die Sie anzeigen oder ändern möchten, z. B. DTE.Properties("TextEditor", "Basic-Specific") oder DTE.Properties("Environment", "ProjectsAndSolution"). Die zu verwendenden Werte werden am Anfang dieses Dokuments aufgelistet.

In diesem Fall wird "CSharp - Formatting" verwendet, um die Einstellungen für die Formatierung des C#-Text-Editors anzuzeigen.

' Add-in code.
Sub PropertiesExample()
    ' Create and initialize a variable to represent the C# 
    ' Formatting text editor options page.
    Dim txtEdCSFormat As EnvDTE.Properties = _
    DTE.Properties("TextEditor", "CSharp-Specific")
    Dim prop As EnvDTE.Property
    Dim msg As String

    ' Loop through each item in the C# Formatting Options page. 
    For Each prop In txtEdCSFormat
        msg += ("PROP NAME: " & prop.Name & "   VALUE: " & _
        prop.Value) & vbCr
    Next
    MsgBox(msg)
End Sub

Siehe auch

Aufgaben

Gewusst wie: Erstellen benutzerdefinierter Optionsseiten

Konzepte

Steuern der Einstellungen im Dialogfeld "Optionen" (Menü "Extras")

Bestimmen der Namen von Eigenschaftenelementen auf Optionsseiten