Compartilhar via


Estrutura LVHITTESTINFO (commctrl.h)

Contém informações sobre um teste de clique. Essa estrutura foi estendida para acomodar o subitem hit-testing. Ele é usado em associação com as mensagens LVM_HITTEST e LVM_SUBITEMHITTEST e suas macros relacionadas. Essa estrutura substitui a estrutura LVHITTESTINFO .

Sintaxe

typedef struct tagLVHITTESTINFO {
  POINT pt;
  UINT  flags;
  int   iItem;
  int   iSubItem;
  int   iGroup;
} LVHITTESTINFO, *LPLVHITTESTINFO;

Membros

pt

Tipo: POINT

A posição a ser atingida no teste, nas coordenadas do cliente.

flags

Tipo: UINT

A variável que recebe informações sobre os resultados de um teste de clique. Esse membro pode ser um ou mais dos seguintes valores:

Você pode usar LVHT_ABOVE, LVHT_BELOW, LVHT_TOLEFT e LVHT_TORIGHT para determinar se deseja rolar o conteúdo de um controle de exibição de lista. Dois desses valores podem ser combinados. Por exemplo, se a posição estiver acima e à esquerda da área do cliente, você poderá usar LVHT_ABOVE e LVHT_TOLEFT. 

Você pode testar LVHT_ONITEM para determinar se uma posição especificada está sobre um item de exibição de lista. Esse valor é uma operação OR bit a bit em LVHT_ONITEMICON, LVHT_ONITEMLABEL e LVHT_ONITEMSTATEICON.

Valor Significado
LVHT_ABOVE
A posição está acima da área de cliente do controle.
LVHT_BELOW
A posição está abaixo da área de cliente do controle.
LVHT_NOWHERE
A posição está dentro da janela do cliente do controle de exibição de lista, mas não está sobre um item de lista.
LVHT_ONITEMICON
A posição é sobre o ícone de um item de exibição de lista.
LVHT_ONITEMLABEL
A posição é sobre o texto de um item de exibição de lista.
LVHT_ONITEMSTATEICON
A posição é sobre a imagem de estado de um item de exibição de lista.
LVHT_TOLEFT
A posição é à esquerda da área de cliente do controle de exibição de lista.
LVHT_TORIGHT
A posição está à direita da área de cliente do controle de exibição de lista.
LVHT_EX_GROUP_HEADER
Windows Vista. O ponto está dentro do cabeçalho do grupo.
LVHT_EX_GROUP_FOOTER
Windows Vista. O ponto está dentro do rodapé do grupo.
LVHT_EX_GROUP_COLLAPSE
Windows Vista. O ponto está dentro do botão recolher/expandir do grupo.
LVHT_EX_GROUP_BACKGROUND
Windows Vista. O ponto está dentro da área do grupo em que os itens são exibidos.
LVHT_EX_GROUP_STATEICON
Windows Vista. O ponto está dentro do ícone de estado do grupo.
LVHT_EX_GROUP_SUBSETLINK
Windows Vista. O ponto está dentro do link de subconjunto do grupo.
LVHT_EX_GROUP
Windows Vista. LVHT_EX_GROUP_BACKGROUND | LVHT_EX_GROUP_COLLAPSE | LVHT_EX_GROUP_FOOTER | LVHT_EX_GROUP_HEADER | LVHT_EX_GROUP_STATEICON | LVHT_EX_GROUP_SUBSETLINK.
LVHT_EX_ONCONTENTS
Windows Vista. O ponto está dentro do ícone ou conteúdo de texto do item e não na tela de fundo.
LVHT_EX_FOOTER
Windows Vista. O ponto está dentro do rodapé do controle de exibição de lista.

iItem

Tipo: int

Recebe o índice do item correspondente. Ou, se um subitem for testado por clique, esse valor representará o item pai do subitem.

iSubItem

Tipo: int

Versão 4.70. Recebe o índice do subitem correspondente. Ao testar um item, esse membro será zero.

iGroup

Tipo: int

Windows Vista. Índice de grupo do item atingido (somente leitura). Válido somente para dados de proprietário. Se o ponto estiver dentro de um item exibido em vários grupos, o iGroup especificará o índice de grupo do item.

Requisitos

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