Freigeben über


LVM_GETISEARCHSTRING Nachricht

Ruft die inkrementelle Suchzeichenfolge eines Listenansichtssteuerelements ab. Sie können diese Nachricht explizit oder mithilfe des makros ListView_GetISearchString senden.

Parameter

wParam

Muss Null sein.

lParam

Zeiger auf einen Puffer, der die inkrementelle Suchzeichenfolge empfängt. Um nur die Länge der Zeichenfolge abzurufen, legen Sie lParam auf NULL fest.

Rückgabewert

Gibt die Anzahl der Zeichen in der inkrementellen Suchzeichenfolge zurück, ohne das beendende NULL-Zeichen, oder null, wenn sich das Listenansicht-Steuerelement nicht im inkrementellen Suchmodus befindet.

Bemerkungen

Sicherheitswarnung: Wenn Sie diese Nachricht falsch verwenden, kann die Sicherheit Ihres Programms beeinträchtigt werden. Diese Meldung bietet keine Möglichkeit, die Größe des Puffers zu ermitteln. Wenn Sie diese Nachricht verwenden, rufen Sie zuerst die Nachricht auf, die NULL in lParam übergibt. Dies gibt die Anzahl der Zeichen zurück, mit Ausnahme von NULL , die erforderlich sind. Rufen Sie dann die Nachricht ein zweites Mal auf, um die Zeichenfolge abzurufen. Überprüfen Sie die Sicherheitsüberlegungen: Microsoft Windows-Steuerelemente , bevor Sie fortfahren.

Die inkrementelle Suchzeichenfolge ist die Zeichenfolge, die der Benutzer eingibt, während die Listenansicht den Eingabefokus hat. Jedes Mal, wenn der Benutzer ein Zeichen eingibt, fügt das System das Zeichen an die Suchzeichenfolge an und sucht dann nach einem übereinstimmenden Element. Wenn das System eine Übereinstimmung findet, wählt es das Element aus und scrollt es bei Bedarf in die Ansicht.

Jedem Zeichen, das der Benutzer eingibt, ist ein Timeoutzeitraum zugeordnet. Wenn der Timeoutzeitraum verstrichen ist, bevor der Benutzer ein anderes Zeichen eingibt, wird die inkrementelle Suchzeichenfolge zurückgesetzt.

Stellen Sie sicher, dass der Puffer groß genug ist, um die Zeichenfolge und das beendende NULL-Zeichen zu enthalten. Wenn sie zu klein ist, wird ein sofortiger Fehler durch ungültige Seiten verursacht.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2003 [nur Desktop-Apps]
Header
Commctrl.h
Unicode- und ANSI-Name
LVM_GETISEARCHSTRINGW (Unicode) und LVM_GETISEARCHSTRINGA (ANSI)