ListView_GetISearchString Makro (commctrl.h)

  • Artikel

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