ExplorerListGadget()

Syntaxe

Resultat = ExplorerListGadget(#Gadget, x, y, Largeur, Hauteur, Repertoire$, [, Options])

Créé un nouveau #Gadget de type ListIconGadget() qui gère automatiquement l'affichage d'un répertoire et la navigation sur le disque (à la manière de l'Explorateur Windows). Si #PB_Any est utilisé pour le paramètre '#Gadget', le numéro du nouveau gadget sera renvoyé dans 'Resultat'. Il permet à l'utilisateur de choisir un fichier ou un dossier situé à n'importe quel endroit sur le disque (ou les disques).

'Repertoire$' est l'emplacement de départ lorsque le gadget sera créé. Il peut être composé de 'patterns', tels que: "C:\*.pb;*.pbi". Si aucun 'pattern' n'est spécifié, le répertoire doit se terminer par un '\'. Si aucun 'Repertoire$' est nul (chaîne vide), alors la liste des disques disponible sera affichée.

Le paramètre facultatif 'Options' peut être une combinaison des valeurs suivantes:

  #PB_Explorer_BorderLess         : Crée un #Gadget sans bordure.
  #PB_Explorer_AlwaysShowSelection: Affiche la sélection même quand le gadget n'est plus actif.
  #PB_Explorer_MultiSelect        : Active le mode 'sélection multiple'.
  #PB_Explorer_GridLines          : Affiche des lignes de séparation.
  #PB_Explorer_HeaderDragDrop     : L'ordre des colonnes peut être changé avec un glisser/déposer (drag'n'drop).
  #PB_Explorer_FullRowSelect      : La sélection s'étend à toute la ligne au lieu de la première colonne.

  #PB_Explorer_NoFiles          : Aucun fichier ne sera affiché.
  #PB_Explorer_NoFolders        : Aucun répertoire ne sera affiché.
  #PB_Explorer_NoParentFolder   : Le 'pseudo' répertoire père [..] ne sera pas affiché.
  #PB_Explorer_NoDirectoryChange: Le répertoire ne pourra pas être changé par l'utilisateur.
  #PB_Explorer_NoDriveRequester : Aucun message du type 'Insérer un disque dans le lecteur A:' ne sera affiché.
  #PB_Explorer_NoSort           : L'utilisateur ne pourra pas trier les colonnes en cliquant sur les titres des colonnes.
  #PB_Explorer_NoMyDocuments    : Le répertoire spécial 'Mes documents' ne sera pas affiché séparément.
  #PB_Explorer_AutoSort         : Le contenu sera automatiquement trié par nom.

Vous pouvez ajouter une 'mini aide' à ce gadget en utilisant GadgetToolTip().

Les commandes suivantes sont disponibles pour contrôler le gadget:

- ChangeListIconGadgetDisplay(): Change le mode d'affichage comme pour un ListIconGadget().
- AddGadgetColumn(): Ajoute une colonne (prédéfinie ou additionnelle). Voir AddGadgetColumn() pour plus d'information.
- RemoveGadgetColumn(): Supprime une colonne (ainsi que ses données).
- GetGadgetText(): Renvoie le répertoire affiché.
- SetGadgetText(): Change le répertoire affiché, ou les 'patterns' actuellement utilisés.
- GetGadgetState(): Renvoie l'index du premier élément selectionné (-1: aucune selection).
- GetGadgetItemText(): Renvoie le texte de l'élément, ou du titre de la colonne si 'Position' = -1.
- SetGadgetItemText(): Modifie le texte de l'élément, ou du titre de la colonne si 'Position' = -1.
- GetGadgetItemState(): Vérifie si un élément est un répertoire ou un fichier et si il est sélectionné.
- CountGadgetItems(): Compte le nombre d'éléments dans le répertoire.
- GetGadgetItemAttribute() avec l'attribut suivant:

  #PB_Explorer_ColumnWidth: Renvoie la largeur de la 'Colonne' spécifiée. Le paramètre 'Element' est ignoré.

- SetGadgetItemAttribute() avec l'attribut suivant:

  #PB_Explorer_ColumnWidth: Change la largeur de la 'Colonne' spécifiée. Le paramètre 'Element' est ignoré.

Ce gadget supporte les commandes SetGadgetColor() et GetGadgetColor() avec les valeurs suivantes comme 'TypeCouleur':

  #PB_Gadget_FrontColor: Couleur du texte 
  #PB_Gadget_BackColor : Couleur du fond
  #PB_Gadget_LineColor : Couleur de la grille si l'option #PB_Explorer_GridLines est utilisée.

Les évènements suivants sont disponibles par l'intermédiaire d' EventType():

  #PB_EventType_Change          : La sélection de l'élément courant vient de changer.
  #PB_EventType_LeftClick       : L'utilisateur a cliqué sur un élément avec le bouton gauche de la souris.
  #PB_EventType_RightClick      : L'utilisateur a cliqué sur un élément avec le bouton droit de la souris.
  #PB_EventType_LeftDoubleClick : L'utilisateur a double-cliqué sur un élément avec le bouton gauche de la souris.
  #PB_EventType_RightDoubleClick: L'utilisateur a double-cliqué sur un élément avec le bouton droit de la souris.
  #PB_EventType_DragStart       : L'utilisateur a essayé de lancer Une opération '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, 0, 0, 400, 200, "ExplorerListGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered) And CreateGadgetList(WindowID(0))
    ExplorerListGadget(0, 10, 10, 380, 180, "*.*", #PB_Explorer_MultiSelect)
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

OS Supportés

Tous