Share via


CB_INSERTSTRING message

Insère une chaîne ou des données d’élément dans la liste d’une zone de liste modifiable. Contrairement au message CB_ADDSTRING , le message CB_INSERTSTRING n’entraîne pas le tri d’une liste avec le style CBS_SORT.

Paramètres

wParam

Index de base zéro de la position à laquelle insérer la chaîne. Si ce paramètre est -1, la chaîne est ajoutée à la fin de la liste.

lParam

Pointeur vers la chaîne terminée par null à insérer. Si vous créez la zone de liste modifiable avec un style dessiné par le propriétaire, mais sans le style CBS_HASSTRINGS , la valeur du paramètre lParam est stockée plutôt que la chaîne vers laquelle il pointerait autrement.

Valeur retournée

La valeur de retour est l’index de la position à laquelle la chaîne a été insérée. Si une erreur se produit, la valeur de retour est CB_ERR. S’il n’y a pas suffisamment d’espace disponible pour stocker la nouvelle chaîne, elle est CB_ERRSPACE.

Si la zone de liste modifiable a WS_HSCROLL style et que vous insérez une chaîne plus large que la zone de liste modifiable, vous devez envoyer un message LB_SETHORIZONTALEXTENT pour vous assurer que la barre de défilement horizontale s’affiche.

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
Winuser.h (inclure Windows.h)

Voir aussi

Référence

CB_ADDSTRING

LB_SETHORIZONTALEXTENT

CB_DIR