AddGadgetItem()

Syntaxe

Resultat = AddGadgetItem(#Gadget, Position, Texte$ [, ImageID [, Options]])
Description
Ajoute un élément à un gadget.

Arguments

#Gadget Le gadget à utiliser.
Position La position ou l'index du nouvel élément.

Pour ajouter un élément au début, utilisez la valeur 0.
Pour ajouter un élément à la fin de la liste des éléments en cours, utilisez la valeur -1.
N'oubliez pas que lorsque vous insérez un nouvel élément entre deux éléments existants, la position de chaque élément de droite est augmentée de 1.

Pour le MDIGadget() ce paramètre spécifie le numéro de la nouvelle fenêtre fille. PB_Any # peut être utilisé, dans ce cas, la valeur de retour sera le nouveau numéro attribué par PB.
Texte$ Le texte du nouvel élément.
Lorsque vous ajoutez un élément à un ListIconGadget(), ce paramètre peut contenir le texte de plusieurs colonnes séparées par un caractère Chr (10).
ImageID (optionnel) Le numéro d'une image (icône) à afficher à côté de l'élément inséré.
La taille de l'image doit être standard, c'est à dire de 16x16 pixels.

'ImageID' peut être récupéré facilement grâce à la commande ImageID().
Options (optionnel) Ce paramètre n'est utilisable qu'avec les gadgets suivants:

TreeGadget()
Ce paramètre spécifie le sous-niveau du nouvel item.
Si le sous-niveau est supérieur à celui de l'item précédent, le nouvel item devient l'enfant de celui-ci.
S'il est inférieur, il sera ajouté après le parent de l'élément précédent.
MDIGadget()
Ce paramètre peut être utilisé pour spécifier les options de la nouvelle fenêtre (voir OpenWindow()).
Les options #PB_Window_Borderless, #PB_Window_Screencentered et #PB_Window_WindowCentered ne sont pas prises en charge pour les fenêtres MDI.

Valeur de retour

La valeur de retour est uniquement valable qu'avec le MDIGadget(). Si #PB_Any a été utilisé à la place de 'Position' lors de l'ajout d'un élément à la MDIGadget(), la valeur de retour est le numéro d'identification de la nouvelle fenêtre MDI.

Remarques

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()     : ImageID ajoute une icône dans la barre de titre de la fenêtre fille et 'Options', les paramètres de la fenêtre.
  - PanelGadget()   : Support de l'ImageID.
  - TreeGadget()    : Support de l'ImageID. Le paramètre 'Options' spécifie le nouveau sous-niveau. 

Voir aussi

RemoveGadgetItem(), ClearGadgetItems(), CountGadgetItems(), ComboBoxGadget(), ListIconGadget(), ListViewGadget(), MDIGadget(), PanelGadget(), TreeGadget()

OS Supportés

Tous

<- AddGadgetColumn() - Gadget Index - BindGadgetEvent() ->