CListCtrl::GetGroupInfoByIndex
Recupera informações sobre um grupo especificado no controle atual de exibição de lista.
BOOL GetGroupInfoByIndex(
int iIndex,
PLVGROUP pGroup
) const;
Parâmetros
Parâmetro |
Descrição |
|---|---|
[in] iIndex |
Índice com base zero de um grupo. |
[out] pGroup |
O ponteiro a estrutura de LVGROUP que recebeu informações sobre o grupo especificado pelo parâmetro de iIndex . O chamador é responsável para inicializar os membros de estrutura de LVGROUP .Defina o membro de cbSize o tamanho de uma estrutura, e os sinalizadores de membro de mask para especificar informações para recuperar. |
Valor de retorno
true se este método é com êxito; caso contrário, false.
Comentários
Este método envia a mensagem de LVM_GETGROUPINFOBYINDEX , que é descrita em Windows SDK.
Requisitos
Cabeçalho: afxcmn.h
Esse controle é suportado em Windows Vista e posteriormente.
Os requisitos adicionais para o método são descritos em Criar requisitos de controles comuns do Windows Vista.
Exemplo
O exemplo de código a seguir define uma variável, m_listCtrl, que é usada para acessar o controle atual de exibição de lista.Esta variável é usado no exemplo a seguir.
public:
// Variable used to access the list control.
CListCtrl m_listCtrl;
O exemplo de código demonstra o método de GetGroupInfoByIndex .Em uma seção anterior de este exemplo de código nós criaremos um controle de exibição de lista que exibe duas colunas intitulassem “ClientID” e “classificar” em um visualizador de relatório.O exemplo de código a seguir recupera informações sobre o grupo cujo índice é 0, se esse grupo existe.
// 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."));
}