CListCtrl::GetGroupInfoByIndex
Récupère des informations sur un groupe spécifié dans le contrôle liste view actuel.
BOOL GetGroupInfoByIndex(
int iIndex,
PLVGROUP pGroup
) const;
Paramètres
Paramètre |
Description |
|---|---|
[in] iIndex |
Index de base zéro d'un groupe. |
[out] pGroup |
Le pointeur vers une structure de LVGROUP qui reçoit des informations sur le groupe spécifié par le paramètre d' iIndex . L'appelant est chargé d'initialiser les membres de la structure de LVGROUP .Définissez cbSize membres à la taille de la structure, les balises et du membre d' mask pour spécifier les informations à récupérer. |
Valeur de retour
true si cette méthode est réussie ; sinon, false.
Notes
Cette méthode envoie le message de LVM_GETGROUPINFOBYINDEX , 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 de 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 GetGroupInfoByIndex.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 extrait des informations sur le groupe dont l'index est 0, si un tel groupe existe.
// GetGroupInfoByIndex
const int GROUP_HEADER_BUFFER_SIZE = 40;
// Initialize the structure
LVGROUP gInfo = {0};
gInfo.cbSize = sizeof(LVGROUP);
wchar_t wstrHeadGet[GROUP_HEADER_BUFFER_SIZE] = {0};
gInfo.cchHeader = GROUP_HEADER_BUFFER_SIZE;
gInfo.pszHeader = wstrHeadGet;
gInfo.mask = (LVGF_ALIGN | LVGF_STATE | LVGF_HEADER | LVGF_GROUPID);
gInfo.state = LVGS_NORMAL;
gInfo.uAlign = LVGA_HEADER_LEFT;
BOOL bRet = m_listCtrl.GetGroupInfoByIndex( 0, &gInfo );
if (bRet == TRUE) {
CString strHeader = CString( gInfo.pszHeader );
CString str;
str.Format(_T("Header: '%s'"), strHeader);
AfxMessageBox(str, MB_ICONINFORMATION);
}
else
{
AfxMessageBox(_T("No group information was retrieved."));
}