Partilhar via

Controlar configurações de opções

  • Artigo

You can activate or deactivate the settings of the various pages in the Options dialog box on the Tools menu (hereafter called "Options pages").Simply use the Properties and Value properties and Item method of the DTE object in the Visual Studio automation model.

Observação:

Isso adiciona o algum código UI$$$$ método. Opções páginas não estão acessíveis por meio de programação.A maioria dos itens, sistema autônomo o comentário Lista de tokens na lista de tarefa página Opções, podem ser exibidos ou alterada programaticamente.Mas alguns Opções páginas, sistema autônomo a Ajuda dinâmica página, que é no Ajuda nó de do Ambiente página, não é possível.Além disso, enquanto alguns Opções páginas têm configurações programáveis, alguns itens na página não são necessariamente acessíveis.Se que você não pode afetar uma configuração, talvez você precise usar o Programa Visual Studio Industry Partner (VSIP) Para fazer isso. Para obter mais informações, consulte a seção "Adicionando o configurações para páginas opções existentes" neste tópico.Para obter uma lista completa das opções acessíveis por meio de programação e seus nomes exatos, consulte "Nomes de item de propriedade" emDeterminar os nomes de propriedade de itens em páginas de opções.

Exibindo configurações de opções

Use o Properties coleção e Property objeto acesso as configurações de um existente Opções página.O exemplo a seguir VSMacro exibe todos os nomes e valores corrente de todos os itens na página Opções de documentos.

' Macro code.
Sub PropertiesExample()
    ' Create and initialize a variable to represent the Documents 
    ' Options page.
    Dim envGenTab As EnvDTE.Properties = _
    DTE.Properties("Environment", "Documents")
    Dim prop As EnvDTE.Property
    Dim msg As String

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

O exemplo a seguir VSMacro exibe todas as propriedades disponível no Opções página de a Lista de tarefas sob o Ambiente nó.Ela também lista todos os valores disponível para o comentário Lista de tokens.

' Macro code.
Sub DisplayProperties()
    ' Variables to represent the properties collection
    ' and each property in the Options dialog box.
    Dim prop As EnvDTE.Property
    Dim props As EnvDTE.Properties
    Dim propVals As Object()
    Dim propVal, msg As String

    ' Represents the Task List Node under the 
    ' Enviroment node.
    props = DTE.Properties("Environment", "TaskList")
    ' Represents the items in the comment Token list
    ' and their priorities (1-3/low-high).
    prop = props.Item("CommentTokens")
    propVals = prop.Value

    Try
        ' List each property name for the Options page
        ' and all of its possible values.
        For Each prop In props
            msg += "PROP NAME: " & prop.Name & vbCr
            For Each propVal In propVals
                msg += "  Value: " & propVal & vbCr
            Next
        Next
        MsgBox(msg)
    Catch ex As System.Exception
        MsgBox("ERROR: " & ex.Message)
    End Try
End Sub

Este exemplo lista todas as configurações programáveis para o Opções página no Editor de texto | translation from VPE for Csharp | formatação.

' Macro 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

Alterando as configurações de opções

Enquanto você pode alterar o valor de controles em uma existente Opções página, não é possível adicionar, remover ou modificar qualquer uma das suas configurações ou controles.Para especificar suas próprias configurações, você deve criar um personalizada Opções página.Para obter mais informações, consulte Como: Criar páginas de opções de ferramentas personalizadas.

Alterar o valor de um item em um Opções página é muito semelhante ao exibir seu valor.Os exemplos de macro a seguir demonstram como fazer isso.

O primeiro exemplo (ToolOpt1) alterna o valor booliano de ReuseSavedActiveDocWindow, que é igual à opção "Reuse janela do documento corrente, se salvo" no Documentos página de do Ambiente nó.

' Macro code.
Sub ToolOpt1()
    Dim props As EnvDTE.Properties = DTE.Properties("Environment", _
    "Documents")
    Dim prop As EnvDTE.Property

    prop = props.Item("ReuseSavedActiveDocWindow")
    ' If value is TRUE, change it to FALSE, or vice-versa.
    MsgBox("PROP NAME: " & prop.Name & "   VALUE: " & prop.Value)
    prop.Value = Not (prop.Value)
    MsgBox("PROP NAME: " & prop.Name & "   VALUE: " & prop.Value)
    ' Change it to the original value.
    prop.Value = Not (prop.Value)
End Sub

O exemplo a seguir VSMacro altera e redefine o dimensionar de guia valor de a Guias o seçãoBásico página de do Editor de texto nó.

' Macro code.
Sub ToolOpt2()
    Dim props As EnvDTE.Properties = DTE.Properties("TextEditor", _
    "Basic")
    Dim prop As EnvDTE.Property
    Dim tmp As String

    prop = props.Item("TabSize")
    ' Set a new value for Tab Size.
    MsgBox("PROP NAME: " & prop.Name & "   VALUE: " & prop.Value)
    tmp = prop.Value
    prop.Value = 10
    MsgBox("PROP NAME: " & prop.Name & "   VALUE: " & prop.Value)
    ' Change it back to the original value.
    prop.Value = tmp
    MsgBox("PROP NAME: " & prop.Name & "   VALUE: " & prop.Value)
End Sub

Este exemplo VSMacro altera uma configuração no As fontes e cores página de do Ambiente nó.

' Macro code.
Sub ToolOpt3()
    ' Changes the background color of text in the Fonts and Colors
    ' page of the Options dialog box on the Tools menu.
    Dim props As EnvDTE.Properties
    Dim prop As EnvDTE.Property
    Dim fontColorItems As EnvDTE.FontsAndColorsItems

    props = DTE.Properties("FontsAndColors", "TextEditor")
    prop = props.Item("FontsAndColorsItems")
    fontColorItems = prop.Object

    Try
        MsgBox("NAME: " & prop.Name & vbCr & "BACKGROUND VALUE: " & _
        CStr(fontColorItems.Item("Plain Text").Background.ToString))
        ' Turn the text background from its current color to red.
        fontColorItems.Item("Plain Text").Background = 255
        MsgBox("NAME: " & prop.Name & vbCr & "BACKGROUND VALUE: " & _
        Hex(fontColorItems.Item("Plain Text").Background.ToString))
    Catch ex As System.Exception
        MsgBox("ERROR: " & ex.Message)
    End Try
End Sub

Este exemplo VSMacro ativa de numeração de linhas para vários idiomas no Editor de texto nó de do Opções caixa de diálogo.

' Macro code.
Sub TurnOnLineNumbers()
   DTE.Properties("TextEditor", "Basic").Item("ShowLineNumbers") _
   .Value = True
   DTE.Properties("TextEditor", "PlainText").Item("ShowLineNumbers") _
   .Value = True
   DTE.Properties("TextEditor", "CSharp").Item("ShowLineNumbers") _
   .Value = True
   DTE.Properties("TextEditor", "HTML/XML").Item("ShowLineNumbers") _
   .Value = True
   DTE.Properties("TextEditor", "C/C++").Item("ShowLineNumbers") _
   .Value = True
   DTE.Properties("TextEditor", "Visual JSharp") _
   .Item("ShowLineNumbers").Value = True
End Sub

Adicionando configurações às páginas de opções existente

Em algum ponto, convém alterar ou adicionar suas próprias configurações existentes Opções páginas, sistema autônomo adicionar suas próprias configurações de fonte para o sistema autônomo fontes e cores página.Isso não pode ser concluído usando o Visual Studio modelo de automação. Você deve usar o Programa Visual Studio Industry Partner (VSIP). Para obter mais informações, consulte o O Visual site do Studio Industry parceiro.

Consulte também

Tarefas

Como: Criar páginas de opções de ferramentas personalizadas

Como: Alterar características de janela

Como: Criar um suplemento

Demonstra Passo a passo: Criando um assistente

Conceitos

Gráfico do modelo de objetos de automação

Outros recursos

Criando e controlando o ambiente Windows

Criando suplementos e assistentes

Automação e referência a extensibilidade