TVM_GETISEARCHSTRING message

Récupère la chaîne de recherche incrémentielle pour un contrôle 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 envoyer ce message explicitement ou à l’aide de la macro TreeView_GetISearchString .

Paramètres

wParam

Doit être zéro.

lParam

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

Valeur retournée

Retourne le nombre de caractères dans la chaîne de recherche incrémentielle.

Notes

Avertissement de sécurité : L’utilisation incorrecte de ce message 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 le message en passant la valeur NULL dans lParam. Cette opération retourne le nombre de caractères requis, à l’exclusion de LA valeur NULL. Appelez ensuite le message 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.

Spécifications

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]
En-tête
Commctrl.h
Noms Unicode et ANSI
TVM_GETISEARCHSTRINGW (Unicode) et TVM_GETISEARCHSTRINGA (ANSI)