Estructura LVGROUP

Definición

typedef struct tagLVGROUP {
  UINT   cbSize;
  UINT   mask;
  LPWSTR pszHeader;
  int    cchHeader;
  LPWSTR pszFooter;
  int    cchFooter;
  int    iGroupId;
  UINT   stateMask;
  UINT   state;
  UINT   uAlign;
  LPWSTR pszSubtitle;
  UINT   cchSubtitle;
  LPWSTR pszTask;
  UINT   cchTask;
  LPWSTR pszDescriptionTop;
  UINT   cchDescriptionTop;
  LPWSTR pszDescriptionBottom;
  UINT   cchDescriptionBottom;
  int    iTitleImage;
  int    iExtendedImage;
  int    iFirstItem;
  UINT   cItems;
  LPWSTR pszSubsetTitle;
  UINT   cchSubsetTitle;
} LVGROUP, *PLVGROUP;

Usado para asignar o recuperar grupos.

Descripción

cbSize

Tamaño de esta estructura en bytes.

mask

Máscara que especifica qué miembros de la estructura contienen entradas válidas. Uno o más de los siguientes valores:

Valor	Significado
LVGF_NONE	Ningún otro elemento es válido.
LVGF_HEADER	Los miembros pszHeader y cchHeader son válidos.
LVGF_FOOTER	Los miembros pszFooter y cchFooter son válidos.
LVGF_STATE	Los miembros state y stateMask son válidos.
LVGF_ALIGN	El miembro uAlign es válido.
LVGF_GROUPID	El miembro iGroupId es válido.
LVGF_SUBTITLE	Versión 6.00 y posteriores. El miembro pszSubtitle es válido.
LVGF_TASK	Versión 6.00 y posteriores. El miembro pszTask es válido
LVGF_DESCRIPTIONTOP	Versión 6.00 y posteriores. El miembro pszDescriptionTop es válido.
LVGF_DESCRIPTIONBOTTOM	Versión 6.00 y posteriores. El miembro pszDescriptionBottom es válido.
LVGF_TITLEIMAGE	Versión 6.00 y posteriores. El miembro iTitleImage es válido.
LVGF_EXTENDEDIMAGE	Versión 6.00 y posteriores. El miembro iExtendedImage es válido.
LVGF_ITEMS	Versión 6.00 y posteriores. El miembro cItems es válido.
LVGF_SUBSET	Versión 6.00 y posteriores. El miembro pszSubsetTitle es válido.
LVGF_SUBSETITEMS	Versión 6.00 y posteriores. El miembro cchSubsetTitle es válido.

pszHeader

Puntero a cadena terminada en cero que contiene el texto de cabecera cuando la información está siendo asignada. Si la información del grupo está siendo recuperada, este miembro especifica la dirección del buffer que recibe el texto de la cabecera.

cchHeader

Tamaño en TCHARs del buffer apuntado por el miembro pszHeader. Si la estructura no está recibiendo información sobre un grupo, este miembro es ignorado.

pszFooter

Puntero a cadena terminada en cero que contiene el texto del pie de página cuando la información del ítem está siendo asignada. Si la información del grupo está siendo recuperada, este miembro especifica la dirección del buffer que recibe el texto del pie.

cchFooter

Tamaño en TCHARs del buffer apuntado por el miembro pszFooter. Si la estructura no está recibiendo información sobre un grupo, este miembro es ignorado.

iGroupId

ID del grupo.

stateMask

Máscara usada con LVM_GETGROUPINFO y LVM_SETGROUPINFO para especificar qué banderas en el valor state están siendo recuperadas o asignadas.

state

Bandera que puede tomar uno de los siguientes valores:

Valor	Significado
LVGS_NORMAL	Los grupos están expandidos, el nombre del grupo y todos los ítems del grupo son mostrados.
LVGS_COLLAPSED	El grupo está colapsado.
LVGS_HIDDEN	El grupo está oculto.
LVGS_NOHEADER	Versión 6.00 y posteriores. El grupo no muestra una cabecera.
LVGS_COLLAPSIBLE	Versión 6.00 y posteriores. El grupo puede ser colapsado.
LVGS_FOCUSED	Versión 6.00 y posteriores. El grupo tiene el foco del teclado.
LVGS_SELECTED	Versión 6.00 y posteriores. El grupo está seleccionado.
LVGS_SUBSETED	Versión 6.00 y posteriores. El grupo solo muestra una parte de sus ítems.
LVGS_SUBSETLINKFOCUSED	Versión 6.00 y posteriores. El enlace de subconjunto del grupo tiene el foco del teclado.

uAlign

Indica el alineamiento del texto de la cabecera o de pie para el grupo. Puede ser uno o más de los siguientes valores. Usar una de las banderas de cabecera. Las banderas de pie son opcionales.

Valor	Significado
LVGA_FOOTER_CENTER	El texto del pie es centrado horizontalmente en la ventana.
LVGA_FOOTER_LEFT	El texto del pie es alineado a la izquierda de la ventana.
LVGA_FOOTER_RIGHT	El texto del pie es alineado a la derecha de la ventana.
LVGA_HEADER_CENTER	El texto de la cabecera es centrado en la ventana.
LVGA_HEADER_LEFT	El texto de la cabecera es alineado a la izquierda de la ventana.
LVGA_HEADER_RIGHT	El texto de la cabecera es alineado a la derecha de la ventana.

pszSubtitle

Puntero a una cadena terminada en cero que contiene el texto del subtítulo cuando la información está siendo asignada. Si la información del grupo está siendo recuperada, este miembro especifica la dirección del buffer que recibe el texto del subtítulo. Este elemento es mostrado bajo el texto de cabecera.

cchSubtitle

Tamaño en TCHARs del buffer apuntado por el miembro pszSubtitle. Si la estructura no está recibiendo información sobre un grupo, este miembro es ignorado.

pszTask

Puntero a una cadena terminada en cero que contiene el texto para un enlace de tarea cuando la información del grupo está siendo asignada. Si la información está siendo recuperada, este miembro especifica la dirección del buffer que recibe el texto de la tarea. Este ítem es mostrado alienado a la derecha frente al texto de la cabecera. Cuando es pulsado por el usuario, el enlace de tarea genera una notificación LVN_LINKCLICK.

cchTask

Tamaño en TCHARs del buffer apuntado por el miembro pszTask. Si la estructura no está recibiendo información sobre un grupo, este miembro es ignorado.

pszDescriptionTop

Puntero a una cadena terminada en cero que contiene el texto de la descripción superior cuando la información está siendo asignada. Si la información del grupo está siendo recuperad, este miembro especifica la dirección del buffer que recibirá el texto de descripción superior. Este ítem es mostrado frente a la imagen de título cuando haya una imagen de título, sin imagen extendida y uAlign==LVGA_HEADER_CENTER.

cchDescriptionTop

Tamaño en TCHARs del buffer apuntado por el miembro pszDescriptionTop . Si la estructura no está recibiendo información sobre un grupo, este miembro es ignorado.

pszDescriptionBottom

Puntero a una cadena terminada en cero que contiene el texto de la descripción inferior cuando la información está siendo asignada. Si la información del grupo está siendo recuperad, este miembro especifica la dirección del buffer que recibirá el texto de descripción inferior. Este ítem es mostrado debajo del texto de descripción superior cuando haya una imagen de título, sin imagen extendida y uAlign==LVGA_HEADER_CENTER.

cchDescriptionBottom

Tamaño en TCHARs del buffer apuntado por el miembro pszDescriptionBottom . Si la estructura no está recibiendo información sobre un grupo, este miembro es ignorado.

iTitleImage

Índice el la imagen de título en la lista de imágenes del control.

iExtendedImage

Índice de la imagen extendida en la lista de imágenes del control.

iFirstItem

Solo de lectura.

cItems

Solo de lectura en modo de datos sin propietario.

pszSubsetTitle

NULL si el grupo no es un subconjunto. Puntero a una cadena terminada en cero que contiene el texto del título del subconjunto cuando la información está siendo asignada. Si la información del grupo está siendo recuperada, este miembro especifica la dirección del buffer que recibe el texto de título del subconjunto.

cchSubsetTitle

Tamaño en TCHARs del buffer apuntado por el miembro pszSubsetTitle . Si la estructura no está recibiendo información sobre un grupo, este miembro es ignorado.

Observaciones

Todas las cadenas retornadas en esta estructura deben ser tratadas como de solo lectura.

La creación de subconjuntos no está soportada actualmente, ypszSubsetTitle no puede ser asignada por aplicaciones.