AddGadgetItem()
Syntaxe
Resultat = AddGadgetItem(#Gadget, Position, Texte$ [, ImageID [, Options]])Description
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é. La taille conseillée de l'image est de 16x16 pixels.'ImageID' peut être récupéré facilement grâce à la commande ImageID(). Les gadgets supportant cette commande sont:
- ComboBoxGadget(): support de l'ImageID si l'option #PB_ComboBox_Image est spécifiée.
- 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. Le paramètre 'Position' est ignoré.
La 'Position' précise le numéro d'emplacement où sera inséré le nouvel élément contenu dans Texte$. Pour ajouter l'élément au début de la liste, indiquez 0 dans 'Position'. Pour ajouter l'élément à la fin de la liste, indiquez -1 dans 'Position'. Souvenez vous qu'en insérant un nouvel élément dans la liste, la position des éléments qui le suivent est incrémentée de 1.
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