TreeView_GetISearchString Makro (commctrl.h)

Ruft die inkrementelle Suchzeichenfolge für ein Strukturansichtssteuerelement ab. Das Strukturansichtssteuerelement 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

void TreeView_GetISearchString(
   hwndTV,
   lpsz
);

Parameter

hwndTV

Typ: HWND

Handle mit dem Strukturansichtssteuerelement.

lpsz

Typ: LPTSTR

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

Rückgabewert

Keine

Bemerkungen

Sicherheitswarnung: Die falsche Verwendung dieses Makros kann die Sicherheit Ihres Programms beeinträchtigen. Sie müssen einen ausreichend großen Puffer zuweisen, um die Zeichenfolge zu halten. Rufen Sie zuerst das Makro auf, das NULL in lpsz übergibt. Dadurch wird die Anzahl der erforderlichen Zeichen (mit Ausnahme von NULL) zurückgegeben. Rufen Sie das Makro dann ein zweites Mal auf, um die Zeichenfolge abzurufen. Sie sollten Sicherheitsüberlegungen: Microsoft Windows-Steuerelemente lesen, bevor Sie fortfahren.

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

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