CListCtrl::GetItemIndexRect

Article
06/10/2015

Récupère le rectangle englobant de l'ensemble ou une partie d'un sous-élément dans le contrôle liste view actuel.

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

Paramètres

Paramètre	Description
[in] pItemIndex	Pointeur vers une structure de LVITEMINDEX pour l'élément parent du sous-élément. L'appelant est chargé d'allouer et de définir les membres de la structure de LVITEMINDEX . Ce paramètre ne peut pas être NULL.
[in] iColumn	Index de base zéro d'une colonne dans le contrôle.
[in] rectType	Partie du sous-élément de vue Liste pour lequel le rectangle englobant est extrait. Spécifiez l'une des valeurs suivantes : LVIR_BOUNDS - retourne le rectangle englobant du sous-élément entier, y compris l'icône et l'étiquette. LVIR_ICON - retourne le rectangle englobant de l'icône ou de la petite icône du sous-élément. LVIR_LABEL - retourne le rectangle englobant du texte de sous-élément.
[out] pRect	Pointeur vers une structure de RECT qui reçoit des informations sur le rectangle englobant du sous-élément. L'appelant est chargé d'allouer la structure de RECT . Ce paramètre ne peut pas être NULL.

Valeur de retour

true si cette méthode est réussie ; sinon, false.

Notes

Cette méthode envoie le message de LVM_GETITEMINDEXRECT , qui est décrit dans Kit de développement logiciel Windows. Pour plus d'informations, consultez Macro de ListView_GetItemIndexRect.

Configuration requise

en-tête : afxcmn.h

Ce contrôle est pris en charge dans Windows Vista et versions ultérieures.

Les spécifications supplémentaires pour cette méthode sont décrites dans Spécifications pour la génération des contrôles communs Windows Vista.

Exemple

L'exemple de code suivant définit une variable, m_listCtrl, qui est utilisée pour accéder au contrôle liste view actuel. Cette variable est utilisée dans l'exemple suivant.

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

L'exemple de code suivant illustre la méthode GetGroupRect. Avant d'écrire cet exemple de code nous avons créé un contrôle liste view que le affiche deux colonnes ont intitulé « ClientID » et « view » dans un mode Rapport. L'exemple de code suivant dessine un rectangle 3D autour de le deuxième sous-élément dans les deux colonnes.

    // 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) );