macro ListView_GetItemIndexRect (commctrl.h)

  • Artigo

Obtém o retângulo delimitador para todo ou parte de um subitem na exibição atual de um controle de exibição de lista especificado. Use essa macro ou envie a mensagem LVM_GETITEMINDEXRECT explicitamente.

Sintaxe

void ListView_GetItemIndexRect(
  [in]       hwnd,
  [in]       plvii,
  [in]       iSubItem,
  [in]       code,
  [in, out]  prc
);

Parâmetros

[in] hwnd

Tipo: HWND

Um identificador para o controle de exibição de lista.

[in] plvii

Tipo: LVITEMINDEX*

Um ponteiro para uma estrutura LVITEMINDEX para o item pai do subitem. O chamador é responsável por alocar essa estrutura e definir seus membros. plvii não deve ser NULL.

[in] iSubItem

Tipo: LONG

O índice do subitem.

[in] code

Tipo: LONG

A parte do subitem de exibição de lista para a qual recuperar o retângulo delimitador. Esse parâmetro deve usar um dos valores a seguir.

Valor Significado
LVIR_BOUNDS
 Retorna o retângulo delimitador de todo o subitem, incluindo o ícone e o rótulo.
LVIR_ICON
 Retorna o retângulo delimitador do ícone ou ícone pequeno do subitem.
LVIR_LABEL
 Retorna o retângulo delimitador do texto do subitem.

[in, out] prc

Tipo: LPRECT

Um ponteiro para uma estrutura RECT para receber as coordenadas. O chamador é responsável por alocar essa estrutura. prc não deve ser NULL.

Valor retornado

Nenhum

Comentários

Se iSubItem for zero, essa macro retornará as coordenadas do retângulo para o item apontado por plvii. Não há suporte para o valor LVIR_SELECTBOUNDS para o código de parâmetro.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho commctrl.h