Conjuntos de propriedades DTE

Artigo
08/25/2010

As propriedades de nível de ambiente são organizadas em categorias que correspondem à hierarquia a ser exibida no Opções caixa de diálogo.Para ver o Opções caixa de diálogo o Ferramentas menu, clicar Opções.Para fins de simplicidade, este tópico se refere a essa caixa de diálogo sistema autônomo a caixa de diálogo Opções de ferramentas.Por exemplo, DTE.Properties("TextEditor", "Basic") representa as configurações de Básico nó dentro de Editor de texto nó caixa de diálogo Opções de ferramentas.Muitas vezes, configurações nas caixas de diálogo também são representadas por propriedades.Por exemplo, uma configuração nas guias, Basic, Editor de texto, caixa de diálogo Options é dimensionar de guia.Isso é representado pelo TabSize e TabSize Propriedades. Cada item de propriedade tem um ou mais valores, representados pelo Value propriedade. Para obter informações sobre como alterar valores de opções usando propriedades, consulte Controlar configurações de opções.

Os tópicos em Consulte também seção abaixo lista as categorias predefinidas que acompanham o Visual Studio. No entanto, Visual Studio pacotes podem adicionar suas próprias categorias (páginas de Tools Options) e você pode criar suas próprias páginas personalizadas de Tools Options.

Observação:
As páginas de alguma propriedade no Opções caixa de diálogo não oferecem suporte à automação.As páginas de propriedades que têm suporte para automação listadas na Determinar os nomes de propriedade de itens em páginas de opções.

O mesmo Properties objeto da coleção pode ser acessado em locais diferentes. Por exemplo, uma coleção de propriedades para fontes e cores pode ser acessada com qualquer um dos DTE.Properties("Environment", "FontsAndColors") ou DTE.Properties("TextEditor", "FontsAndColors").

Exemplo

O exemplo a seguir ilustra como exibir todos os itens de propriedade acessíveis em geral, translation from VPE for Csharp, Editor de texto, caixa de diálogo Opções.Observe que, no código, o nó "Translation from VPE for Csharp" deve ser representado sistema autônomo "CSharp." Para obter mais informações sobre como executar o exemplo do suplemento, consulte Como: Compilar e executar os exemplos de códigos automação objeto modelo.

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

Uma modificação pequena do código anterior permite exibir as opções de um nó aninhada, no seguinte caso, a formatação, translation from VPE for Csharp, Editor de texto, página Opções.Para fazer isso, alterando o segundo Properties sistema autônomo opções que desejar exibir ou alterar, sistema autônomo valor do parâmetro DTE.Properties("TextEditor", "Basic - Tabs"), ou DTE.Properties("Environment", "Help - Online"). Os valores a serem usados estão listados no início deste tópico.

Nesse caso usa "CSharp - formatação" para exibir oFormatação configurações para o Editor de texto translation from VPE for Csharp de opções.

' 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 - Formatting")
    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

Compartilhar via

Conjuntos de propriedades DTE

Exemplo

Consulte também

Tarefas

Conceitos

Referência

Recursos adicionais