Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 la compilación para 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."));
}