CListCtrl::GetGroupRect

Статья
06/10/2015

Возвращает ограничивающий прямоугольник для указанной группы в текущем элементе управления "список".

BOOL GetGroupRect(
     int iGroupId, 
     LPRECT lpRect, 
     int iCoords = LVGGR_GROUP
) const;

Параметры

Параметр	Описание
[входящий] iGroupId	Определяет группу.
[in, out] lpRect	Указатель на структуру RECT. Если метод успешно, то структура возвращает координаты прямоугольника группы, определенной iGroupId.
[входящий] iCoords	Определяет координаты прямоугольника, чтобы извлечь. Используйте одно из следующих значений: LVGGR_GROUP - (по умолчанию) развернутой координаты всей группы. Координаты LVGGR_HEADER - только заголовка (свернутой группы). LVGGR_SUBSETLINK - координаты только ссылки подмножества (подмножества разметки).

[входящий] iGroupId

Определяет группу.

[in, out] lpRect

Указатель на структуру RECT. Если метод успешно, то структура возвращает координаты прямоугольника группы, определенной iGroupId.

[входящий] iCoords

Определяет координаты прямоугольника, чтобы извлечь. Используйте одно из следующих значений:

LVGGR_GROUP - (по умолчанию) развернутой координаты всей группы.
Координаты LVGGR_HEADER - только заголовка (свернутой группы).
LVGGR_SUBSETLINK - координаты только ссылки подмножества (подмножества разметки).

Возвращаемое значение

true если этот метод выполнен успешно; в противном случае – значение false.

Заметки

Вызывающий объект отвечает за выбор структуры RECT указанная в параметре pRect.

Этот метод отправляет сообщение LVM_GETGROUPRECT, которое описано в Windows SDK.

Требования

заголовок: afxcmn.h

Этот элемент управления поддерживается в Windows Vista и более поздних версиях.

Дополнительные требования для этого метода см. в Требования к сборке для использования стандартных элементов управления в Windows Vista.

Пример

В следующем примере кода определяется переменной m_listCtrl, которая используется для доступа к текущий элемент управления "список". Эта переменная используется в следующем примере.

public:
    // Variable used to access the list control.
    CListCtrl m_listCtrl;

В следующем примере кода демонстрируется применение метода GetGroupRect. В предыдущем шаге этого примера кода, мы создали элементе управления списка, выводится 2 столбцов озаглавили "ClientID" и "ранг" в представлении отчета. В следующем примере кода демонстрируется рисование прямоугольника вокруг группы трехмерной индекс которой 0, если такая группа существует.

   // 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);
    }

См. также

Ссылки

Поделиться через