commctrl.h

Macro ListView_GetGroupRect

Obtiene el rectángulo para un grupo especificado. Se puede usar esta macro o enviar el mensaje LVM_GETGROUPRECT explícitamente.

Definición

BOOL ListView_GetGroupRect(
    HWND hwnd,
    int iGroupId,
    LONG type,
    RECT* prc
);

Descripción

hwnd
Un manipulador del control list-view.
iGroupId
Especifica el grupo mediante iGroupId (ver la estructura LVGROUP).
type

Especifica el tipo de rectángulo a recuperar. Este parámetro debe tener uno de los valores siguientes:

ValorSignificado
LVGGR_GROUP Coordenadas del grupo totalmente expandido.
LVGGR_HEADER Coordenadas de la cabecera sola (grupo colapsado).
LVGGR_LABEL Coordenadas de la etiqueta.
LVGGR_SUBSETLINK Coordenadas del enlace de subconjuntos (marcado de subconjunto). Un control list-view puede limitar el número de ítems visibles en cada grupo. Se muestra un enlace al usuario para permitirle expandir el grupo. Esta bandera hará que se retorne el rectángulo delimitador del enlace de subconjunto si el grupo es un subconjunto (el estado del grupo es LVGS_SUBSETED, ver el miembro state de la estructura LVGROUP). Esta bandera se proporciona para que aplicaciones de accesibilidad puedan localizar el enlace.
prc
Un puntero a una estructura RECT que recibirá la información del grupo especificado por iGroupId. El receptor del mensaje es el responsable de de asignar los miembros de la estructura con la información para el grupo especificado por iGroupId. La aplicación que lo invoca es la responsable de obtener la memoria para la estructura.

Valor de retorno

Devuelve TRUE si tiene éxito, o FALSE en caso contrario.