CListCtrl::GetItemIndexRect

Artículo
06/10/2015

Recupera el rectángulo delimitador del todo o parte de un subelemento en el control actual de la vista de lista.

BOOL GetItemIndexRect(
     PLVITEMINDEX pItemIndex, 
     int iColumn, 
     int rectType, 
     LPRECT pRect
) const;

Parámetros

Parámetro	Descripción
[in] pItemIndex	Puntero a una estructura de LVITEMINDEX para el elemento primario del subelemento. El llamador es responsable de asignar y establecer miembros de la estructura de LVITEMINDEX . Este parámetro no puede ser NULL.
[in] iColumn	índice de base cero de una columna del control.
[in] rectType	Parte del subelemento de la vista de lista para el que se recupera el rectángulo delimitador. Especifique uno de los siguientes valores: LVIR_BOUNDS - devuelve el rectángulo delimitador del subelemento completo, incluido el icono y la etiqueta. LVIR_ICON - devuelve el rectángulo delimitador del icono o el icono pequeño del subelemento. LVIR_LABEL - devuelve el rectángulo delimitador del texto del subelemento.
[out] pRect	Puntero a una estructura de RECT que recibe información sobre el rectángulo delimitador del subelemento. El llamador es responsable de asignar la estructura de RECT . Este parámetro no puede ser NULL.

Valor devuelto

true si este método es correcto; si no, false.

Comentarios

Este método envía el mensaje de LVM_GETITEMINDEXRECT , que se describe en Windows SDK. Para obtener más información, vea macro de ListView_GetItemIndexRect.

Requisitos

encabezado: afxcmn.h

Este control se admite en Windows Vista y posterior.

los requisitos adicionales para este método se describen en Requisitos de compilación para los controles comunes de Windows Vista.

Ejemplo

El ejemplo de código siguiente define una variable, m_listCtrl, que se utiliza para tener acceso al control actual de la vista de lista. esta variable se utiliza en el ejemplo siguiente.

public:
    // Variable used to access the list control.
    CListCtrl m_listCtrl;

En el ejemplo de código siguiente se muestra el método GetGroupRect. Antes de especificar este ejemplo de código crea un control listview que muestra dos columnas titularon “ClientID” y “grado” en una vista de informe. El ejemplo de código siguiente se dibuja un rectángulo 3D alrededor del segundo subelemento en ambas columnas.

  // GetItemIndexRect 
    // Get the rectangle that bounds the second item in the first group.
    LVITEMINDEX lvItemIndex;
    lvItemIndex.iGroup = 0;
    lvItemIndex.iItem = 1;
    CRect rect;
    BOOL bRet = m_listCtrl.GetItemIndexRect(
        &lvItemIndex, 0, LVIR_BOUNDS, &rect);

    // Draw a red rectangle around the item.
    m_listCtrl.GetDC()->Draw3dRect( &rect, RGB(255, 0, 0), RGB(255, 0, 0) );