描述

 

用于设置和检索组.

 

FreeBASIC 语法

 

成员

cbSize

  Size of this structure, in bytes.

mask

Mask that specifies which members of the structure are valid input. One or more of the following values:

 

LVGF_NONE

No other items are valid.

LVGF_HEADER

pszHeader and cchHeader members are valid.

LVGF_FOOTER

Reserved.

LVGF_STATE

Reserved.

LVGF_ALIGN

uAlign member is valid.

LVGF_GROUPID

iGroupId member is valid.

LVGF_SUBTITLE

Version 6.00 and Windows Vista. The pszSubtitle member is valid.

LVGF_TASK

Version 6.00 and Windows Vista. The pszTask member is valid.

LVGF_DESCRIPTIONTOP

Version 6.00 and Windows Vista. The pszDescriptionTop member is valid.

LVGF_DESCRIPTIONBOTTOM

Version 6.00 and Windows Vista. The pszDescriptionBottom member is valid.

LVGF_TITLEIMAGE

Version 6.00 and Windows Vista. The iTitleImage member is valid.

LVGF_EXTENDEDIMAGE

Version 6.00 and Windows Vista. The iExtendedImage member is valid.

LVGF_ITEMS

Version 6.00 and Windows Vista. The cItems member is valid.

LVGF_SUBSET

Version 6.00 and Windows Vista. The pszSubsetTitle member is valid.

LVGF_SUBSETITEMS

Version 6.00 and Windows Vista. The cchSubsetTitle member is valid.

 

pszHeader

Pointer to a null-terminated string that contains the header text when item information is being set. If group information is being retrieved, this member specifies the address of the buffer that receives the header text.

 

cchHeader

Size in TCHARs of the buffer pointed to by the pszHeader member. If the structure is not receiving information about a group, this member is ignored.

pszFooter

Pointer to a null-terminated string that contains the footer text when item information is being set. If group information is being retrieved, this member specifies the address of the buffer that receives the footer text.

 

cchFooter

Size in TCHARs of the buffer pointed to by the pszFooter member. If the structure is not receiving information about a group, this member is ignored.

 

iGroupId

ID of the group.

 

stateMask

Mask used with LVM_GETGROUPINFO (Microsoft Windows XP and Windows Vista) and LVM_SETGROUPINFO (Windows Vista only) to specify which flags in the state value are being retrieved or set.

 

state

Flag that can have one of the following values:

 

LVGS_NORMAL

Groups are expanded, the group name is displayed, and all items in the group are displayed.

LVGS_COLLAPSED

The group is collapsed.

LVGS_HIDDEN

The group is hidden.

LVGS_NOHEADER

Version 6.00 and Windows Vista. The group does not display a header.

LVGS_COLLAPSIBLE

Version 6.00 and Windows Vista. The group can be collapsed.

LVGS_FOCUSED

Version 6.00 and Windows Vista. The group has keyboard focus.

LVGS_SELECTED

Version 6.00 and Windows Vista. The group is selected.

LVGS_SUBSETED

Version 6.00 and Windows Vista. The group displays only a portion of its items.

LVGS_SUBSETLINKFOCUSED

Version 6.00 and Windows Vista. The subset link of the group has keyboard focus.

 

uAlign

Indicates the alignment of the header or footer text for the group. It can have one or more of the following values. Use one of the header flags. Footer flags are optional.

 

Windows XP: Footer flags are reserved.

 

LVGA_FOOTER_CENTER

Reserved.

LVGA_FOOTER_LEFT

Reserved.

LVGA_FOOTER_RIGHT

Reserved.

LVGA_HEADER_CENTER

Version 6.00 and Windows Vista. Header text is centered horizontally in the window.

LVGA_HEADER_LEFT

Version 6.00 and Windows Vista. Header text is aligned at the left of the window.

LVGA_HEADER_RIGHT

Version 6.00 and Windows Vista. Header text is aligned at the right of the window.

 

pszSubtitle

Windows Vista. Pointer to a null-terminated string that contains the subtitle text when item information is being set. If group information is being retrieved, this member specifies the address of the buffer that receives the subtitle text. This element is drawn under the header text.

 

cchSubtitle

Windows Vista. Size, in TCHARs, of the buffer pointed to by the pszSubtitle member. If the structure is not receiving information about a group, this member is ignored.

 

pszTask

Windows Vista. Pointer to a null-terminated string that contains the text for a task link when item information is being set. If group information is being retrieved, this member specifies the address of the buffer that receives the task text. This item is drawn right-aligned opposite the header text. When clicked by the user, the task link generates an LVN_LINKCLICK notification.

 

cchTask

Windows Vista. Size in TCHARs of the buffer pointed to by the pszTask member. If the structure is not receiving information about a group, this member is ignored.

 

pszDescriptionTop

Windows Vista. Pointer to a null-terminated string that contains the top description text when item information is being set. If group information is being retrieved, this member specifies the address of the buffer that receives the top description text. This item is drawn opposite the title image when there is a title image, no extended image, and uAlign=LVGA_HEADER_CENTER.

 

cchDescriptionTop

Windows Vista. Size in TCHARs of the buffer pointed to by the pszDescriptionTop member. If the structure is not receiving information about a group, this member is ignored.

 

pszDescriptionBottom

Windows Vista. Pointer to a null-terminated string that contains the bottom description text when item information is being set. If group information is being retrieved, this member specifies the address of the buffer that receives the bottom description text. This item is drawn under the top description text when there is a title image, no extended image, and uAlign=LVGA_HEADER_CENTER.

 

cchDescriptionBottom

Windows Vista. Size in TCHARs of the buffer pointed to by the pszDescriptionBottom member. If the structure is not receiving information about a group, this member is ignored.

 

iTitleImage

Windows Vista. Index of the title image in the control imagelist.

 

iExtendedImage

Windows Vista. Index of the extended image in the control imagelist.

 

iFirstItem

Windows Vista. Read-only.

 

cItems

Windows Vista. Read-only in non-owner data mode.

 

pszSubsetTitle

Windows Vista. NULL if group is not a subset. Pointer to a null-terminated string that contains the subset title text when item information is being set. If group information is being retrieved, this member specifies the address of the buffer that receives the subset title text.

 

cchSubsetTitle

Windows Vista. Size in TCHARs of the buffer pointed to by the pszSubsetTitle member. If the structure is not receiving information about a group, this member is ignored.

备注

 

此结构中返回的所有字符串应视为只读.

目前不支持子集的创作,和pszSubsetTitle不能设置应用程序.

 

最低操作系统

 

Windows XP.

 

引用文件

 

CommCtrl.bi