Kolekcje właściwości DTE

Właściwości poziomu ochrony środowiska są zorganizowane w kategorie, które odpowiadają hierarchii, który jest wyświetlany w Opcje okno dialogowe.Na przykład DTE.Properties("TextEditor", "Basic") reprezentuje ustawienia w podstawowych węzła w obszarze Edytora tekstu węzeł w Opcje okno dialogowe.Wiele z ustawień na stronach w oknie dialogowym są również reprezentowane przez właściwości.Na przykład jedno ustawienie na kart strony w podstawowych węzła w obszarze Edytora tekstu węzeł jest Rozmiar tabulatora.To ustawienie jest reprezentowana przez TabSize i TabSize właściwości.Każdy element właściwości ma jedną lub więcej wartości, które są reprezentowane przez Value właściwości.Aby uzyskać informacje o zmienianiu wartości za pomocą właściwości, zobacz Kontrolowanie ustawień opcji.

Następujące dokumenty listę wstępnie zdefiniowanych kategorii ustawień, które są uwzględnione w Visual Studio.

• Opcje strony, właściwości węzła środowiska

• Opcje strony, czcionki i kolory węzeł właściwości

• Opcje strony, właściwości węzła edytora tekstu

• Opcje edytora tekstów, C#, formatowanie

Aby dodać do istniejącego ustawienia Opcje stronę, lub aby dodać niestandardową stronę Opcje okno dialogowe, użyj Visual Studio SDK.Aby uzyskać więcej informacji, zobacz Rozwój narzędzi ekosystemu partnerów Portal witryny sieci Web.

[!UWAGA]

Niektóre strony w Opcje okno dialogowe nie obsługują automatyzacji.Aby uzyskać informacje o tym, które właściwości strony obsługują automatyzacji, zobacz Określanie nazw właściwości elementów na stronach opcje.

Aby otworzyć Opcje w oknie dialogowym w zintegrowane środowisko programistyczne (IDE), na Narzędzia menu, kliknij przycisk Opcje.

Przykład

Poniższy przykład przedstawia sposób wyświetlić elementy dostępne właściwości na Ogólne strony w C# węzła w obszarze Edytora tekstu węzeł w Opcje okno dialogowe.Należy zauważyć, że w kodzie, węzeł "C#" musi być reprezentowana jako "CSharp". Aby uzyskać więcej informacji o sposobach uruchamiania przykładu w, zobacz Jak: skompilować i uruchomić przykłady kodu modelu obiektu automatyzacji.

' 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); 
}

W poniższym przykładzie zawiera nieznaczne zmiany do poprzedniego przykładu, można przeglądać ustawienia zagnieżdżenia węzłów, w tym przypadku, Formatowanie węzeł w C# węzła w obszarze Edytora tekstu węzła.Aby wprowadzić zmiany, należy zmienić wartość drugiego Properties parametr do ustawienia, które chcesz wyświetlić lub zmienić, na przykład, DTE.Properties("TextEditor", "Basic-Specific"), lub DTE.Properties("Environment", "ProjectsAndSolution").Wartości, które mają być wymienione na początku tego dokumentu.

Ten przypadek używa "CSharp — formatowanie" Aby wyświetlić Formatowanie ustawienia dla języka C# edytora tekstu.

' 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

Zobacz też

Zadania

Jak: Tworzenie niestandardowych stron apletu Opcje

Koncepcje

Kontrolowanie ustawień opcji

Określanie nazw właściwości elementów na stronach opcje