Freigeben über

LVFINDINFOA-Struktur (commctrl.h)

  • Artikel

Enthält Informationen, die beim Suchen nach einem Listenansichtselement verwendet werden. Diese Struktur ist identisch mit LV_FINDINFO, wurde aber in Standardbenennungskonventionen umbenannt.

Syntax

typedef struct tagLVFINDINFOA {
  UINT   flags;
  LPCSTR psz;
  LPARAM lParam;
  POINT  pt;
  UINT   vkDirection;
} LVFINDINFOA, *LPFINDINFOA;

Angehörige

flags

Typ: UINT-

Suchtyp, der ausgeführt werden soll. Dieses Element kann auf einen oder mehrere der folgenden Werte festgelegt werden:

Wert Bedeutung
LVFI_PARAM
 Sucht nach einer Übereinstimmung zwischen dem lParam Member dieser Struktur und dem lParam Element der LVITEM- Struktur eines Elements.
LVFI_PARTIAL
 Überprüft, ob der Elementtext mit der Zeichenfolge beginnt, auf die vom psz Member verwiesen wird. Dieser Wert impliziert die Verwendung von LVFI_STRING.
LVFI_STRING
 Sucht basierend auf dem Elementtext. Sofern keine zusätzlichen Werte angegeben sind, muss der Elementtext des übereinstimmenden Elements exakt mit der Zeichenfolge übereinstimmen, auf die vom psz Member verwiesen wird. 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 Kennzeichen selbst verwendet wird, wird davon ausgegangen, dass eine Zeichenfolgensuche gewünscht wird.
LVFI_NEARESTXY
 Sucht das Element, das der position am nächsten liegt, die im pt Member angegeben ist, in der vom vkDirection Member angegebenen Richtung. Diese Kennzeichnung wird nur von großen Symbol- und kleinen Symbolmodi unterstützt. Wenn LVFI_NEARESTXY angegeben ist, werden alle anderen Flags ignoriert.

psz

Typ: LPCTSTR-

Adresse einer mit Null beendeten Zeichenfolge, die mit dem Elementtext verglichen werden soll. Sie ist nur gültig, wenn LVFI_STRING oder LVFI_PARTIAL im Flags Mitglied festgelegt ist.

lParam

Typ: LPARAM-

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

pt

Typ: POINT-

POINT Struktur mit der ursprünglichen Suchposition. Sie ist nur gültig, wenn LVFI_NEARESTXY im Flags Mitglied festgelegt ist.

vkDirection

Typ: UINT-

Virtueller Schlüsselcode, der die Suchrichtung angibt. Die folgenden Codes werden unterstützt:

  • VK_LEFT
  • VK_RIGHT
  • VK_UP
  • VK_DOWN
  • VK_HOME
  • VK_END
  • VK_PRIOR
  • VK_NEXT
Dieses Element ist nur gültig, wenn LVFI_NEARESTXY im Flags Mitglied festgelegt ist.

Bemerkungen

Anmerkung

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

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Header- commctrl.h