Configuración de presentación de la ventana de herramientas

Cuando un VSPackage registra una ventana de herramientas, la posición predeterminada, tamaño, acoplar el estilo, y otra información de visibilidad se especifica en valores opcionales. Para obtener más información sobre el registro de la ventana de herramientas, vea registrar las ventanas de herramientas

Información de la ventana

La configuración de presentación básica de una ventana de herramientas se almacena en hasta seis valores opcionales:

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

Name	Tipo	Datos	Descripción
Name	REG_SZ	el “nombre corto va aquí”	un nombre corto que describe la ventana de herramientas. Sólo se utiliza para la referencia en el registro.
Float	REG_SZ	“X1, Y1, X2, Y2”	cuatro valores separados por comas. X1, Y1 es la coordenada de la esquina superior izquierda de la ventana de herramientas. X2, Y2 es la coordenada de la esquina inferior derecha. todos los valores están en coordenadas de la pantalla.
Estilo	REG_SZ	“MDI” “Float” “Vinculado” “Con” “AlwaysFloat”	Una palabra clave que especifica el estado inicial de la ventana de herramientas. “MDI” = acoplados con la ventana MDI. “Float” = flotando. “Vinculado” = vinculadas con otra ventana (especificada en la entrada de la ventana). “Con” = combinado con otra ventana de herramientas. “AlwaysFloat” = no puede acoplarse. Para obtener más información, vea la sección de comentarios a continuación.
Ventana	REG_SZ	GUID	GUID de una ventana en la que la ventana de herramientas puede vincularse o ser con fichas. GUID puede pertenecer a uno de dispone de las ventanas o a una de las ventanas de Visual Studio el IDE.
Orientation	REG_SZ	“Izquierda” la “derecha” “Parte superior” La “”	Vea la sección de comentarios a continuación.
DontForceCreate	REG_DWORD	0 ó 1	Cuando esta entrada está presente y el valor no es cero, la ventana se carga, pero no inmediatamente visible.

Comentarios

La entrada de la orientación define la posición donde se acoplará de la ventana de herramientas cuando doble-se haga clic en la barra de título. Placement es relativa a la ventana especificada en la entrada de la ventana. Si se establece la entrada de estilo “vinculado”, la entrada de la orientación puede “Left”, “correcto”, “parte superior”, o “inferior”. Si la entrada de estilo es “organización por fichas”, la entrada de la orientación puede ser “Left” o “derecha” y especifica dónde se agrega la pestaña. Si la entrada de estilo es “Float”, la ventana de herramientas flota primero. Cuando se hace doble clic en la barra de título, las entradas de la guía y la ventana se aplican, y la ventana utiliza el estilo de “organización por fichas”. Si la entrada de estilo es “AlwaysFloat”, la ventana de herramientas no puede acoplar. Si la entrada de estilo es “MDI”, la ventana de herramientas se vincula al área de MDI, y se omite la entrada de la ventana.

Ejemplo

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}

visibilidad de la ventana de herramientas

Los valores de la subclave opcional de Visibility determinan los valores de visibilidad de una ventana de herramientas. Los nombres de los valores se utilizan para almacenar los GUID de los comandos que requieren la visibilidad de la ventana. Si se ejecuta el comando, el IDE garantiza que la ventana de herramientas se crea y creada 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:

Name	Tipo	Datos	Descripción
(Valor predeterminado)	REG_SZ	None	Deje vacío.
GUID	REG_DWORD o REG_SZ	0 o una cadena descriptiva.	Opcional. El nombre de entrada debe ser un GUID de un comando que requiere visibilidad. El valor sólo contiene una cadena informativa. Normalmente, el valor es reg_dword establecido en 0.

Ejemplo

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

Vea también

Conceptos

VSPackage Essentials