CListCtrl::GetGroupInfoByIndex
Información de recupera sobre un grupo especificado en el control actual de la vista de lista.
BOOL GetGroupInfoByIndex(
int iIndex,
PLVGROUP pGroup
) const;
Parámetros
Parámetro |
Descripción |
|---|---|
[in] iIndex |
índice de base cero de un grupo. |
[out] pGroup |
El puntero a una estructura de LVGROUP que recibe información sobre el grupo especificado por el parámetro de iIndex . El llamador es responsable de inicializar los miembros de la estructura de LVGROUP . Establezca el miembro de cbSize al tamaño de la estructura, y marcadores de miembro de mask para especificar la información para recuperar. |
Valor devuelto
true si este método es correcto; si no, false.
Comentarios
este método envía el mensaje de LVM_GETGROUPINFOBYINDEX , 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 GetGroupInfoByIndex. En una sección anterior de este ejemplo de código crea un control listview que muestra dos columnas titularon “ClientID” y “grado” en una vista de informe. El ejemplo de código siguiente se recupera información sobre el grupo cuyo índice es 0, si existe un grupo.
// 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."));
}