CListCtrl::GetItemIndexRect

Recupera o retângulo delimitador para todos ou parte de um subitens atual no controle de exibição de lista.

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

Parâmetros

Parâmetro

Descrição

[in] pItemIndex

Ponteiro a estrutura de LVITEMINDEX para o item de subitens pai.

O chamador é responsável para atribuir e definir os membros de estrutura de LVITEMINDEX .Este parâmetro não pode ser NULL.

[in] iColumn

Índice com base zero de uma coluna no controle.

[in] rectType

Parte de subitens de exibição de lista para que o retângulo delimitador é recuperado.Especifique um dos seguintes valores:

LVIR_BOUNDS - retorna o retângulo delimitador inteiro de subitens, incluindo o ícone e o rótulo.

LVIR_ICON - retorna o retângulo delimitador do ícone ou pequeno de subitens de ícone.

LVIR_LABEL - retorna o retângulo delimitador de subitens de texto.

[out] pRect

Ponteiro a estrutura de RECT que recebe informações sobre o retângulo delimitador. de subitens

o chamador é responsável para atribuir a estrutura de RECT .Este parâmetro não pode ser NULL.

Valor de retorno

true se este método é com êxito; caso contrário, false.

Comentários

Este método envia a mensagem de LVM_GETITEMINDEXRECT , que é descrita em Windows SDK. Para obter mais informações, consulte macro de ListView_GetItemIndexRect

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 GetGroupRect .Antes de inserir 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 desenha um retângulo 3D em torno do segundo subitens ambas as colunas em.

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

Consulte também

Referência

Classe de CListCtrl

Gráfico de hierarquia

LVM_GETITEMINDEXRECT

LVITEMINDEX

RECT

macro de ListView_GetItemIndexRect