Cómo: Crear páginas de opciones personalizadas

  • Artículo

Los complementos de Visual Studio están desusados en Visual Studio 2013. Debe actualizar los complementos a las extensiones de VSPackage. Para obtener más información sobre la actualización, vea Preguntas más frecuentes: Convertir complementos en extensiones de VSPackage.

El cuadro de diálogo Opciones muestra varias páginas para distintas partes de Visual Studio. Puede controlar las páginas de opciones existentes, como se indica en Controlar la configuración de opciones, y también puede crear páginas personalizadas propias. Puede usar páginas personalizadas para permitir a los usuarios cambiar la configuración de los complementos u otros programas.

Para crear una página Opciones personalizada, no es necesario usar un complemento, porque la definición de la página se almacena en un archivo XML en lugar de claves del Registro. Por consiguiente, se pueden crear páginas Opciones que estén accesibles en el entorno de desarrollo integrado (IDE) de Visual Studio y también en el IDE de macros.

Los pasos siguientes muestran cómo crear un control de usuario personalizado, que actuará como página Opciones personalizada, y modificar después un archivo .addin que haga referencia a la misma.

Nota

Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, en función de los valores de configuración o de edición activos.Estos procedimientos se han desarrollado con la Configuración de desarrollo general activa.Para cambiar la configuración, haga clic en Importar y exportarconfiguraciones en el menú Herramientas.Para obtener más información, vea Personalizar la configuración de desarrollo en Visual Studio.

Para crear una página Opciones personalizada

  1. Cree un proyecto de Biblioteca de controles de Windows. Denomínelo ToolsOptionsLibrary.dll.

  2. Agregue los controles y la funcionalidad que desee.

    Este control de usuario se convertirá en la página Opciones personalizada. Cambie el tamaño del control de modo que llene el área de cliente del cuadro de diálogo Opciones.

  3. Compile el proyecto.

    Cuando se inicia, Visual Studio busca todos los archivos .addin compartidos y carga los que están presentes. La página de Opciones denominada Seguridad de macros/complementos define un conjunto de tokens para las rutas de acceso de los archivos .addin. Se incluyen los siguientes símbolos (token):

    • %ALLUSERSPROFILE%

    • %APPDATA%

    • %USERPROFILE%

    • %VSAPPDATA%

    • %VSCOMMONAPPDATA%

    Cuando Visual Studio empieza a buscar archivos .addin, reemplaza estos tokens con las cadenas de ruta de acceso siguientes:

    Token

    Ruta de acceso

    %ALLUSERSPROFILE%

    ..\Documents and Settings\All Users\Application Data\Microsoft\MSEnvShared\Addins\

    %APPDATA%

    ..\Documents and Settings\username\Microsoft\MSEnvShared\Addins\

    %USERPROFILE%

    ..\Documents and Settings\username\My Documents\Visual Studio 2010\Addins\

    %VSAPPDATA%

    ..\Documents and Settings\username\Addins\

    %VSCOMMONAPPDATA%

    ..\Documents and Settings\All Users\Addins

    Para obtener más información sobre cómo se registran los complementos, vea Seguridad de complementos.

  4. En uno de los directorios antes enumerados, cree un archivo .addin para hacer referencia a la nueva página Opciones.

    Puede usar el código siguiente a modo de plantilla:

    <?xml version="1.0" encoding="UTF-16" standalone="no"?>
<Extensibility xmlns="https://schemas.microsoft.com/AutomationExtensibility">
    <HostApplication>
        <Name>Microsoft Visual Studio Macros</Name>
        <Version>10.0</Version>
    </HostApplication>
    <HostApplication>
        <Name>Microsoft Visual Studio</Name>
        <Version>10.0</Version>
    </HostApplication>
    <ToolsOptionsPage>
        <Category Name="Environment">
            <SubCategory Name="My Tools Options Page">
                <Assembly><dll location></Assembly>
                <FullClassName>ToolsOptionsLibrary.UserControl1
                </FullClassName>
            </SubCategory>
        </Category>
    </ToolsOptionsPage>
</Extensibility>

  5. En la etiqueta <Assembly></Assembly>, reemplace <dll location> con la ruta de acceso de ToolsOptionsLibrary.dll.

  6. Cambie los valores de <ToolsOptionsPage> (Category Name, SubCategory Name, etc.) para reflejar las particularidades de su control de usuario.

    Por ejemplo, si su control de usuario se denominase "NewPage" y su proyecto fuese "MyTOLib", la etiqueta FullClassName sería MyTOLib.NewPage. Assembly es donde se encuentra la DLL de Opciones. Category Name es el nodo del cuadro de diálogo Opciones donde desea ubicar su página personalizada; por ejemplo, Environment, Debugging o Projects.

    Si especifica un nombre que no existe, se crea un nodo con ese nombre. SubCategory es el nombre que aparece bajo el nodo. Tenga presente hay dos niveles como máximo. No puede agregar un nodo de tercer nivel.

  7. Guarde el archivo como un archivo de texto con extensión .addin en una de las carpetas de archivo de complemento antes descritas. El directorio predeterminado es ..\Documents and Settings\username\Application Data\Microsoft\MSEnvShared\Addins\.

    Cuando Visual Studio se inicia, busca en este directorio las definiciones de página Opciones personalizadas y carga las que encuentra. Puede agregar directorios de complementos o modificar los existentes mediante la página Seguridad de macros/complementos, situada bajo el nodo Entorno del cuadro de diálogo Opciones.

  8. Inicie Visual Studio y haga clic en Opciones en el menú Herramientas.

    Aparecerá su nueva página Opciones.

Vea también

Tareas

Cómo: Cambiar las características de las ventanas

Conceptos

Controlar la configuración de opciones

Registro de complementos

Gráfico del modelo de objetos de automatización

Otros recursos

Crear y controlar las ventanas del entorno

Referencia de automatización y extensibilidad