通过

LVCOLUMNW 结构 （commctrl.h）

  • 项目

包含有关报表视图中的列的信息。 此结构用于创建和操作列。 此结构取代LV_COLUMN结构。

语法

typedef struct tagLVCOLUMNW {
  UINT   mask;
  int    fmt;
  int    cx;
  LPWSTR pszText;
  int    cchTextMax;
  int    iSubItem;
  int    iImage;
  int    iOrder;
  int    cxMin;
  int    cxDefault;
  int    cxIdeal;
} LVCOLUMNW, *LPLVCOLUMNW;

成员

mask

类型：UINT

指定哪些成员包含有效信息的变量。 此成员可以是零，也可以是以下一个或多个值：

价值 意义
LVCF_FMT
 fmt 成员有效。
LVCF_WIDTH
 cx 成员有效。
LVCF_TEXT
 pszText 成员有效。
LVCF_SUBITEM
 iSubItem 成员有效。
LVCF_IMAGE

版本 4.70。 iImage 成员有效。
LVCF_ORDER

版本 4.70。 iOrder 成员有效。
LVCF_MINWIDTH

版本 6.00 和 Windows Vista。cxMin 成员有效。
LVCF_DEFAULTWIDTH

版本 6.00 和 Windows Vista。cxDefault 成员有效。
LVCF_IDEALWIDTH

版本 6.00 和 Windows Vista。cxIdeal 成员 有效。

fmt

类型：int

列标题和列中子项文本的对齐方式。 最左侧列的对齐方式始终LVCFMT_LEFT;无法更改它。 此成员可以是以下值的组合。 请注意，并非所有组合都有效。

价值 意义
LVCFMT_LEFT
 文本左对齐。
LVCFMT_RIGHT
 文本右对齐。
LVCFMT_CENTER
 文本居中。
LVCFMT_JUSTIFYMASK
 用于选择 fmt 控制字段对齐的位掩码。 若要检查列的格式，请使用逻辑“and”将LCFMT_JUSTIFYMASK与 fmt组合在一起。 然后，可以使用 switch 语句来确定是设置LVCFMT_LEFT、LVCFMT_RIGHT还是LVCFMT_CENTER位。
LVCFMT_IMAGE

版本 4.70。 该项显示图像列表中的图像。
LVCFMT_BITMAP_ON_RIGHT

版本 4.70。 位图显示在文本右侧。 这不会影响分配给标头项的图像列表中的图像。
LVCFMT_COL_HAS_IMAGES

版本 4.70。 标头项包含图像列表中的图像。
LVCFMT_FIXED_WIDTH

版本 6.00 和 Windows Vista。 无法调整列的大小;与HDF_FIXEDWIDTH相同。
LVCFMT_NO_DPI_SCALE

版本 6.00 和 Windows Vista。 如果未设置，CCM_DPISCALE将控制纵向扩展固定宽度。
LVCFMT_FIXED_RATIO

版本 6.00 和 Windows Vista。 宽度将增加行高。
LVCFMT_SPLITBUTTON

版本 6.00 和 Windows Vista。 列是拆分按钮（与HDF_SPLITBUTTON相同）。 列的标题显示拆分按钮（与HDF_SPLITBUTTON相同）。

cx

类型：int

列的宽度（以像素为单位）。

pszText

类型：LPTSTR

如果设置了列信息，则此成员是包含列标题文本的以 null 结尾的字符串的地址。 如果结构正在接收有关列的信息，则此成员指定接收列标题文本的缓冲区的地址。

cchTextMax

类型：int

pszText 成员指向的缓冲区 TCHAR秒的大小。 如果结构未收到有关列的信息，则忽略此成员。

iSubItem

类型：int

与列关联的子项的索引。

iImage

类型：int

版本 4.70。 映像列表中图像的从零开始的索引。 指定的图像将显示在列中。

iOrder

类型：int

版本 4.70。 从零开始的列偏移量。 列偏移量按从左到右的顺序排列。 例如，零表示最左侧的列。

cxMin

类型：int

Windows Vista。 列的最小宽度（以像素为单位）。

cxDefault

类型：int

Windows Vista。 应用程序定义的值通常用于存储列的默认宽度。 列表视图控件忽略此成员。

cxIdeal

类型：int

Windows Vista。 只读。 列的理想宽度（以像素为单位），因为列当前可自动调整为较小的宽度。

言论

如果将列添加到索引为 0 的列表视图控件（最左侧的列），则始终LVCFMT_LEFT。 在列 0 上设置其他标志不会覆盖该对齐方式。 因此，如果继续插入索引为 0 的列，则所有列中的文本都是左对齐的。 如果希望第一列右对齐或居中，可以创建虚拟列，然后插入一个或多个索引为 1 或更高版本的列，并指定所需的对齐方式。 最后删除虚拟列。

注意

commctrl.h 标头将 LVCOLUMN 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
标头 commctrl.h

另请参阅

LVM_DELETECOLUMN

LVM_GETCOLUMN

LVM_INSERTCOLUMN

LVM_SETCOLUMN

参考