CListCtrl::GetGroupInfoByIndex
Recupera informazioni su un gruppo specificato nel controllo elenco corrente.
BOOL GetGroupInfoByIndex(
int iIndex,
PLVGROUP pGroup
) const;
Parametri
Parametro |
Descrizione |
|---|---|
[in] iIndex |
Indice in base zero di un gruppo. |
[out] pGroup |
Il puntatore a una struttura LVGROUP che riceve le informazioni sul gruppo specificato dal parametro iIndex. Il chiamante è responsabile dell'inizializzazione dei membri della struttura LVGROUP.Impostare il membro cbSize alla dimensione della struttura e i flag del membro mask per specificare le informazioni da recuperare. |
Valore restituito
true se questo metodo ha esito positivo; in caso contrario, false.
Note
Questo metodo invia il messaggio LVM_GETGROUPINFOBYINDEX, come descritto in Windows SDK.
Requisiti
intestazione: afxcmn.h
Questo controllo è supportato in Windows Vista e versioni successive.
i requisiti aggiuntivi per questo metodo sono descritti in Requisiti di compilazione per i controlli comuni di Windows Vista.
Esempio
Nell'esempio di codice definisce una variabile, m_listCtrl, utilizzata per accedere al controllo elenco corrente.Questa variabile viene utilizzata nell'esempio seguente.
public:
// Variable used to access the list control.
CListCtrl m_listCtrl;
Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo del metodo GetGroupInfoByIndex.In una sezione precedente di questo esempio di codice seguente viene creato un controllo elenco che visualizza due colonne denominato "ClientID" e "conversione" in una visualizzazione report.Nell'esempio di codice recupera le informazioni sul gruppo di cui indice è 0, se tale gruppo esistente.
// 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."));
}