Share via


LVGROUP (Compact 2013)

3/28/2014

This structure is used to set and retrieve groups.

Syntax

typedef struct LVGROUP {
  UINT cbSize;
  UINT mask;
  LPWSTR pszHeader;
  int cchHeader;
  LPWSTR pszFooter;
  int cchFooter;
  int iGroupId;
  UINT stateMask;
  UINT state;
  UINT uAlign;
} LVGROUP, *PLVGROUP;

Members

  • cbSize
    Size of an LVGROUP structure.
  • mask
    Specifies which members of the structure are valid input. It can have one or more of the following values.

    Value

    Description

    LVGF_ALIGN

    uAlign member is valid.

    LVGF_FOOTER

    pszFooter and cchFooter members are valid.

    LVGF_GROUPID

    iGroupId member is valid.

    LVGF_HEADER

    pszHeader and cchHeader members are valid.

    LVGF_NONE

    No other items are valid.

    LVGF_STATE

    state and stateMask members are valid.

  • pszHeader
    Pointer to a string that contains the header.
  • cchHeader
    Number of characters in the string that specifies the header. This number should include the NULL terminator.
  • pszFooter
    Pointer to a string that contains the footer.
  • cchFooter
    Number of characters in the string that specifies the footer. This number should include the NULL terminator.
  • iGroupId
    Identifier (ID) of the group.
  • stateMask
    Reserved; must be zero.
  • state
    Currently, it can only be the following.

    Value

    Description

    LVGS_NORMAL

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

  • 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.

    Value

    Description

    LVGA_FOOTER_CENTER

    Footer text is centered horizontally in the window.

    LVGA_FOOTER_LEFT

    Footer text is aligned at the left of the window.

    LVGA_FOOTER_RIGHT

    Footer text is aligned at the right of the window.

    LVGA_HEADER_CENTER

    Header text is centered horizontally in the window.

    LVGA_HEADER_LEFT

    Header text is aligned at the left of the window.

    LVGA_HEADER_RIGHT

    Header text is aligned at the right of the window.

Requirements

Header

commctrl.h

See Also

Reference

List-View Controls Structures