ListView_GetItemRect macro (commctrl.h)

  • Artigo

Obtém o retângulo delimitador para todos ou parte de um item no modo de exibição atual. Você pode usar essa macro ou enviar a mensagem LVM_GETITEMRECT explicitamente.

Sintaxe

BOOL ListView_GetItemRect(
  [in]  HWND hwnd,
  [in]  int  i,
  [out] RECT *prc,
  [in]  int  code
);

Parâmetros

[in] hwnd

Tipo: HWND

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

[in] i

Tipo: int

O índice do item de exibição de lista.

[out] prc

Tipo: * RECT

Um ponteiro para uma estrutura RECT que recebe o retângulo delimitador.

[in] code

Tipo: int

A parte do item de exibição de lista do 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 item, incluindo o ícone e o rótulo.
LVIR_ICON
 Retorna o retângulo delimitador do ícone ou ícone pequeno.
LVIR_LABEL
 Retorna o retângulo delimitador do texto do item.
LVIR_SELECTBOUNDS
 Retorna a união dos retângulos LVIR_ICON e LVIR_LABEL, mas exclui colunas no modo de exibição de relatório.

Valor de retorno

Tipo: BOOL

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

Requisitos

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