commctrl.h

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:

ValorSignificado
LVGF_NONENingún otro elemento es válido.
LVGF_HEADERLos miembros pszHeader y cchHeader son válidos.
LVGF_FOOTERLos miembros pszFooter y cchFooter son válidos.
LVGF_STATELos miembros state y stateMask son válidos.
LVGF_ALIGNEl miembro uAlign es válido.
LVGF_GROUPIDEl miembro iGroupId es válido.
LVGF_SUBTITLEVersión 6.00 y posteriores. El miembro pszSubtitle es válido.
LVGF_TASKVersión 6.00 y posteriores. El miembro pszTask es válido
LVGF_DESCRIPTIONTOPVersión 6.00 y posteriores. El miembro pszDescriptionTop es válido.
LVGF_DESCRIPTIONBOTTOMVersión 6.00 y posteriores. El miembro pszDescriptionBottom es válido.
LVGF_TITLEIMAGEVersión 6.00 y posteriores. El miembro iTitleImage es válido.
LVGF_EXTENDEDIMAGEVersión 6.00 y posteriores. El miembro iExtendedImage es válido.
LVGF_ITEMSVersión 6.00 y posteriores. El miembro cItems es válido.
LVGF_SUBSETVersión 6.00 y posteriores. El miembro pszSubsetTitle es válido.
LVGF_SUBSETITEMSVersió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:

ValorSignificado
LVGS_NORMALLos grupos están expandidos, el nombre del grupo y todos los ítems del grupo son mostrados.
LVGS_COLLAPSEDEl grupo está colapsado.
LVGS_HIDDENEl grupo está oculto.
LVGS_NOHEADERVersión 6.00 y posteriores. El grupo no muestra una cabecera.
LVGS_COLLAPSIBLEVersión 6.00 y posteriores. El grupo puede ser colapsado.
LVGS_FOCUSEDVersión 6.00 y posteriores. El grupo tiene el foco del teclado.
LVGS_SELECTEDVersión 6.00 y posteriores. El grupo está seleccionado.
LVGS_SUBSETEDVersión 6.00 y posteriores. El grupo solo muestra una parte de sus ítems.
LVGS_SUBSETLINKFOCUSEDVersió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.

ValorSignificado
LVGA_FOOTER_CENTEREl texto del pie es centrado horizontalmente en la ventana.
LVGA_FOOTER_LEFTEl texto del pie es alineado a la izquierda de la ventana.
LVGA_FOOTER_RIGHTEl texto del pie es alineado a la derecha de la ventana.
LVGA_HEADER_CENTEREl texto de la cabecera es centrado en la ventana.
LVGA_HEADER_LEFTEl texto de la cabecera es alineado a la izquierda de la ventana.
LVGA_HEADER_RIGHTEl 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.