LVFINDINFOW-Struktur (commctrl.h)

Artikel
08/22/2023

Enthält Informationen, die bei der Suche nach einem Listenansichtselement verwendet werden. Diese Struktur ist mit LV_FINDINFO identisch, wurde jedoch umbenannt, um den Standardnamenskonventionen zu entsprechen.

Syntax

typedef struct tagLVFINDINFOW {
  UINT    flags;
  LPCWSTR psz;
  LPARAM  lParam;
  POINT   pt;
  UINT    vkDirection;
} LVFINDINFOW, *LPFINDINFOW;

Member

flags

Typ: UINT

Typ der auszuführenden Suche. Dieser Member kann auf einen oder mehrere der folgenden Werte festgelegt werden:

Wert	Bedeutung
LVFI_PARAM	Sucht nach einer Übereinstimmung zwischen dem lParam-Element dieser Struktur und dem lParam-Element der LVITEM-Struktur eines Elements.
LVFI_PARTIAL	Überprüft, ob der Elementtext mit der Zeichenfolge beginnt, auf die das psz-Element verweist. Dieser Wert impliziert die Verwendung von LVFI_STRING.
LVFI_STRING	Sucht basierend auf dem Elementtext. Sofern keine zusätzlichen Werte angegeben werden, muss der Elementtext des übereinstimmenden Elements genau mit der Zeichenfolge übereinstimmen, auf die das psz-Element verweist. Bei der Suche wird jedoch die Groß-/Kleinschreibung nicht beachtet.
LVFI_SUBSTRING	Windows Vista und höher. Entspricht LVFI_PARTIAL.
LVFI_WRAP	Setzt die Suche am Anfang fort, wenn keine Übereinstimmung gefunden wird. Wenn dieses Flag selbst verwendet wird, wird davon ausgegangen, dass eine Zeichenfolgensuche gewünscht wird.
LVFI_NEARESTXY	Sucht das Element, das der im pt-Element angegebenen Position am nächsten liegt, in der vom vkDirection-Member angegebenen Richtung. Dieses Flag wird nur von den Modi "Große Symbole" und "kleine Symbole" unterstützt. Wenn LVFI_NEARESTXY angegeben ist, werden alle anderen Flags ignoriert.

psz

Typ: LPCTSTR

Adresse einer NULL-endenden Zeichenfolge, die mit dem Elementtext verglichen werden soll. Sie ist nur gültig, wenn LVFI_STRING oder LVFI_PARTIAL im Flags-Member festgelegt ist.

lParam

Typ: LPARAM

Wert, der mit dem lParam-Element der LVITEM-Struktur eines Listenansichtselements verglichen werden soll. Sie ist nur gültig, wenn LVFI_PARAM im Flags-Member festgelegt ist.

pt

Typ: POINT

POINT-Struktur mit der anfänglichen Suchposition. Sie ist nur gültig, wenn LVFI_NEARESTXY im Flags-Element festgelegt ist.

vkDirection

Typ: UINT

Virtueller Schlüsselcode, der die Richtung für die Suche angibt. Die folgenden Codes werden unterstützt:

VK_LEFT
VK_RIGHT
VK_UP
VK_DOWN
VK_HOME
VK_END
VK_PRIOR
VK_NEXT

Dieser Member ist nur gültig, wenn LVFI_NEARESTXY im Flags-Member festgelegt ist.

Hinweise

Hinweis

Der Commctrl.h-Header definiert LVFINDINFO als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


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

Share via