CListCtrl::GetItemIndexRect

Artículo
02/19/2013

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 la compilación para 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) );