TB_ADDSTRING message

Ajoute une nouvelle chaîne au pool de chaînes de la barre d’outils.

Paramètres

wParam

Gérez le module instance avec un fichier exécutable qui contient la ressource de chaîne. Si lParam pointe plutôt vers un tableau de caractères avec une ou plusieurs chaînes, définissez ce paramètre sur NULL.

lParam

Identificateur de ressource pour la ressource de chaîne ou pointeur vers un tableau TCHAR. Consultez la section Notes.

Valeur de retour

Retourne l’index de la première nouvelle chaîne en cas de réussite, ou -1 dans le cas contraire.

Notes

Si wParam a la valeur NULL, lParam pointe vers un tableau de caractères avec une ou plusieurs chaînes terminées par null. La dernière chaîne du tableau doit être terminée par deux caractères Null.

Si wParam est l’élément HINSTANCE de l’application ou d’un autre module contenant une ressource de chaîne, lParam est l’identificateur de ressource de la chaîne. Chaque élément de la chaîne doit commencer par un caractère de séparation arbitraire et la chaîne doit se terminer par deux caractères de ce type. Par exemple, le texte de trois boutons peut apparaître dans la table de chaînes sous la forme « /Nouveau/Ouvrir/Enregistrer// ». Le message retourne l’index « New » dans le pool de chaînes de la barre d’outils, et les autres éléments sont dans des positions consécutives.

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	TB_ADDSTRINGW (Unicode) et TB_ADDSTRINGA (ANSI)