ListView_GetISearchString Makro (commctrl.h)
Ruft die inkrementelle Suchzeichenfolge eines Listenansichtssteuerelements ab. Sie können dieses Makro verwenden oder die LVM_GETISEARCHSTRING Nachricht explizit senden.
Syntax
void ListView_GetISearchString(
hwndLV,
lpsz
);
Parameter
hwndLV
Typ: HWND
Ein Handle für das Listenansicht-Steuerelement.
lpsz
Typ: LPSTR
Ein Zeiger auf einen Puffer, der die inkrementelle Suchzeichenfolge empfängt. Um nur die Länge der Zeichenfolge abzurufen, legen Sie lpsz auf NULL fest.
Rückgabewert
Keine
Bemerkungen
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 zu enthalten. Wenn es zu klein ist, führt ein sofortiger ungültiger Seitenfehler.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | commctrl.h |