Message g LB _

Ajoute une chaîne à une zone de liste. Si la zone de liste n’a pas le style de _ Tri lbs , la chaîne est ajoutée à la fin de la liste. Dans le cas contraire, la chaîne est insérée dans la liste et la liste est triée.

Paramètres

wParam

Ce paramètre n'est pas utilisé.

lParam

Pointeur vers la chaîne terminée par le caractère null qui doit être ajoutée.

Si la zone de liste a un style owner-drawn, mais pas le style _ HASSTRINGS kg , ce paramètre est stocké en tant que données d’élément au lieu d’une chaîne. Vous pouvez envoyer les messages lb _ GETITEMDATA et _ SETITEMDATA pour extraire ou modifier les données de l’élément.

Valeur retournée

La valeur de retour est l’index de base zéro de la chaîne dans la zone de liste. Si une erreur se produit, la valeur de retour est LB _ Err. Si l’espace est insuffisant pour stocker la nouvelle chaîne, la valeur de retour est LB _ ERRSPACE.

Remarques

Si la zone de liste a un style owner-drawn et le style de _ Tri lbs , mais pas le style _ HASSTRINGS kg , le système envoie une ou plusieurs fois le message WM _ COMPAREITEM au propriétaire de la zone de liste pour placer correctement le nouvel élément dans la zone de liste.

Le message lb _ INITSTORAGE permet d’accélérer l’initialisation des zones de liste qui comportent un grand nombre d’éléments (plus de 100). Il réserve la quantité de mémoire spécifiée, de sorte que _ les messages de l’équilibreur de volume suivant prennent le plus de temps possible. Vous pouvez utiliser des estimations pour les paramètres wParam et lParam . Si vous surestime, la mémoire supplémentaire est allouée. Si vous sous-estimez, l’allocation normale est utilisée pour les éléments qui dépassent la quantité demandée.

Si la zone de liste a le style WS _ HSCROLL et que vous ajoutez une chaîne plus grande que la zone de liste, envoyez un message lb _ SETHORIZONTALEXTENT pour vous assurer que la barre de défilement horizontale s’affiche.

Pour une application ANSI, le système convertit le texte d’une zone de liste en Unicode à l’aide de CP _ ACP. Cela peut entraîner des problèmes. par exemple, les caractères romains accentués dans une zone de liste non Unicode en japonais Windows sont tronqués. Pour résoudre ce problème, compilez l’application en Unicode ou utilisez une zone de liste owner-drawn.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
En-tête
Winuser. h (inclure Windows. h)

Voir aussi

Référence

_DELETESTRING lb

_INSERTSTRING lb

_SELECTSTRING lb

_SETHORIZONTALEXTENT lb

_COMPAREITEM WM