LVHITTESTINFO-Struktur (commctrl.h)

  • Artikel

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