Configuration de l’affichage fenêtre outilTool Window Display Configuration

Quand un VSPackage enregistre une fenêtre outil, la position par défaut, la taille, style d’ancrage et autres informations de visibilité est spécifié dans les valeurs facultatives.When a VSPackage registers a tool window, the default position, size, docking style, and other visibility information is specified in optional values. Pour plus d’informations sur l’inscription de fenêtre outil, consultez fenêtres Outil dans le RegistreFor more information on tool window registration, see Tool Windows in the Registry

Informations d’affichage de fenêtreWindow Display information

Configuration de l’affichage de base d’une fenêtre outil est stockée dans les six valeurs facultatives :A tool window's basic display configuration is stored in up to six optional values:

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  
NameName TypeType DonnéesData DescriptionDescription
NameName REG_SZREG_SZ « Nom court ici »"Short name goes here" Un nom court qui décrit la fenêtre outil.A short name that describes the tool window. Utilisé uniquement pour référence dans le Registre.Used only for reference in the registry.
FloatFloat REG_SZREG_SZ « X1, Y1, X2, Y2 »"X1,Y1,X2,Y2" Quatre valeurs séparées par des virgules.Four comma separated values. X1, Y1 est la coordonnée de l’angle supérieur gauche de la fenêtre outil.X1, Y1 is the coordinate of the upper-left corner of the tool window. X2, Y2 est la coordonnée de l’angle inférieur droit.X2, Y2 is the coordinate of the lower-right corner. Toutes les valeurs sont en coordonnées d’écran.All values are in screen coordinates.
StyleStyle REG_SZREG_SZ « MDI »"MDI"

« Flotter »"Float"

« Lié »"Linked"

« Onglets »"Tabbed"

« AlwaysFloat »"AlwaysFloat"
Un mot clé spécifiant initial afficher l’état de la fenêtre outil.A keyword specifying the initial display state of the tool window.

« MDI » = ancrée à la fenêtre MDI."MDI" = docked with MDI window.

« Flotter » = flottante."Float" = floating.

« Lié » = liée à une autre fenêtre (spécifiée dans l’entrée de fenêtre)."Linked" = linked with another window (specified in the Window entry).

« Onglets » = combinées avec une autre fenêtre d’outil."Tabbed" = combined with another tool window.

« AlwaysFloat » = ne peut pas être ancrée."AlwaysFloat" = cannot be docked.

Pour plus d’informations, consultez la section commentaires ci-dessous.For more information, see the Comments section below.
FenêtreWindow REG_SZREG_SZ <GUID ><GUID> Le GUID d’une fenêtre dans lequel la fenêtre outil peut être liée ou avec onglets.The GUID of a window to which the tool window can be linked or tabbed. Le GUID ne peut appartenir à un de vos propres fenêtres ou l’un des fenêtres dans le Visual StudioVisual Studio IDE.The GUID may belong to one of your own windows or one of the windows in the Visual StudioVisual Studio IDE.
OrientationOrientation REG_SZREG_SZ « Gauche »"Left"

« Right »"Right"

« Top »"Top"

« Bottom »"Bottom"
Consultez la section commentaires ci-dessous.See the Comments section below.
DontForceCreateDontForceCreate REG_DWORDREG_DWORD 0 ou 10 or 1 Lorsque cette entrée est présente et sa valeur n’est pas zéro, la fenêtre est chargée, mais pas immédiatement affichée.When this entry is present and its value is not zero, the window is loaded, but not immediately displayed.

CommentairesComments

L’entrée de l’Orientation définit la position où la fenêtre outil ancre lorsque l’utilisateur double-clique sur la barre de titre.The Orientation entry defines the position where the tool window docks when its title bar is double-clicked. La position est relatif à la fenêtre spécifiée dans l’entrée de la fenêtre.The position is relative to the window specified in the Window entry. Si l’entrée de Style est définie sur « Lié », l’entrée de l’Orientation peut être « Left », « Right », « Top » ou « Bottom ».If the Style entry is set to "Linked", the Orientation entry can be "Left", "Right", "Top", or "Bottom". Si l’entrée de Style est « Avec onglets », l’orientation de l’entrée peut être « gauche » ou « Right » et spécifie où l’onglet est ajouté.If the Style entry is "Tabbed", the Orientation entry can be "Left" or "Right" and specifies where the tab is added. Si l’entrée de Style est « Flotter », la fenêtre Outil flotte tout d’abord.If the Style entry is "Float", the tool window floats first. Lorsque vous double-cliquez sur la barre de titre, les entrées de l’Orientation et la fenêtre s’appliquent, et la fenêtre utilise le style par « onglets ».When the title bar is double-clicked, the Orientation and Window entries apply, and the window uses the "Tabbed" style. Si l’entrée de Style est « AlwaysFloat », la fenêtre outil ne peut pas être ancrée.If the Style entry is "AlwaysFloat", the tool window cannot be docked. Si l’entrée de Style est « MDI », la fenêtre outil est liée à la zone MDI, et l’entrée est ignorée.If the Style entry is "MDI", the tool window is linked to the MDI area, and the Window entry is ignored.

ExempleExample

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 outilTool Window Visibility

Valeurs dans la sous-clé de visibilité facultatif déterminent les paramètres de visibilité d’une fenêtre outil.Values in the optional Visibility subkey determine a tool window's visibility settings. Les noms des valeurs sont utilisés pour stocker les GUID des commandes qui requièrent une visibilité de la fenêtre.The names of the values are used to store the GUIDs of commands that require the window's visibility. Si la commande est exécutée, l’IDE garantit que la fenêtre outil est créée et rendue visible.If the command is executed, the IDE guarantees that the tool window is created and made 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:  
NameName TypeType DonnéesData DescriptionDescription
(Default)(Default) REG_SZREG_SZ AucunNone Laissez vide.Leave empty.
<GUID ><GUID> REG_DWORD ou REG_SZREG_DWORD or REG_SZ 0 ou une chaîne descriptive.0 or a descriptive string. Facultatif.Optional. Nom de l’entrée doit être le GUID d’une commande nécessitant une visibilité.The entry's name must be the GUID of a command requiring visibility. La valeur contient simplement une chaîne informative.The value just holds an informative string. En règle générale, la valeur est un reg_dword définie sur 0.Typically, the value is a reg_dword set to 0.

ExempleExample

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 aussiSee Also

VSPackagesVSPackages