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