macro TreeView_GetISearchString (commctrl.h)

Récupère la chaîne de recherche incrémentielle pour un contrôle d’arborescence. Le contrôle d’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 explicitement le message TVM_GETISEARCHSTRING.

Syntaxe

BOOL TreeView_GetISearchString(
   HWND   hwndTV,
   LPTSTR 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

Type : BOOL

Retourne TRUE si la chaîne est récupérée ; FALSE sinon.

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. Cela 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 passer en revue considérations relatives à la sécurité : contrôles Microsoft Windows avant de continuer.

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	commctrl.h