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â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. |
true se este método é com êxito; caso contrário, false.
Este método envia a mensagem de LVM_GETITEMINDEXRECT , que é descrita em Windows SDK. Para obter mais informações, consulte macro de ListView_GetItemIndexRect.
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.
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) );