Coleções de propriedades DTE

As propriedades de nível de ambiente são organizadas em categorias que correspondem ao que é exibida na hierarquia do Opções caixa de diálogo.Por exemplo, DTE.Properties("TextEditor", "Basic") representa as configurações no básica nó sob o Editor de texto nó na Opções caixa de diálogo.Muitas das configurações nas páginas na caixa de diálogo também são representadas por propriedades.Por exemplo, uma configuração na guias de página na básica nó sob o Editor de texto nó é tamanho da tabulação.Essa configuração é representada pela TabSize e TabSize propriedades.Cada item de propriedade possui um ou mais valores, que são representados pela Value propriedade.Para obter informações sobre como alterar os valores usando as propriedades, consulte Controlando as configurações de opções.

Os seguintes documentos de categorias predefinidas de configurações que estão incluídas na listam Visual Studio.

• Página de opções, propriedades de nó de ambiente

• Página Opções, as fontes e cores nó propriedades

• Página de opções, propriedades de nó do Editor de texto

• Opções, o Editor de texto, C#, formatação

Para adicionar configurações para uma existente Opções página, ou para adicionar uma página personalizada para o Opções caixa de diálogo, use o SDK do Visual Studio.Para obter mais informações, consulte o Portal de parceiros de ecossistema de ferramentas de desenvolvimento site da Web.

Observação
Algumas páginas da Opções caixa de diálogo não oferecem suporte a automação.Para obter informações sobre qual propriedade páginas oferecem suporte a automação, consulte Determinando os nomes dos itens de propriedade nas páginas de opções.

Para abrir o Opções caixa de diálogo no ambiente de desenvolvimento integrado (IDE), sobre o Ferramentas menu, clique em Opções.

Exemplo

O exemplo a seguir ilustra como exibir os itens de propriedade acessíveis na Geral de página na C# nó sob o Editor de texto nó na Opções caixa de diálogo.Observe que no código, o nó "C#" deve ser representado como "CSharp". Para obter mais informações sobre como executar o suplemento de exemplo, consulte Como: compilar e executar os exemplos de código de modelo de objeto de automação.

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

No exemplo a seguir, que contém uma pequena modificação ao exemplo anterior, você pode exibir as configurações de um nó aninhado, nesse caso, o formatação nó a C# nó sob o Editor de texto nó.Para fazer a modificação, altere o valor da segunda Properties parâmetro para a configuração que você deseja exibir ou alterar, por exemplo, DTE.Properties("TextEditor", "Basic-Specific"), ou DTE.Properties("Environment", "ProjectsAndSolution").Os valores a serem usados estão listados no início deste documento.

Esse caso usa "Formatação CSharp –" para ler o formatação as configurações de C# Editor de texto.

' 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

Consulte também

Tarefas

Como: criar páginas de opções personalizadas

Conceitos

Controlando as configurações de opções

Determinando os nomes dos itens de propriedade nas páginas de opções