工具窗口显示配置

在 VSPackage 注册工具窗口,默认位置,范围,停靠样式和其他可见性信息指定按 tab 值。 有关工具窗口注册的更多信息,请参见 注册工具窗口

窗口显示信息

工具窗口的基本显示配置存储在六个选项值:

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

名称

类型

数据

说明

名称

REG_SZ

“短名称转到 here”

描述工具窗口的短名称。 仅用于引用在注册表中。

Float

REG_SZ

“X1, Y1, X2, Y2”

四个逗号分隔值。 X1, Y1 是工具窗口的左上角的坐标。 X2, Y2 是右下角的坐标。 所有值用屏幕坐标。

样式

REG_SZ

“MDI”

“浮动”

“links”

“>”

“AlwaysFloat”

指定工具窗口的初始显示状态的关键字。

“MDI” = 停靠的与 MDI 窗口。

“浮动” = 浮动。

“链接的” = 与另一个窗口链接 (在窗口中的项)。

“选项卡式” = 将与另一个工具窗口。

“AlwaysFloat” = 无法停靠。

有关更多信息,请参见下面的批注部分。

窗口

REG_SZ

GUID

工具窗口可链接或选项卡式窗口的 GUID。 GUID 可能属于一个拥有窗口或某个 Visual Studio IDE 的窗口。

Orientation

REG_SZ

“退出”

“右”

“top-level”

“基于”

请参见下面的批注部分。

DontForceCreate

REG_DWORD

0 或 1

当该项存在时,其值不为零,窗口将加载,但是,不会显示。

注释

方向项定义工具窗口停靠的位置,其标题栏中双击时。 该位置相对于在窗口中的项指定的窗口。 如果样式项设置 “links”,方向项可以是 “left”, “类”, “top-level”或 “底部”。 如果样式项 “选项卡式”,方向项可以是 “left”或 “类”并指定选项添加位置。 如果样式项为 “浮动”,工具窗口首先浮动。 在标题栏中双击时,方向和窗口中的项适用,因此, windows 使用 “选项卡式”样式。 如果样式项为 “AlwaysFloat”,工具窗口无法停靠。 如果样式项为 “MDI”,工具窗口与 MDI 区域链接,并且,窗口中的项被忽略。

示例

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}

工具窗口可见性

在选项卡的可见性子项的值确定工具窗口的可见性设置。 值的名称用于存储需要窗口的可见性命令的 GUID。 如果在其上执行, IDE 确保工具窗口中创建并使工作表可见。

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

名称

类型

数据

说明

(默认值)

REG_SZ

留空。

GUID

REG_DWORD 或 REG_SZ

0 或一个描述性字符串。

可选。 访问名称必须是需要可见性的命令的 GUID。 该值包含一个字符串信息。 通常,该值为 reg_dword 设置为 0。

示例

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

请参见

概念

VSPackage Essentials