AddGadgetItem()

Syntaxe

Resultat = AddGadgetItem(#Gadget, Position, Texte$ [, ImageID [, Options]])

Ajoute un élément au gadget spécifié par #Gadget. Le paramètre 'ImageID' est facultatif et est utilisé pour afficher une image (icône) à côté de l'élément inséré. 'ImageID' peut être récupéré facilement grâce à la commande ImageID(). Les gadgets supportant cette commande sont:

- ComboBoxGadget()
- EditorGadget()
- ListViewGadget()
- ListIconGadget(): support de l'ImageID.
- MDIGadget(): si l'ImageID est une icône, elle sera affichée dans la barre de titre de la fenêtre fille.
- PanelGadget(): support de l'ImageID.
- TreeGadget(): support de l'ImageID. L'image doit être une icône de taille standard 16x16. Le paramètre 'Position' est ignoré.

La 'Position' précise le numéro d'emplacement de la liste des éléments où sera inséré le nouvel élément contenu dans Texte$. Pour ajouter l'élément à la fin de la liste, indiquez -1 dans Position.

Pour le MDIGadget() le paramètre 'Position' indique le numéro de la #Fenetre pour la nouvelle fenêtre MDI. #PB_Any peut être utilisé, auquel cas la valeur de retour sera le nouveau numéro défini automatiquement par PureBasic. Le paramètre 'Options' peut servir à spécifier les options de la nouvelle fenêtre MDI (voir OpenWindow()). Les constantes #PB_Window_BorderLess, #PB_Window_ScreenCentered et #PB_Window_WindowCentered ne sont pas supportées par les fenêtre MDI. Autrement dit, pour le MDIGadget() la syntaxe peut se présenter ainsi :
AddGadgetItem(#MDI, #Fenetre, Titre$ [, ImageID [, Options]])

Pour le TreeGadget(), le paramètre 'Options' est toujours requis. Il indique le niveau du nouvel élément. Si le niveau est plus grand que celui de l'élément précédent, le nouvel élément deviendra son 'enfant'. Si le niveau est plus petit, il sera ajouté après le 'parent' de l'élément précédent.

OS Supportés

Tous