扩展List-View样式

使用 LVM_SETEXTENDEDLISTVIEWSTYLE 消息或 ListView_SetExtendedListViewStyleListView_SetExtendedListViewStyleEx 宏之一采用这些扩展列表视图控件样式。

返回的常量 说明
LVS_EX_AUTOAUTOARRANGE
Windows Vista 及更高版本。 如果未设置图标位置,则自动排列图标 (类似于LVS_AUTOARRANGE) 。
LVS_EX_AUTOCHECKSELECT
Windows Vista 及更高版本。 单击一下即可自动选择检查框。
LVS_EX_AUTOSIZECOLUMNS
Windows Vista 及更高版本。 自动调整 listview 列的大小。
LVS_EX_BORDERSELECT
版本 4.71 及更高版本。 选择项目时更改边框颜色,而不是突出显示该项。
LVS_EX_CHECKBOXES
版本 4.70。 为列表视图控件中的项启用检查框。 设置为此样式时,控件使用 DrawFrameControl 创建并设置包含两个图像的状态图像列表。 状态图像 1 是未选中的框,状态图像 2 是选中的框。 将状态映像设置为零会删除检查框。
版本 6.00 及更高版本 复选框对于除ComCtl32.dll版本 6 中引入的磁贴视图模式之外的所有列表视图模式都可见且正常运行。 在磁贴视图模式下单击复选框仅选择该项;状态不会更改。
可以使用ListView_GetCheckState获取给定项的检查框的状态。 若要设置检查状态,请使用 ListView_SetCheckState。 如果设置了此样式,则当用户单击检查框或按空格键时,列表视图控件会自动切换检查状态。
LVS_EX_COLUMNOVERFLOW
指示如果没有足够的客户端宽度来显示整个标头项集,则应在图标/磁贴视图中显示溢出按钮。 单击溢出按钮时,列表视图控件会发送LVN_COLUMNOVERFLOWCLICK通知。 仅当同时指定了LVS_EX_HEADERINALLVIEWS时,此标志才有效。
LVS_EX_COLUMNSNAPPOINTS
Windows Vista 及更高版本。 当用户调整列的大小时,对齐到最小列宽。
LVS_EX_DOUBLEBUFFER
版本 6.00 及更高版本。 通过双缓冲进行绘制,从而减少闪烁。 此扩展样式还支持在受支持的系统上选择 alpha 混合选框。
LVS_EX_FLATSB
在列表视图中启用平面滚动条。 如果需要更好地控制列表视图滚动条的外观,则应直接使用 平面滚动条 API 操作列表视图的滚动条。 如果系统指标发生更改,你负责使用 FlatSB_SetScrollProp调整滚动条指标。 有关更多详细信息 ,请参阅平面滚动条
LVS_EX_FULLROWSELECT
选中某个项后,将突出显示该项及其所有子项。 此样式只能与 LVS_REPORT 样式结合使用。
LVS_EX_GRIDLINES
显示项和子项周围的网格线。 此样式只能与 LVS_REPORT 样式结合使用。
LVS_EX_HEADERDRAGDROP
启用列表视图控件中列的拖放重新排序。 此样式仅适用于使用 LVS_REPORT 样式的列表视图控件。
LVS_EX_HEADERINALLVIEWS
Windows Vista 及更高版本。 在所有视图模式下显示列标题。
LVS_EX_HIDELABELS
版本 6.00 及更高版本。 隐藏图标和小图标视图中的标签。
LVS_EX_INFOTIP
当列表视图控件使用 LVS_EX_INFOTIP 样式时, LVN_GETINFOTIP 通知代码将发送到父窗口,然后显示项的工具提示。
LVS_EX_JUSTIFYCOLUMNS
Windows Vista 及更高版本。 图标在占用整个视图的列中排列。
LVS_EX_LABELTIP
如果任何列表视图模式下部分隐藏的标签缺少工具提示文本,列表视图控件将展开该标签。 如果未设置此样式,列表视图控件将仅针对大图标模式展开部分隐藏的标签。
LVS_EX_MULTIWORKAREAS
如果列表视图控件具有 LVS_AUTOARRANGE 样式,则在定义一个或多个工作区域之前,该控件不会自动排列其图标, (看到 LVM_SETWORKAREAS) 。 若要有效,必须在定义任何工作区域并将任何项添加到控件之前设置此样式。
LVS_EX_ONECLICKACTIVATE
当用户单击某个项时,列表视图控件会将 LVN_ITEMACTIVATE 通知代码发送到父窗口。 此样式还支持列表视图控件中的 热跟踪 。 热跟踪意味着当光标移动到某个项上时,它将被突出显示,但未选中。 有关项目激活的讨论,请参阅扩展List-View样式备注部分。
LVS_EX_REGIONAL
仅限版本 4.71 到版本 5.80。 Windows Vista 及更高版本不支持。 使用 SetWindowRgn 将列表视图窗口区域设置为仅包含项图标和文本。 任何不属于项的区域都从窗口区域中排除。 此样式仅适用于使用 LVS_ICON 样式的列表视图控件。
LVS_EX_SIMPLESELECT
版本 6.00 及更高版本。 在图标视图中,将控件的状态图像移动到大图标呈现的右上角。 在图标视图以外的视图中,没有变化。 当用户使用空格键更改状态时,所有选定的项都会循环切换,而不是具有焦点的项。
LVS_EX_SINGLEROW
版本 6.00 及更高版本。 未使用。
LVS_EX_SNAPTOGRID
版本 6.00 及更高版本。 在图标视图中,图标会自动对齐到网格中。
LVS_EX_SUBITEMIMAGES
允许显示子项的图像。 此样式只能与 LVS_REPORT 样式结合使用。
LVS_EX_TRACKSELECT
在列表视图控件中启用热轨选择。 热跟踪选择是指当光标停留在项目上一段时间时,将自动选择某个项。 可以使用LVM_SETHOVERTIME消息更改默认系统设置 延迟。 此样式适用于列表视图控件的所有样式。 可以通过调用 SystemParametersInfo 来检查是否启用热轨选择。
LVS_EX_TRANSPARENTBKGND
Windows Vista 及更高版本。 背景由父级通过 WM_PRINTCLIENT绘制。
LVS_EX_TRANSPARENTSHADOWTEXT
Windows Vista 及更高版本。 仅在透明背景上启用阴影文本。
LVS_EX_TWOCLICKACTIVATE
当用户双击项时,列表视图控件会将 LVN_ITEMACTIVATE 通知代码发送到父窗口。 此样式还支持列表视图控件中的 热跟踪 。 热跟踪意味着,当光标移动到某个项上时,它将被突出显示,但未选中。 有关项目激活的讨论,请参阅扩展List-View样式备注部分。
LVS_EX_UNDERLINECOLD
导致可能激活的非热项显示带下划线文本。 此样式要求同时设置 LVS_EX_TWOCLICKACTIVATE 。 有关项目激活的讨论,请参阅扩展List-View样式备注部分。
LVS_EX_UNDERLINEHOT
使可能激活的热项显示带下划线文本。 此样式要求同时设置 LVS_EX_ONECLICKACTIVATELVS_EX_TWOCLICKACTIVATE 。 有关项目激活的讨论,请参阅扩展List-View样式备注部分。

备注

注意

Comctl32.dll版本 6 不可再发行,但它包含在 Windows 中。 若要使用Comctl32.dll版本 6,请在清单中指定它。 有关清单的详细信息,请参阅 启用视觉样式

当鼠标悬停在某个项目上时,项目变为 项。 如果启用了热跟踪,将突出显示热项,但用户仍必须至少单击一次该项才能选择它。 激活 项会导致列表视图控件发送 LVN_ITEMACTIVATE 通知。 当某个项目处于一次单击即可选择它的状态时,可以将其选中。

如果设置了 LVS_EX_ONECLICKACTIVATE 样式,则只需单击一下即可选择任何项,因此可以选择所有项目。 如果设置了 LVS_EX_TWOCLICKACTIVATE 样式,则需要单击两次才能选择项目。 使用此样式时,只有在单击一次项后才能选择该项。

设置 LVS_EX_UNDERLINEHOT 样式将导致可能选择的任何热项的文本带有下划线。 设置 LVS_EX_UNDERLINECOLD 样式将导致不热但可能已选择的项目的文本带有下划线。

要求

要求
标头
CommCtrl.h

另请参阅

扩展List-View样式