CListCtrl::GetGroupRect
Récupère le rectangle englobant d'un groupe spécifié dans le contrôle liste view actuel.
BOOL GetGroupRect(
int iGroupId,
LPRECT lpRect,
int iCoords = LVGGR_GROUP
) const;
Paramètres
Paramètre |
Description |
|---|---|
[in] iGroupId |
Spécifie un groupe. |
[in, out] lpRect |
Pointeur vers une structure de RECT . Si cette méthode est réussie, la structure reçoit les coordonnées du rectangle du groupe spécifié par iGroupId. |
[in] iCoords |
Spécifie les coordonnées du rectangle à récupérer. Utilisez l'une de ces valeurs :
|
Valeur de retour
true si cette méthode est réussie ; sinon, false.
Notes
L'appelant est chargé d'allouer la structure de RECT pointée sur par le paramètre d' pRect .
Cette méthode envoie le message de LVM_GETGROUPRECT , qui est décrit dans Kit de développement logiciel Windows.
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. Dans la première section de l'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 groupe dont l'index est 0, si un tel groupe existe.
// GetGroupRect
// Get the graphics rectangle that surrounds group 0.
CRect rect;
BOOL bRet = m_listCtrl.GetGroupRect( 0, &rect, LVGGR_GROUP);
// Draw a blue rectangle around group 0.
if (bRet == TRUE) {
m_listCtrl.GetDC()->Draw3dRect( &rect, RGB(0, 0, 255), RGB(0, 0, 255));
}
else {
AfxMessageBox(_T("No group information was retrieved."), MB_ICONINFORMATION);
}