Freigeben über

LVFINDINFOW-Struktur (commctrl.h)

  • Artikel

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