TreeView_GetISearchString macro (commctrl.h)

Récupère la chaîne de recherche incrémentielle pour un contrôle d’arborescence. Le contrôle arborescence utilise la chaîne de recherche incrémentielle pour sélectionner un élément en fonction des caractères tapés par l’utilisateur. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETISEARCHSTRING explicitement.

Syntaxe

void TreeView_GetISearchString(
   hwndTV,
   lpsz
);

Paramètres

hwndTV

Type : HWND

Gérez le contrôle d’arborescence.

lpsz

Type : LPTSTR

Pointeur vers la mémoire tampon qui reçoit la chaîne de recherche incrémentielle.

Valeur de retour

None

Remarques

Avertissement de sécurité : L’utilisation incorrecte de cette macro peut compromettre la sécurité de votre programme. Vous devez allouer une mémoire tampon suffisamment grande pour contenir la chaîne. Appelez d’abord la macro en passant NULL dans lpsz. Cette opération retourne le nombre de caractères, à l’exclusion de NULL, qui sont requis. Appelez ensuite la macro une deuxième fois pour récupérer la chaîne. Vous devez consulter Considérations relatives à la sécurité : Contrôles Microsoft Windows avant de continuer.

Si le contrôle arborescence n’est pas en mode de recherche incrémentielle, la valeur de retour est zéro.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	commctrl.h