Kolekce vlastností DTE

Doplňky Visual Studio jsou ve verzi aplikace Visual Studio 2013 zastaralé.Měli byste upgradovat doplňky na rozšíření VSPackage.Další informace o upgradu viz Nejčastější dotazy: Převádění doplňků na rozšíření VSPackage.

Vlastnosti na úrovni prostředí jsou uspořádány do kategorií, které odpovídají hierarchii, která je zobrazena v dialogovém okně Možnosti.Například DTE.Properties("TextEditor", "Basic") představuje nastavení v uzlu Základní v uzlu Textový editor v dialogovém okně Možnosti.Mnoho nastavení stránek v dialogovém okně je reprezentováno také vlastnostmi.Například jedno nastavení na stránce Karty v uzlu Základní pod uzlem Textový editor je Velikost tabulky.Toto nastavení je reprezentováno vlastnostmi TabSize a TabSize.Každá položka vlastnosti obsahuje jednu nebo více hodnot, které jsou znázorněny vlastností Value.Informace o změně hodnot pomocí vlastností naleznete v tématu Řízení nastavení možností.

V následujících dokumentech jsou uvedeny předdefinované kategorie nastavení, které jsou zahrnuty v aplikaci Visual Studio.

• Stránka Možnosti, vlastnosti uzlu prostředí

• Vlastnosti uzlu barvy, písma a možnosti stránky

• Stránka Možnosti, vlastnosti uzlu textového editoru

• Možnosti, textový editor, C#, formátování

Chcete-li přidat nastavení na existující stránku Možnosti, nebo chcete-li přidat vlastní stránku do dialogového okna Možnosti, použijte Visual Studio SDK.Další informace naleznete na webu Vývojové nástroje ekosystému partnerského portálu.

[!POZNÁMKA]

Některé stránky v dialogovém okně Možnosti okně nepodporují automatizaci.Informace o tom, jaké stránky vlastností podporují automatizaci, naleznete v tématu Určování názvů pr položky vlastností na stránkách možností.

Chcete-li otevřít dialogové okno Možnosti v integrovaném vývojovém prostředí (IDE), v nabídce Nástroje klepněte na tlačítko Možnosti.

Příklad

Následující příklad ukazuje, jak zobrazit dostupné položky vlastností na stránce Obecné v uzlu C# v uzlu Textový editor v dialogovém okně Možnosti.Všimněte si, že v kódu musí být uzel „C#“ reprezentován jako„CSharp“. Další informace o způsobu spuštění příkladu doplňku naleznete v části Postupy: Kompilace a spuštění příkladů kódu objektu automatizace.

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

V následujícím příkladu, který obsahuje drobné změny předchozího příkladu, můžete zobrazit nastavení vnořeného uzlu, v tomto případě uzlu Formátování v uzlu C# v uzlu Textový editor.Chcete-li provést změny, změňte hodnotu druhého parametru Properties nastavení, které chcete zobrazit nebo změnit, například DTE.Properties("TextEditor", "Basic-Specific") nebo DTE.Properties("Environment", "ProjectsAndSolution").Hodnoty pro použití jsou uvedeny na začátku tohoto dokumentu.

Tento případ používá „CSharp – Formatting“ ke zobrazení nastavení Formátování pro textový Editor C#.

' 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

Viz také

Úkoly

Postupy: Vytváření vlastních stránek možností

Koncepty

Řízení nastavení možností

Určování názvů pr položky vlastností na stránkách možností