TreeView_GetISearchString Makro (commctrl.h)

Ruft die inkrementelle Suchzeichenfolge für ein Strukturansicht-Steuerelement ab. Das Strukturansicht-Steuerelement verwendet die inkrementelle Suchzeichenfolge, um ein Element basierend auf vom Benutzer eingegebenen Zeichen auszuwählen. Sie können dieses Makro verwenden oder die TVM_GETISEARCHSTRING Nachricht explizit senden.

Syntax

BOOL TreeView_GetISearchString(
   HWND   hwndTV,
   LPTSTR lpsz
);

Parameter

hwndTV

Typ: HWND-

Behandeln sie das Strukturansichtssteuerelement.

lpsz

Typ: LPTSTR-

Zeigen Sie auf den Puffer, der die inkrementelle Suchzeichenfolge empfängt.

Rückgabewert

Typ: BOOL-

Gibt TRUE- zurück, wenn die Zeichenfolge abgerufen wird; andernfalls FALSE.

Bemerkungen

Sicherheitswarnung: Falsche Verwendung dieses Makros beeinträchtigt möglicherweise die Sicherheit Ihres Programms. Sie müssen einen ausreichend großen Puffer zuweisen, um die Zeichenfolge aufzunehmen. Rufen Sie zuerst das Makro auf, das NULL- in lpszübergibt. Dadurch wird die Anzahl der Zeichen zurückgegeben, mit Ausnahme NULL-, die erforderlich sind. Rufen Sie dann das Makro ein zweites Mal auf, um die Zeichenfolge abzurufen. Sie sollten Sicherheitsüberlegungen überprüfen: Microsoft Windows Controls, bevor Sie fortfahren.

Wenn sich das Strukturansichtssteuerelement nicht im inkrementellen Suchmodus befindet, ist der Rückgabewert null.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h