LVM _ GETISEARCHSTRING-Nachricht
Ruft die inkrementelle Suchzeichenfolge eines Listenansicht-Steuerelements ab. Sie können diese Nachricht explizit oder mithilfe des ListView _ GetISearchString-Makros senden.
Parameter
-
wParam
- Muss Null sein.
-
lParam
-
Zeiger auf einen Puffer, der die inkrementelle Suchzeichenfolge empfängt. Um einfach 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 0 (null), wenn sich das Listenansicht-Steuerelement nicht im inkrementellen Suchmodus befindet.
Hinweise
Sicherheitswarnung: Wenn Sie diese Meldung falsch verwenden, kann dies die Sicherheit Ihres Programms gefährden. Diese Meldung bietet Ihnen keine Möglichkeit, die Größe des Puffers zu kennen. Wenn Sie diese Meldung verwenden, rufen Sie zuerst die Meldung auf, die NULL im lParam übergibt. Dadurch wird die Anzahl der zeichen zurückgegeben, mit Ausnahme von NULL, die erforderlich sind. Rufen Sie dann die Nachricht ein zweites Mal auf, um die Zeichenfolge abzurufen. Lesen Sie die Sicherheitsüberlegungen: Microsoft Windows Controls, bevor Sie fortfahren.
Die inkrementelle Suchzeichenfolge ist die Zeichenfolge, die der Benutzer eingibt, während die Listenansicht den Eingabefokus besitzt. 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 führt bei Bedarf einen Bildlauf in die Ansicht durch.
Jedem Vom Benutzer typisierungsbasierten Zeichen wird ein Time out-Zeitraum zugeordnet. Wenn das Time out verstreicht, 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 er zu klein ist, führt dies zu einem unmittelbar ungültigen Seitenfehler.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Header |
|
| Unicode- und ANSI-Name |
LVM _ GETISEARCHSTRINGW (Unicode) und LVM _ GETISEARCHSTRINGA (ANSI) |