CListCtrl::GetGroupInfoByIndex
Получить данные об указанной группе в текущем элементе управления "список".
BOOL GetGroupInfoByIndex(
int iIndex,
PLVGROUP pGroup
) const;
Параметры
Параметр |
Описание |
|---|---|
[входящий] iIndex |
Индекс, начинающийся с нуля группы. |
[исходящий] pGroup |
Указатель на структуру LVGROUP, которая получает сведения о группе, определенные параметром iIndex. Вызывающий объект отвечает за инициализации членов структуры LVGROUP. Установите для элемента cbSize к размеру структуры и флаги элемента mask для указания сведений для извлечения. |
Возвращаемое значение
true если этот метод выполнен успешно; в противном случае – значение false.
Заметки
Этот метод отправляет сообщение LVM_GETGROUPINFOBYINDEX, которое описано в Windows SDK.
Требования
заголовок: afxcmn.h
Этот элемент управления поддерживается в Windows Vista и более поздних версиях.
Дополнительные требования для этого метода см. в Требования к сборке для использования стандартных элементов управления в Windows Vista.
Пример
В следующем примере кода определяется переменной m_listCtrl, которая используется для доступа к текущий элемент управления "список". Эта переменная используется в следующем примере.
public:
// Variable used to access the list control.
CListCtrl m_listCtrl;
В следующем примере кода демонстрируется применение метода GetGroupInfoByIndex. В предыдущем шаге этого примера кода было создано элементе управления списка, выводится 2 столбцов озаглавили "ClientID" и "ранг" в представлении отчета. В следующем примере кода извлекает сведения о группе, индекс которой 0, если такая группа существует.
// 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."));
}