ListView_GetSubItemRect macro (commctrl.h)

  • Artigo

Obtém informações sobre o retângulo que envolve um subitem em um controle de exibição de lista. Você pode usar essa macro (recomendado) ou enviar a mensagem LVM_GETSUBITEMRECT explicitamente. Essa macro destina-se a ser usada somente em controles de exibição de lista que usam o estilo LVS_REPORT.

Sintaxe

BOOL ListView_GetSubItemRect(
   HWND   hwnd,
   int    iItem,
   int    iSubItem,
   int    code,
   LPRECT prc
);

Parâmetros

hwnd

Tipo: HWND

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

iItem

Tipo: int

O índice do item pai do subitem.

iSubItem

Tipo: int

O índice baseado em um do subitem.

code

Tipo: int

Uma parte do subitem de exibição de lista para o qual recuperar as informações de retângulo delimitador. Esse valor pode ser um dos seguintes:

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 de todo o item, incluindo o ícone e o rótulo. Isso é idêntico ao LVIR_BOUNDS.

prc

Tipo: LPRECT

Ponteiro para uma estrutura RECT que recebe as informações de retângulo delimitador de subitem.

Valor de retorno

Tipo: BOOL

Retornará diferente de zero se tiver êxito ou zero de outra forma.

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