_NSTCSTYLE 枚举 (shobjidl_core.h)

  • 项目

描述给定命名空间树控件的特征。

语法

typedef enum _NSTCSTYLE {
  NSTCS_HASEXPANDOS = 0x1,
  NSTCS_HASLINES = 0x2,
  NSTCS_SINGLECLICKEXPAND = 0x4,
  NSTCS_FULLROWSELECT = 0x8,
  NSTCS_SPRINGEXPAND = 0x10,
  NSTCS_HORIZONTALSCROLL = 0x20,
  NSTCS_ROOTHASEXPANDO = 0x40,
  NSTCS_SHOWSELECTIONALWAYS = 0x80,
  NSTCS_NOINFOTIP = 0x200,
  NSTCS_EVENHEIGHT = 0x400,
  NSTCS_NOREPLACEOPEN = 0x800,
  NSTCS_DISABLEDRAGDROP = 0x1000,
  NSTCS_NOORDERSTREAM = 0x2000,
  NSTCS_RICHTOOLTIP = 0x4000,
  NSTCS_BORDER = 0x8000,
  NSTCS_NOEDITLABELS = 0x10000,
  NSTCS_TABSTOP = 0x20000,
  NSTCS_FAVORITESMODE = 0x80000,
  NSTCS_AUTOHSCROLL = 0x100000,
  NSTCS_FADEINOUTEXPANDOS = 0x200000,
  NSTCS_EMPTYTEXT = 0x400000,
  NSTCS_CHECKBOXES = 0x800000,
  NSTCS_PARTIALCHECKBOXES = 0x1000000,
  NSTCS_EXCLUSIONCHECKBOXES = 0x2000000,
  NSTCS_DIMMEDCHECKBOXES = 0x4000000,
  NSTCS_NOINDENTCHECKS = 0x8000000,
  NSTCS_ALLOWJUNCTIONS = 0x10000000,
  NSTCS_SHOWTABSBUTTON = 0x20000000,
  NSTCS_SHOWDELETEBUTTON = 0x40000000,
  NSTCS_SHOWREFRESHBUTTON
} ;

常量

 
NSTCS_HASEXPANDOS
值： 0x1
控件在具有子项的项的最左侧边缘显示一个三角形（称为 expando）。 单击 expando 可展开项以显示项的子项。 与NSTCS_SHOWTABSBUTTON、NSTCS_SHOWDELETEBUTTON或NSTCS_SHOWREFRESHBUTTON结合使用时不起作用。



映射到 TVS_HASBUTTONS 树视图控件样式。
NSTCS_HASLINES
值： 0x2
控件在树项的左侧绘制线条，以指向其单独的父项。 与NSTCS_SHOWTABSBUTTON、NSTCS_SHOWDELETEBUTTON或NSTCS_SHOWREFRESHBUTTON结合使用时不起作用。



映射到 TVS_HASLINES 树视图控件样式。
NSTCS_SINGLECLICKEXPAND
值： 0x4
项展开以显示其子项以响应单击鼠标。



映射到 TVS_SINGLEEXPAND 树视图控件样式。
NSTCS_FULLROWSELECT
值： 0x8
无论文本的长度如何，项目选择都会用反转文本填充到窗口区域末尾的行中。 如果未声明此选项，则仅反转文本后面的区域。 此值不能与 NSTCS_HASLINES 组合使用。



映射到 TVS_FULLROWSELECT 树视图控件样式。
NSTCS_SPRINGEXPAND
值： 0x10
选择并展开一个项目并选择第二个项目时，第一个选择将自动折叠。


这与 TVS_EX_NOSINGLECOLLAPSE 树视图控件样式相反。
NSTCS_HORIZONTALSCROLL
值： 0x20
包含命名空间项树的窗口区域具有水平滚动条。



映射到 WS_HSCROLL Windows 样式。
NSTCS_ROOTHASEXPANDO
值： 0x40
根项前面有一个 expando，该扩展允许扩展根项。



映射到 TVS_LINESATROOT 树视图控件样式。
NSTCS_SHOWSELECTIONALWAYS
值： 0x80
当控件没有焦点时，将大纲显示项的节点。



映射到 TVS_SHOWSELALWAYS 树视图控件样式。
NSTCS_NOINFOTIP
值： 0x200
当鼠标光标位于某个项上时，不显示信息提示。



这与 TVS_INFOTIP 树视图控件样式相反。
NSTCS_EVENHEIGHT
值： 0x400
将项的高度设置为偶数高度。 默认情况下，项的高度可以是偶数或奇数。



这与 TVS_NONEVENHEIGHT 树视图控件样式相反。
NSTCS_NOREPLACEOPEN
值： 0x800
不要将快捷菜单中的 Open 命令替换为用户定义的函数。
NSTCS_DISABLEDRAGDROP
值： 0x1000
不允许控件中的拖放操作。 请注意，仍然可以从控件外部拖动项并将其拖放到控件上。



映射到 TVS_DISABLEDRAGDROP 树视图控件样式。
NSTCS_NOORDERSTREAM
值： 0x2000
不要保留重新排序更改。 与 NSTCS_FAVORITESMODE 一起使用。 如果未指定收藏夹模式，则此标志不起作用。
NSTCS_RICHTOOLTIP
值： 0x4000
使用丰富的工具提示。 丰富的工具提示除了显示项的文本外，还显示项的图标。 标准工具提示仅显示项的文本。 树视图仅显示树中部分可见的项的工具提示。



映射到 TVS_EX_RICHTOOLTIP 树视图控件样式。

除非与NSTCS_NOINFOTIP和/或NSTCS_FAVORITESMODE结合使用，否则NSTCS_RICHTOOLTIP不起作用。 如果未指定NSTCS_NOINFOTIP，则树视图将显示信息提示而不是工具提示。 如果未指定NSTCS_FAVORITESMODE，则命名空间树控件始终设置 TVS_EX_RICHTOOLTIP 样式。
NSTCS_BORDER
值： 0x8000
在控件周围绘制细边框。 对应于 WS_BORDER。
NSTCS_NOEDITLABELS
值： 0x10000
不允许创建就地编辑框，这将允许用户重命名给定项。



这与 TVS_EDITLABELS 树视图控件样式相反。
NSTCS_TABSTOP
值： 0x20000
如果控件是托管的，则可以在控件中选项卡停止。 对应于 WS_EX_CONTROLPARENT。
NSTCS_FAVORITESMODE
值： 0x80000
控件具有 Windows XP 中收藏夹带的外观。
NSTCS_AUTOHSCROLL
值： 0x100000
将鼠标指针悬停在超出控件窗口末尾的项上时，控件会自动水平滚动，使该项在窗口区域中更完整地显示。



映射到 TVS_EX_AUTOHSCROLL 树视图控件样式。
NSTCS_FADEINOUTEXPANDOS
值： 0x200000
如果控件没有焦点，并且前面有一些项是 expandos，则只有当鼠标指针靠近控件时，这些 expandos 才可见。



映射到 TVS_EX_FADEINOUTEXPANDOS 树视图控件样式。
NSTCS_EMPTYTEXT
值： 0x400000
如果某个项没有子项且未展开，则该项在子级包含一行文本，显示“空”。
NSTCS_CHECKBOXES
值： 0x800000
项目最左侧有检查框。 这些检查框可以是部分、排除或灰显的，对应于NSTCS_PARTIALCHECKBOXES、NSTCS_EXCLUSIONCHECKBOXES和NSTCS_DIMMEDCHECKBOXES标志。



映射到 TVS_CHECKBOXES 树视图控件样式。
NSTCS_PARTIALCHECKBOXES
值： 0x1000000
在给定项的最左侧添加一个复选框图标，中间有一个正方形，指示节点已部分选中。 必须与 NSTCS_CHECKBOXES 结合使用。



映射到 TVS_EX_PARTIALCHECKBOXES 树视图控件样式。
NSTCS_EXCLUSIONCHECKBOXES
值： 0x2000000
在包含红色 X 的给定项的最左侧添加复选框图标，该图标指示该项目已从当前选定内容中排除。 如果没有此排除图标，父项的选择包括选择其子项。 必须与 NSTCS_CHECKBOXES 结合使用。



映射到 TVS_EX_EXCLUSIONCHECKBOXES 树视图控件样式。
NSTCS_DIMMEDCHECKBOXES
值： 0x4000000
在给定项最左侧添加一个复选框，其中包含一个灰色检查标记图标，指示已选择节点，因为已选择其父节点。 必须与 NSTCS_CHECKBOXES 结合使用。



映射到 TVS_EX_DIMMEDCHECKBOXES 树视图控件样式。
NSTCS_NOINDENTCHECKS
值： 0x8000000
复选框位于窗口区域的最左侧边缘，而不是缩进。



映射到 TVS_EX_NOINDENTSTATE 树视图控件样式。
NSTCS_ALLOWJUNCTIONS
值： 0x10000000
允许接合点。 交接点（或只是交接点）是命名空间扩展的根，通常由 Windows 资源管理器显示为树和文件夹视图中的文件夹。 要使 Windows 资源管理器显示扩展的文件和子文件夹，必须指定根文件夹在 Shell 命名空间层次结构中的位置。



交接点作为文件存在于文件系统中，但不被视为文件。 例如，具有 .zip 文件扩展名的压缩文件，而文件系统中只是一个文件。 但是，如果此文件被视为交接点，它可以表示整个命名空间。 这允许命名空间树控件将压缩的文件和类似的交接点视为文件夹而不是文件。
NSTCS_SHOWTABSBUTTON
值： 0x20000000
如果项是文件夹，则显示项目右侧的箭头。 与箭头关联的操作特定于实现。 不能与 NSTCS_SHOWDELETEBUTTON 或 NSTCS_SHOWREFRESHBUTTON 结合使用。
NSTCS_SHOWDELETEBUTTON
值： 0x40000000
在项的右侧显示红色 X 。 与 X 关联的操作特定于实现。 不能与NSTCS_SHOWTABSBUTTON或NSTCS_SHOWREFRESHBUTTON结合使用。
NSTCS_SHOWREFRESHBUTTON
在项的右侧显示刷新按钮。 与按钮关联的操作特定于实现。 不能与 NSTCS_SHOWTABSBUTTON 或 NSTCS_SHOWDELETEBUTTON 组合使用。

注解

三个值仅与NSTCS_CHECKBOXES结合使用：NSTCS_PARTIALCHECKBOXES、NSTCS_EXCLUSIONCHECKBOXES 和 NSTCS_DIMMEDCHECKBOXES。 与这些状态关联的图标将插入到状态图像列表中，如下所示：

映像槽 映像 关联的标志
0 空白 NSTCS_CHECKBOXES
1 未选中 NSTCS_CHECKBOXES
2 已选中 NSTCS_CHECKBOXES
3 部分 NSTCS_CHECKBOXES |NSTCS_PARTIALCHECKBOXES
4 排除 (红色 X) NSTCS_CHECKBOXES |NSTCS_EXCLUSIONCHECKBOXES

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 shobjidl_core.h (包括 Shobjidl.h)

另请参阅

INameSpaceTreeControl2：：GetControlStyle

INameSpaceTreeControl2：：SetControlStyle

INameSpaceTreeControl：：Initialize