CListCtrl::GetGroupRect
Recupera il rettangolo di delimitazione di un gruppo specificato nel controllo elenco corrente.
BOOL GetGroupRect(
int iGroupId,
LPRECT lpRect,
int iCoords = LVGGR_GROUP
) const;
Parametri
Parametro |
Descrizione |
|---|---|
[in] iGroupId |
Specifica un gruppo. |
[in, out] lpRect |
Puntatore a una struttura RECT.Se il metodo ha esito positivo, la struttura riceve le coordinate del rettangolo del gruppo specificato da iGroupId. |
[in] iCoords |
Specifica le coordinate del rettangolo per recuperare.Utilizzare uno dei valori seguenti:
|
Valore restituito
true se questo metodo ha esito positivo; in caso contrario, false.
Note
Il chiamante è responsabile di allocare la struttura RECT indicata dal parametro pRect.
Questo metodo invia il messaggio LVM_GETGROUPRECT, 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 GetGroupRect.In una sezione precedente di questo esempio di codice, creato un controllo elenco che visualizza due colonne denominato "ClientID" e "conversione" in una visualizzazione report.Nell'esempio di codice seguente consente di tracciare un rettangolo 3D nel gruppo di cui indice è 0, se tale gruppo esistente.
// 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);
}