Configuration d'affichage de la fenêtre Outil

Lorsqu'un VSPackage enregistre une fenêtre Outil, la position par défaut, taille, ancrage le style, et d'autres informations de visibilité est spécifiée dans les valeurs facultatives. Pour plus d'informations sur l'inscription de la fenêtre Outil, consultez Stocker des fenêtres Outil

Les informations d'affichage de la fenêtre

La configuration de base de l'affichage d'une fenêtre Outil est stockée en tant six valeurs facultatives :

HKEY_LOCAL_MACHINE\
  Software\
    Microsoft\
      VisualStudio\
        <Version>\
          ToolWindows\
            <Tool Window GUID>\
              (Default)       = reg_sz: <Package GUID> 
              Name            = reg_sz: <name of tool window> 
              Float           = reg_sz: <position> 
              Style           = reg_sz: <dock style> 
              Window          = reg_sz: <window GUID> 
              Orientation     = reg_sz: <orientation> 
              DontForceCreate = reg_dword: 0x00000000

Nom	Type	Données	Description
Nom	REG_SZ	le « nom court va ici »	un nom court qui décrit la fenêtre Outil. Utilisé uniquement pour la référence dans le Registre.
Float	REG_SZ	« X1, Y1, X2, Y2 »	Quatre valeurs séparées par des virgules. X1, Y1 est la coordonnée de l'angle supérieur gauche de la fenêtre Outil. X2, Y2 est la coordonnée de l'angle inférieur droit. Toutes les valeurs sont dans les coordonnées d'écran.
Style	REG_SZ	« MDI » « Float » « Un » lié « Avec onglets » « AlwaysFloat »	Un mot clé en spécifiant l'état initial d'affichage de la fenêtre Outil. « MDI » = ancré avec la fenêtre MDI. « Float » = flottant. « Un lié » = lié avec une autre fenêtre (spécifiée dans l'entrée de la fenêtre). « Avec onglets = » mixed avec une autre fenêtre Outil. « AlwaysFloat » = ne peut pas être ancré. Pour plus d'informations, consultez la section commentaires ci-dessous.
Fenêtre	REG_SZ	<GUID>	GUID d'une fenêtre dans laquelle la fenêtre Outil peut être liée ou avec onglets. GUID peut appartenir à l'une de vos propres fenêtres ou une des fenêtres dans Visual Studio l'IDE.
Orientation	REG_SZ	« Left » « Droite » « Terminé » « Bas »	Consultez la section commentaires ci-dessous.
DontForceCreate	REG_DWORD	0 ou 1 ;	Lorsque cette entrée est présent et sa valeur n'est pas nul, la fenêtre est chargée, mais pas immédiatement affiche.

Commentaires

L'entrée d'orientation définit la position où la fenêtre Outil s'ancre lorsque sa barre de titre est double-cliquez sur. La position est relative à la fenêtre spécifiée dans l'entrée de la fenêtre. Si l'entrée de style est « liée », l'entrée d'orientation peut être « left », « tout », « haut », ou « bas ». Si l'entrée de style est « avec onglets », l'entrée d'orientation peut rester «  » ou « droite » et spécifiez où l'onglet est ajouté. Si l'entrée de style est « float », la fenêtre Outil flotte en premier. Lorsque la barre de titre est double-cliquez sur, les entrées d'orientation et de fenêtre s'appliquent, et la fenêtre utilise le style « avec onglets ». Si l'entrée de style est « AlwaysFloat », la fenêtre Outil ne peut pas être ancrée. Si l'entrée de style est « MDI », la fenêtre Outil est liée à la zone MDI, et l'entrée de fenêtre est ignorée.

Exemple

HKEY_LOCAL_MACHINE\
  Software\
    Microsoft\
      VisualStudio\
        8.0Exp\
          ToolWindows\
            {A0C5197D-0AC7-4B63-97CD-8872A789D233}\
              (Default)       = reg_sz: {DA9FB551-C724-11D0-AE1F-00A0C90FFFC3}
              DontForceCreate = reg_dword: 0x00000000
              Float           = reg_sz: 100,100,450,300
              Name            = reg_sz: Bookmarks
              Orientation     = reg_sz: Left
              Style           = reg_sz: Tabbed
              Window          = reg_sz: {34E76E81-EE4A-11D0-00A0C90FFFC3}

Visibilité de la fenêtre Outil

Les valeurs de la sous-clé facultative de visibilité déterminent les paramètres de la visibilité d'une fenêtre Outil. Les noms des valeurs sont utilisés pour stocker les GUID des commandes qui requièrent la visibilité de la fenêtre. Si la commande est exécutée, l'IDE garantit que la fenêtre Outil est créée et rendue visible.

HKEY_LOCAL_MACHINE\
  Software\
    Microsoft\
      VisualStudio\
        <Version>\
          ToolWindows\
            <Tool Window GUID>\
              Visibility\
                (Default) = reg_sz:
                <GUID>    = reg_dword:
                <GUID>    = reg_dword:
                <GUID>    = reg_sz:

Nom	Type	Données	Description
(Valeur par défaut)	REG_SZ	Aucun	laissez vide.
<GUID>	REG_DWORD ou REG_SZ	0 ou une chaîne descriptive.	Facultatif. Le nom d'entrée doit être GUID d'une commande qui exigent une visibilité. La valeur tient une chaîne informative. En général, la valeur est reg_dword la valeur 0.

Exemple

HKEY_LOCAL_MACHINE\
  Software\
    Microsoft\
      VisualStudio\
        8.0Exp\
          ToolWindows\
            {EEFA5220-E298-11D0-8F78-00A0C9110057}\
              Visibility\
                (Default) = reg_sz:
                {93694fa0-0397-11d1-9f4e-00a0c911004f} = reg_dword: 0x00000000
                {9DA22B82-6211-11d2-9561-00600818403B} = reg_dword: 0x00000000
                {adfc4e66-0397-11d1-9f4e-00a0c911004f} = reg_dword: 0x00000000

Voir aussi

Concepts

VSPackage Essentials