CListCtrl::GetGroupRect
recupera el rectángulo delimitador para un grupo especificado en el control actual de la vista de lista.
BOOL GetGroupRect(
int iGroupId,
LPRECT lpRect,
int iCoords = LVGGR_GROUP
) const;
Parámetros
Parámetro |
Descripción |
|---|---|
[in] iGroupId |
Especifica un grupo. |
[in, out] lpRect |
puntero a una estructura de RECT . Si este método finaliza correctamente, la estructura recibe las coordenadas del rectángulo de grupo especificado por iGroupId. |
[in] iCoords |
Especifica las coordenadas del rectángulo para recuperar. Utilice uno de estos valores:
|
Valor devuelto
true si este método es correcto; si no, false.
Comentarios
El llamador es responsable de asignar la estructura de RECT indicada por el parámetro de pRect .
este método envía el mensaje de LVM_GETGROUPRECT , que se describe en Windows SDK.
Requisitos
encabezado: afxcmn.h
Este control se admite en Windows Vista y posterior.
los requisitos adicionales para este método se describen en Requisitos de compilación para los controles comunes de Windows Vista.
Ejemplo
El ejemplo de código siguiente define una variable, m_listCtrl, que se utiliza para tener acceso al control actual de la vista de lista. esta variable se utiliza en el ejemplo siguiente.
public:
// Variable used to access the list control.
CListCtrl m_listCtrl;
En el ejemplo de código siguiente se muestra el método GetGroupRect. En una sección anterior de este ejemplo de código, creamos un control listview que muestra dos columnas titularon “ClientID” y “grado” en una vista de informe. El ejemplo de código siguiente se dibuja un rectángulo 3D alrededor del grupo cuyo índice es 0, si existe un grupo.
// 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);
}