ListView_GetItemIndexRect macro (commctrl.h)

Obtém o retângulo delimitador para todos 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

BOOL ListView_GetItemIndexRect(
  [in]      HWND        hwnd,
  [in]      LVITEMINDEX *plvii,
  [in]      LONG        iSubItem,
  [in]      LONG        code,
  [in, out] LPRECT      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 de 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 ser um dos seguintes valores.

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. de prc não deve ser NULL.

Valor de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

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

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho commctrl.h