CListCtrl::GetItemIndexRect

Статья
02/20/2013

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

BOOL GetItemIndexRect(
     PLVITEMINDEX pItemIndex, 
     int iColumn, 
     int rectType, 
     LPRECT pRect
) const;

Параметры

Параметр	Описание
[входящий] pItemIndex	Указатель на структуру LVITEMINDEX для родительского элемента данного подэлемента. Вызывающий объект отвечает за выделение и устанавливать члены структуры LVITEMINDEX.Этот параметр не может иметь значение NULL.
[входящий] iColumn	Индекс, начинающийся с нуля столбца в элементе управления.
[входящий] rectType	Часть вложенного элемента списка, для которого извлекается прямоугольник.Укажите одно из следующих значений. LVIR_BOUNDS - возвращать ограничивающий прямоугольник всех подэлементов, включая значок и метку. LVIR_ICON - return ограничивающий прямоугольник значка или мелкого значка подэлемента. LVIR_LABEL - возвращать ограничивающий прямоугольник текста данного подэлемента.
[исходящий] pRect	Указатель на структуру RECT, которая получает сведения о ограничивающем прямоугольнике подэлемента. Вызывающий объект отвечает за выбор структуры RECT.Этот параметр не может иметь значение NULL.

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

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

Заметки

Этот метод отправляет сообщение LVM_GETITEMINDEXRECT, которое описано в Windows SDK. Дополнительные сведения см. в разделе макрос ListView_GetItemIndexRect.

Требования

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

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

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

Пример

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

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

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

    // GetItemIndexRect
    // Get the rectangle that bounds the second item in the first group.
    LVITEMINDEX lvItemIndex;
    lvItemIndex.iGroup = 0;
    lvItemIndex.iItem = 1;
    CRect rect;
    BOOL bRet = m_listCtrl.GetItemIndexRect(
        &lvItemIndex, 0, LVIR_BOUNDS, &rect);

    // Draw a red rectangle around the item.
    m_listCtrl.GetDC()->Draw3dRect( &rect, RGB(255, 0, 0), RGB(255, 0, 0) );