Colecciones de propiedades de DTE

Las propiedades de nivel de entorno se organizan en categorías, que corresponden a la jerarquía mostrada en el cuadro de diálogo Opciones. Por ejemplo, DTE.Properties("TextEditor", "Basic") representa la configuración del nodo Basic bajo el nodo Editor de texto en el cuadro de diálogo Opciones. Muchos de los valores para las páginas en el cuadro de diálogo también se representan a través de propiedades. Por ejemplo, un valor de la página Tabulaciones en el nodo Basic bajo el nodo Editor de texto es Tamaño de tabulación. Esta configuración se representa mediante las propiedades TabSize y TabSize. Cada elemento de propiedad tiene uno o más valores, representados por la propiedad Value. Para obtener información sobre cómo cambiar los valores mediante propiedades, vea Controlar la configuración de opciones.

En los siguientes documentos se enumeran las categorías de configuraciones predefinidas que se incluyen en Visual Studio.

• Página de opciones, Propiedades de nodo Entorno

• Página de opciones, Propiedades de nodo Fuentes y colores

• Página de opciones, Propiedades de nodo Editor de texto

• Formato, C#, Editor de texto, Opciones (Cuadro de diálogo)

Para agregar valores de configuración a una página Opciones existente, o bien agregar una página personalizada al cuadro de diálogo Opciones, use Visual Studio SDK. Para obtener más información, vea el sitio web Development Tools Ecosystem Partner Portal.

Nota

Algunas páginas del cuadro de diálogo Opciones no admiten automatización. Para obtener información sobre qué páginas de propiedades admiten automatización, vea Determinar los nombres de los elementos de propiedades en las páginas de opciones.

Para abrir el cuadro de diálogo Opciones en el entorno de desarrollo integrado (IDE), en el menú Herramientas, haga clic en Opciones.

Ejemplo

En el ejemplo siguiente se muestra cómo ver los elementos de propiedad a los que se puede obtener acceso en la página General del nodo C# bajo el nodo Editor de texto del cuadro de diálogo Opciones. Tenga en cuenta que en código, el nodo "C#" se debe representar como "CSharp". Para obtener más información sobre cómo ejecutar el ejemplo de complemento, vea Cómo: Compilar y ejecutar los ejemplos de código del modelo de objetos de automatización.

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

En el ejemplo siguiente, que contiene una leve modificación del ejemplo anterior, puede ver la configuración de un nodo anidado, en este caso, el nodo Formato en el nodo C# bajo el nodo Editor de texto. Para realizar la modificación, cambie el valor del segundo parámetro Properties a la configuración que desea ver o cambiar, por ejemplo, DTE.Properties("TextEditor", "Basic-Specific") o DTE.Properties("Environment", "ProjectsAndSolution"). Los valores que se utilizan aparecen al principio de este documento.

En este ejemplo se utiliza "CSharp - Formato" para ver la configuración de formato del Editor de texto de 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

Vea también

Tareas

Cómo: Crear páginas de opciones personalizadas

Conceptos

Controlar la configuración de opciones

Determinar los nombres de los elementos de propiedades en las páginas de opciones