macro ListView_GetSubItemRect (commctrl.h)

  • Artículo

Obtiene información sobre el rectángulo que rodea un subelemento en un control de vista de lista. Puede usar esta macro (recomendada) o enviar el mensaje LVM_GETSUBITEMRECT explícitamente. Esta macro está pensada para usarse solo en controles de vista de lista que usan el estilo LVS_REPORT.

Sintaxis

BOOL ListView_GetSubItemRect(
   HWND   hwnd,
   int    iItem,
   int    iSubItem,
   int    code,
   LPRECT prc
);

Parámetros

hwnd

Tipo: HWND

Identificador de un control de vista de lista.

iItem

Tipo: int

Índice del elemento primario del subelemento.

iSubItem

Tipo: int

Índice basado en uno del subelemento.

code

Tipo: int

Parte del subelemento de vista de lista para el que se va a recuperar la información del rectángulo delimitador. Este valor puede ser uno de los siguientes:

Valor Significado
LVIR_BOUNDS
 Devuelve el rectángulo delimitador de todo el elemento, incluido el icono y la etiqueta.
LVIR_ICON
 Devuelve el rectángulo delimitador del icono o el icono pequeño.
LVIR_LABEL
 Devuelve el rectángulo delimitador de todo el elemento, incluido el icono y la etiqueta. Esto es idéntico a LVIR_BOUNDS.

prc

Tipo: LPRECT

Puntero a una estructura RECT de que recibe la información del rectángulo delimitador del subelemento.

Valor devuelto

Tipo: BOOL de

Devuelve un valor distinto de cero si se ejecuta correctamente o cero de lo contrario.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de commctrl.h