CListCtrl::GetItemIndexRect

Artigo
08/25/2010

Recupera o retângulo delimitador completo ou parte de um subitem no controle de exibição de lista corrente.

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

Parâmetros

Parâmetro	Descrição
[in] pItemIndex	Ponteiro para um LVITEMINDEX estrutura para o item pai do subitem. O chamador é responsável por alocar e definir os membros do LVITEMINDEX estrutura.Este parâmetro não pode ser NULL.
[in] iColumn	Índice baseado em zero de uma coluna no controle.
[in] rectType	Parte do subitem de exibição de lista para que o retângulo delimitador é recuperado.Especifique um dos seguintes valores: LVIR_BOUNDS -Retorna o retângulo delimitador do subitem inteiro, incluindo o ícone e etiqueta. LVIR_ICON -Retorna o retângulo delimitador do ícone pequeno do subitem ou ícone. LVIR_LABEL -Retorna o retângulo delimitador de texto subitem.
[out] pRect	Ponteiro para um RECTestrutura de recebe informações sobre o retângulo delimitador do subitem. O chamador é responsável por alocar o RECT estrutura.Este parâmetro não pode ser NULL.

Valor de retorno

true Se esse método for bem-sucedida; caso contrário, false.

Comentários

Esse método envia o LVM_GETITEMINDEXRECT mensagem, que é descrita no Windows SDK. Para obter mais informações, consulte Macro ListView_GetItemIndexRect.

Requisitos

Cabeçalho: afxcmn.h

Este controle é suportado no Windows Vista e mais recente.

Requisitos adicionais para este método são descritos em compilação Requisitos para controles comuns do Windows Vista.

Exemplo

O exemplo de código a seguir define uma variável, m_listCtrl, que é usado para acessar o controle de exibição de lista corrente. Essa variável é usada no exemplo a seguir.

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

O exemplo de código a seguir demonstra o GetGroupRect método. Antes para inserir esse código de exemplo que criar um controle de exibição de lista que exibe duas colunas intituladas "ClientID" e "classificação" em um modo de exibição de relatório.O exemplo de código a seguir desenha um retângulo 3D ao redor o subitem segundo em ambas as colunas.

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