ListIconGadget()

Syntaxe

Resultat = ListIconGadget(#Gadget, X, Y, Largeur, Hauteur, TitrePremiereColonne$, LargeurTitrePremiereColonne [, Options])
Description
Crée un gadget de listes avec icônes dans la GadgetList en cours.

Arguments

#Gadget Le numéro d'identification du nouveau gadget.

#PB_Any peut être utilisé pour générer automatiquement ce numéro.
X, Y, Largeur, Hauteur La position et les dimensions du nouveau gadget.
TitrePremiereColonne$ Le titre de la première colonne dans le gadget.

Le gadget est créé avec une colonne initiale.
LargeurTitrePremiereColonne La largeur de la première colonne dans le gadget.
Options (optionnel) Peut être une combinaison de:
  #PB_ListIcon_CheckBoxes         : Affiche une case à cocher dans la première colonne.
  #PB_ListIcon_ThreeState         : La case à cocher peut avoir un état 'indéterminé'.
  #PB_ListIcon_MultiSelect        : Active le mode 'sélection multiple'.
  #PB_ListIcon_GridLines          : Affiche des lignes de séparation.
  #PB_ListIcon_FullRowSelect      : La sélection s'étend à toute la ligne au lieu de la première colonne (Windows seulement).
  #PB_ListIcon_HeaderDragDrop     : L'ordre des colonnes peut être changé avec un glisser/déposer (drag'n'drop).
  #PB_ListIcon_AlwaysShowSelection: Affiche la selection même quand le gadget n'est plus actif (Windows seulement).
L'option #PB_ListIcon_ThreeState peut être utilisée en combinaison avec l'option #PB_ListIcon_CheckBoxes pour obtenir une case à cocher qui peut avoir un état "on", "off" et "indéterminé". L'utilisateur ne peut sélectionner que l'état "on" ou "off". L'état "indéterminé" peut être défini en utilisant la fonction SetGadgetItemState().

Valeur de retour

Renvoie une valeur non nulle en cas de succès, zéro sinon.

Si #PB_Any a été utilisé pour le paramètre #Gadget, alors la valeur de retour est le numéro d'identification du gadget, généré automatiquement.

Remarques

  - GadgetToolTip() permet d'ajouter une 'mini aide' à ce gadget.

  Les fonctions suivantes peuvent être utilisées pour agir sur le contenu de cette liste :
  - AddGadgetColumn()   : Ajoute une colonne au gadget.
  - RemoveGadgetColumn(): Supprime une colonne (ainsi que ses données).
  - AddGadgetItem()     : Ajoute un élément et éventuellement une image.
  - RemoveGadgetItem()  : Supprime un élément.
  - ClearGadgetItems()  : Supprime tous les éléments.
  - CountGadgetItems()  : Renvoie le nombre d'éléments actuellement contenus dans le gadget.
  - GetGadgetItemColor(): Renvoie la couleur du texte ou du fond de l'élément.
  - SetGadgetItemColor(): Change la couleur du texte ou du fond de l'élément.
                         (Couleur de fond pas pris en charge sur MacOS X)
  - GetGadgetItemData() : Renvoie la valeur personnalisée associée à cet élément.
  - SetGadgetItemData() : Associe une valeur personnalisée à cet élément.
  - GetGadgetItemState(): Renvoie l'état de l'élément spécifié. 
                          Ce peut être une combinaison de #PB_ListIcon_Selected 
                          et #PB_ListIcon_Checked si les 'cases à cocher' sont affichées
  - SetGadgetItemState(): Change l'état de l'élément spécifié. 
                          Ce peut être une combinaison de #PB_ListIcon_Selected
                          et #PB_ListIcon_Checked si les 'cases à cocher' sont affichées
  - GetGadgetItemText() : Renvoie le texte de l'élément spécifié. 
                          Si 'Element' = -1, alors le titre de la colonne est renvoyé.
  - SetGadgetItemText() : Change le texte de l'élément spécifié. 
                          Si 'Element' = -1, alors le titre de la colonne est modifié.
                          Comme avec AddGadgetItem(), il est possible de définir le texte de 
                          plusieurs colonnes à la fois, avec le séparateur Chr(10).
  - SetGadgetItemImage(): Modifie l'image actuelle de l'élément spécifié.
  - GetGadgetState()    : Renvoie le premier élément selectionné ou -1 s'il n'y a pas d'élément sélectionné.
  - SetGadgetState()    : Change l'élément sélectionné (tous les autres éléments sont alors désélectionnés). 
                          Si -1 est utilisé, tous les éléments seront désélectionnés.
  - GetGadgetAttribute() avec l'attribut suivant :
      #PB_ListIcon_ColumnCount: Renvoie le nombre de colonnes 
      #PB_ListIcon_DisplayMode: Renvoie le mode d'affichage du gadget (Windows uniquement)

  - SetGadgetAttribute() avec l'attribut suivant (seulement sous Windows):
      #PB_ListIcon_DisplayMode : Change le mode d'affichage du gadget. 
           Le mode peut être l'une des constantes suivantes:
           #PB_ListIcon_LargeIcon   : Mode grandes icônes
           #PB_ListIcon_SmallIcon   : Mode petites icônes
           #PB_ListIcon_List        : Mode Liste
           #PB_ListIcon_Report      : Mode Détails (colonnes, mode par défaut)

  - GetGadgetItemAttribute() / SetGadgetItemAttribute(): Avec l'attribut suivant:
      #PB_ListIcon_ColumnWidth : Renvoie / Change la largeur de la 'Colonne' spécifiée. 
      Le paramètre 'Element' est ignoré.


  Si vous voulez ajouter du contenu à un gadget ListIcon contenant plusieurs colonnes en utilisant
  AddGadgetItem(), utilisez le format "première colonne"+chr(10)+"deuxième colonne" comme paramètre Texte$. 

  - SetGadgetColor() et GetGadgetColor() avec les valeurs 'TypeCouleur' suivantes:
    #PB_Gadget_FrontColor: Couleur du texte
    #PB_Gadget_BackColor : Couleur du fond
    #PB_Gadget_LineColor : Couleur de la grille si l'option #PB_ListIcon_GridLines est utilisée.

  -  SetGadgetItemColor() et GetGadgetItemColor() avec les  valeurs 'TypeCouleur' suivantes:
    #PB_Gadget_FrontColor: Texte de l'élément.
    #PB_Gadget_BackColor : Fond de l'élément.

  Note: SetGadgetColor() n'est pas pris en charge sur la plate-forme MacOS X.
Les évènements suivants sont supportés par EventType():
  #PB_EventType_LeftClick        : Clic avec le bouton gauche de la souris, ou une case à cocher a été utilisée.
  #PB_EventType_LeftDoubleClick  : Double-clic avec le bouton gauche de la souris
  #PB_EventType_RightClick       : Clic avec le bouton droit de la souris
  #PB_EventType_RightDoubleClick : Double-clic avec le bouton droit de la souris
  #PB_EventType_Change           : L'élément sélectionné a été changé
  #PB_EventType_DragStart        : L'utilisateur a essayé de lancer une opération de 'Glisser & Déposer'.
Après un évènement #PB_EventType_DragStart, la bibliothèque Drag & Drop peut être utilisée pour commencer une opération 'Glisser & Déposer'.

Exemple

 If OpenWindow(0, 100, 100, 300, 100, "ListIconGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
   ListIconGadget(0, 5, 5, 290, 90, "Nom", 100, #PB_ListIcon_FullRowSelect | #PB_ListIcon_AlwaysShowSelection)
   AddGadgetColumn(0, 1, "Adresse", 250)
   AddGadgetItem(0, -1, "Harry Rannit"+Chr(10)+"12 Parliament Way, Battle Street, By the Bay")
   AddGadgetItem(0, -1, "Ginger Brokeit"+Chr(10)+"130 PureBasic Road, BigTown, CodeCity")

   Repeat
     Evenement = WaitWindowEvent()
   Until Evenement = #PB_Event_CloseWindow
 EndIf

Exemple

  ; Démonstration des options possibles pour le gadget liste avec icônes...
  If OpenWindow(0, 0, 0, 700, 300, "ListIconGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered) 
    ; colonne de gauche
    TextGadget    (6,  10,  10, 330, 20, "Liste avec icônes standard", #PB_Text_Center)
    ListIconGadget(0,  10,  25, 330, 70, "Colonne 1", 100)
    TextGadget    (7,  10, 105, 330, 20, "Liste avec icônes + cases à cocher", #PB_Text_Center)
    ListIconGadget(1,  10, 120, 330, 75, "Colonne 1", 100, #PB_ListIcon_CheckBoxes)  ; Liste avec icônes et cases à cocher
    TextGadget    (8,  10, 205, 330, 20, "Liste avec icônes + sélection multiple", #PB_Text_Center)
    ListIconGadget(2,  10, 220, 330, 70, "Colonne 1", 100, #PB_ListIcon_MultiSelect) ; Liste avec icônes et sélection multiple
    ; colonne de droite
    TextGadget    (9, 360,  10, 330, 20, "Liste avec icônes + lignes de séparation",#PB_Text_Center)
    ListIconGadget(3, 360,  25, 330, 70, "Colonne 1", 100, #PB_ListIcon_GridLines)
    TextGadget   (10, 360, 105, 330, 20, "Liste avec icônes + sélection de ligne entière + sélection toujours affichée",#PB_Text_Center)
    ListIconGadget(4, 360, 120, 330, 75, "Colonne 1", 100, #PB_ListIcon_FullRowSelect | #PB_ListIcon_AlwaysShowSelection)
    TextGadget   (11, 360, 205, 330, 20, "Liste avec icônes standard + mode grandes icônes",#PB_Text_Center)
    ListIconGadget(5, 360, 225, 330, 65, "", 200,#PB_ListIcon_GridLines)
    For a = 0 To 4            ; pour chacune des 5 premières listes avec icônes
      For b = 2 To 4          ; ajouter 3 colonnes supplémentaires
        AddGadgetColumn(a, b, "Colonne " + Str(b), 65)
      Next
      For b = 0 To 2          ; ajouter 4 éléments à chaque ligne des listes avec icônes
        AddGadgetItem(a, b, "Elément 1"+Chr(10)+"Elément 2"+Chr(10)+"Elément 3"+Chr(10)+"Elément 4")
      Next
    Next
    ; Ici nous changeons l'affichage de la liste avec icônes en mode grandes icônes et nous affichons une image
    If LoadImage(0, #PB_Compiler_Home+"Examples\Sources\Data\File.bmp")     ; changez le chemin/fichier contenant votre image 32x32 pixel
      SetGadgetAttribute(5, #PB_ListIcon_DisplayMode, #PB_ListIcon_LargeIcon)
      AddGadgetItem(5, 1, "Image 1", ImageID(0))
      AddGadgetItem(5, 2, "Image 2", ImageID(0))
    EndIf  
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Voir aussi

AddGadgetColumn(), RemoveGadgetColumn(), AddGadgetItem(), RemoveGadgetItem(), ClearGadgetItems(), CountGadgetItems(), GetGadgetState(), SetGadgetState(), GetGadgetAttribute(), SetGadgetAttribute(), GetGadgetItemText(), SetGadgetItemText(), GetGadgetItemState(), SetGadgetItemState(), SetGadgetItemImage(), GetGadgetItemData(), SetGadgetItemData(), GetGadgetItemAttribute(), SetGadgetItemAttribute(), GetGadgetColor(), SetGadgetColor(), GetGadgetItemColor(), SetGadgetItemColor(), ExplorerListGadget(), ListViewGadget()

OS Supportés

Tous

<- IsGadget() - Gadget Index - ListViewGadget() ->