Comment : créer des pages d'options personnalisées

  • Article

La boîte de dialogue Options affiche diverses pages pour les différentes parties de Visual Studio. Vous pouvez contrôler les pages d'options existantes, comme indiqué dans Contrôle des paramètres de la boîte de dialogue Options, et créer vos propres pages personnalisées. Vous pouvez utiliser des pages personnalisées pour permettre aux utilisateurs de modifier des paramètres pour vos compléments ou pour d'autres programmes.

Pour créer votre propre page Options personnalisée, vous n'êtes pas obligé d'utiliser un complément, car la définition de page est stockée dans un fichier XML au lieu de clés de Registre. Par conséquent, vous pouvez créer des pages Options accessibles dans l'environnement de développement intégré (IDE) de Visual Studio, ainsi que dans l'éditeur de macros.

Les étapes suivantes montrent comment créer un contrôle utilisateur personnalisé qui agit en tant que page Options personnalisée, puis comment modifier un fichier .addin pour le référencer.

Notes

Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée. Ces procédures ont été développées avec les paramètres de développement généraux actifs. Pour modifier vos paramètres, cliquez dans le menu Outils sur Importation et exportation de paramètres. Pour plus d'informations, consultez Utilisation des paramètres.

Pour créer une page Options personnalisée

  1. Créez un projet de bibliothèque de contrôles Windows. Nommez-le ToolsOptionsLibrary.dll.

  2. Ajoutez les contrôles et fonctionnalités souhaités.

    Ce contrôle utilisateur deviendra la page Options personnalisée. Redimensionnez le contrôle pour remplir la zone cliente de la boîte de dialogue Options.

  3. Générez le projet.

    Lorsqu'il démarre, Visual Studio recherche tous les fichiers .addin partagés et charge ceux qui sont présents. La page Options nommée Sécurité des compléments/macros définit un jeu de jetons pour les chemins d'accès des fichiers .addin. Les jetons suivants sont inclus :

    • %ALLUSERSPROFILE%

    • %APPDATA%

    • %USERPROFILE%

    • %VSAPPDATA%

    • %VSCOMMONAPPDATA%

    Lorsque Visual Studio commence à rechercher des fichiers .addin, il remplace ces jetons par les chaînes de chemin d'accès suivantes :

    Jeton

    Chemin d'accès

    %ALLUSERSPROFILE%

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

    %APPDATA%

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

    %USERPROFILE%

    .. \Documents and Settings\NomUtilisateur\Mes documents\Visual Studio 2010\Addins\

    %VSAPPDATA%

    .. \Documents and Settings\NomUtilisateur\Addins\

    %VSCOMMONAPPDATA%

    .. \Documents and Settings\All Users\Addins

    Pour plus d'informations sur l'inscription des compléments, consultez Sécurité des compléments.

  4. Dans l'un des répertoires listés précédemment, créez un fichier .addin pour référencer la nouvelle page Options.

    Vous pouvez utiliser le code suivant comme modèle :

    <?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. Dans la balise <Assembly></Assembly>, remplacez <dll location> en utilisant le chemin d'accès de ToolsOptionsLibrary.dll.

  6. Modifiez les paramètres de <ToolsOptionsPage> (Category Name, SubCategory Name, etc.) pour refléter les caractéristiques de votre contrôle utilisateur.

    Par exemple, si votre contrôle utilisateur se nomme "NewPage" et si son projet est "MyTOLib", la balise FullClassName doit être MyTOLib.NewPage. Assembly est l'emplacement où se trouve la DLL des options. Category Name est le nœud de la boîte de dialogue Options où vous voulez trouver votre page personnalisée, par exemple, Environment, Debugging ou Projects.

    Si vous spécifiez un nom qui n'existe pas, un nœud portant ce nom est créé. SubCategory est le nom qui apparaît sous le nœud. Notez que le nombre maximal de niveaux est 2. Vous ne pouvez pas ajouter de nœud de troisième niveau.

  7. Enregistrez le fichier en tant que fichier texte avec l'extension .addin dans l'un des dossiers de fichiers de complément décrits précédemment. Le répertoire par défaut est ..\Documents and Settings\NomUtilisateur\Application Data\Microsoft\MSEnvShared\Addins\.

    Lorsque Visual Studio démarre, il recherche des définitions de page Options personnalisées dans ce répertoire et charge celles qu'il trouve. Vous pouvez modifier ou ajouter des répertoires de complément en utilisant la page Sécurité des compléments / macros sous le nœud Environnement dans la boîte de dialogue Options.

  8. Démarrez Visual Studio, puis cliquez dans le menu Outils sur Options.

    Votre nouvelle page Options s'affiche.

Voir aussi

Tâches

Comment : modifier les caractéristiques d'une fenêtre

Concepts

Contrôle des paramètres de la boîte de dialogue Options

Inscription d'un complément

Graphique Modèle d'objet Automation

Autres ressources

Création et contrôle de fenêtres d'environnement

Guide de référence de l'extensibilité et de l'automation