ListView_GetISearchString Makro (commctrl.h)

Ruft die inkrementelle Suchzeichenfolge eines Listenansicht-Steuerelements ab. Sie können dieses Makro verwenden oder die LVM_GETISEARCHSTRING Nachricht explizit senden.

Syntax

BOOL ListView_GetISearchString(
   HWND  hwndLV,
   LPSTR 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

Typ: BOOL-

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

Bemerkungen

Die inkrementelle Suchzeichenfolge ist die Zeichensequenz, 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 führt bei Bedarf einen Bildlauf in die Ansicht durch.

Ein Timeoutzeitraum ist jedem Zeichen zugeordnet, das der Benutzer eingibt. 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 halten. Wenn sie zu klein ist, führt ein sofortiger ungültiger Seitenfehler zu einem Fehler.

Anforderungen