LVHITTESTINFO-Struktur (commctrl.h)

Enthält Informationen zu einem Treffertest. Diese Struktur wurde erweitert, um Unterelementtreffertests zu ermöglichen. Es wird in Verbindung mit den LVM_HITTEST und LVM_SUBITEMHITTEST Nachrichten und den zugehörigen Makros verwendet. Diese Struktur ersetzt die LVHITTESTINFO-Struktur .

Syntax

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

Member

pt

Typ: POINT

Die Position, die in Clientkoordinaten zum Test ausgeführt werden soll.

flags

Typ: UINT

Die Variable, die Informationen zu den Ergebnissen eines Treffertests empfängt. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln:

Sie können LVHT_ABOVE, LVHT_BELOW, LVHT_TOLEFT und LVHT_TORIGHT verwenden, um zu bestimmen, ob der Inhalt eines Listenansichtssteuerelements scrollen soll. Zwei dieser Werte können kombiniert werden. Wenn sich die Position beispielsweise oberhalb und links vom Clientbereich befindet, können Sie sowohl LVHT_ABOVE als auch LVHT_TOLEFT verwenden. 

Sie können LVHT_ONITEM testen, um zu ermitteln, ob sich eine angegebene Position über einem Listenansichtselement befindet. Dieser Wert ist ein bitweiser OR-Vorgang für LVHT_ONITEMICON, LVHT_ONITEMLABEL und LVHT_ONITEMSTATEICON.

Wert	Bedeutung
LVHT_ABOVE	Die Position befindet sich über dem Clientbereich des Steuerelements.
LVHT_BELOW	Die Position befindet sich unterhalb des Clientbereichs des Steuerelements.
LVHT_NOWHERE	Die Position befindet sich im Clientfenster des Listenansicht-Steuerelements, aber nicht über einem Listenelement.
LVHT_ONITEMICON	Die Position befindet sich über dem Symbol eines Listenansichtselements.
LVHT_ONITEMLABEL	Die Position liegt über dem Text eines Listenansichtselements.
LVHT_ONITEMSTATEICON	Die Position liegt über dem Zustandsbild eines Listenansichtselements.
LVHT_TOLEFT	Die Position befindet sich links neben dem Clientbereich des Listenansicht-Steuerelements.
LVHT_TORIGHT	Die Position befindet sich rechts neben dem Clientbereich des Listenansicht-Steuerelements.
LVHT_EX_GROUP_HEADER	Windows Vista Der Punkt befindet sich innerhalb des Gruppenheaders.
LVHT_EX_GROUP_FOOTER	Windows Vista Der Punkt befindet sich in der Gruppenfußzeile.
LVHT_EX_GROUP_COLLAPSE	Windows Vista Der Punkt befindet sich innerhalb der Schaltfläche zum Reduzieren/Erweitern der Gruppe.
LVHT_EX_GROUP_BACKGROUND	Windows Vista Der Punkt befindet sich innerhalb des Bereichs der Gruppe, in der Elemente angezeigt werden.
LVHT_EX_GROUP_STATEICON	Windows Vista Der Punkt befindet sich innerhalb des Statussymbols der Gruppe.
LVHT_EX_GROUP_SUBSETLINK	Windows Vista Der Punkt befindet sich innerhalb des Teilmengenlinks der Gruppe.
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 Der Punkt befindet sich innerhalb des Symbol- oder Textinhalts des Elements und nicht im Hintergrund.
LVHT_EX_FOOTER	Windows Vista Der Punkt befindet sich in der Fußzeile des Listenansichtssteuerelements.

iItem

Typ: int

Empfängt den Index des übereinstimmenden Elements. Oder beim Treffertest eines Unterelements stellt dieser Wert das übergeordnete Element des Unterelements dar.

iSubItem

Typ: int

Version 4.70. Empfängt den Index des übereinstimmenden Unterelements. Beim Treffertest für ein Element ist dieses Element 0.

iGroup

Typ: int

Windows Vista. Gruppenindex des Elementtreffers (schreibgeschützt). Gilt nur für Besitzerdaten. Wenn sich der Punkt in einem Element befindet, das in mehreren Gruppen angezeigt wird, gibt iGroup den Gruppenindex des Elements an.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	commctrl.h