Struttura LVHITTESTINFO (commctrl.h)

Contiene informazioni su un hit test. Questa struttura è stata estesa per supportare il hit-testing dell'elemento secondario. Viene usato in associazione con i messaggi di LVM_HITTEST e LVM_SUBITEMHITTEST e le relative macro correlate. Questa struttura sostituisce la struttura LVHITTESTINFO .

Sintassi

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

Members

pt

Tipo: POINT

Posizione di hit test, nelle coordinate client.

flags

Tipo: UINT

Variabile che riceve informazioni sui risultati di un hit test. Questo membro può essere uno o più dei valori seguenti:

È possibile usare LVHT_ABOVE, LVHT_BELOW, LVHT_TOLEFT e LVHT_TORIGHT per determinare se scorrere il contenuto di un controllo di visualizzazione elenco. È possibile combinare due di questi valori. Ad esempio, se la posizione è superiore e a sinistra dell'area client, è possibile usare sia LVHT_ABOVE che LVHT_TOLEFT. 

È possibile testare la LVHT_ONITEM per determinare se una posizione specificata è su un elemento di visualizzazione elenco. Questo valore è un'operazione OR bit per bit su LVHT_ONITEMICON, LVHT_ONITEMLABEL e LVHT_ONITEMSTATEICON.

Valore Significato
LVHT_ABOVE
La posizione è sopra l'area client del controllo.
LVHT_BELOW
La posizione è sotto l'area client del controllo.
LVHT_NOWHERE
La posizione si trova all'interno della finestra client del controllo di visualizzazione elenco, ma non è su un elemento di elenco.
LVHT_ONITEMICON
La posizione si trova sull'icona dell'elemento di visualizzazione elenco.
LVHT_ONITEMLABEL
La posizione si trova sul testo di un elemento di visualizzazione elenco.
LVHT_ONITEMSTATEICON
La posizione è sopra l'immagine dello stato di un elemento di visualizzazione elenco.
LVHT_TOLEFT
La posizione si trova a sinistra dell'area client del controllo di visualizzazione elenco.
LVHT_TORIGHT
La posizione è a destra dell'area client del controllo di visualizzazione elenco.
LVHT_EX_GROUP_HEADER
Windows Vista. Il punto si trova all'interno dell'intestazione del gruppo.
LVHT_EX_GROUP_FOOTER
Windows Vista. Il punto si trova all'interno del piè di pagina del gruppo.
LVHT_EX_GROUP_COLLAPSE
Windows Vista. Il punto si trova all'interno del pulsante di compressione/espansione del gruppo.
LVHT_EX_GROUP_BACKGROUND
Windows Vista. Il punto si trova all'interno dell'area del gruppo in cui vengono visualizzati gli elementi.
LVHT_EX_GROUP_STATEICON
Windows Vista. Il punto si trova all'interno dell'icona dello stato del gruppo.
LVHT_EX_GROUP_SUBSETLINK
Windows Vista. Il punto si trova all'interno del collegamento subset del gruppo.
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. Il punto si trova all'interno dell'icona o del contenuto di testo dell'elemento e non sullo sfondo.
LVHT_EX_FOOTER
Windows Vista. Il punto si trova all'interno del piè di pagina del controllo visualizzazione elenco.

iItem

Tipo: int

Riceve l'indice dell'elemento corrispondente. In alternativa, se si esegue il test di un sottoitem, questo valore rappresenta l'elemento padre dell'elemento secondario.

iSubItem

Tipo: int

Versione 4.70. Riceve l'indice dell'elemento secondario corrispondente. Quando si esegue il test di un elemento, questo membro sarà zero.

iGroup

Tipo: int

Windows Vista. Indice di gruppo dell'elemento hit (sola lettura). Valido solo per i dati del proprietario. Se il punto si trova all'interno di un elemento visualizzato in più gruppi, iGroup specifica l'indice di gruppo dell'elemento.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione commctrl.h