ExplorerTreeGadget()

Syntaxe

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

Créé un nouveau #Gadget de type TreeGadget() 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_NoLines            : Cache les lignes de liaisons entre les noeuds '+'.
  #PB_Explorer_NoButtons          : Cache les noeuds '+'.

  #PB_Explorer_NoFiles         : Aucun fichier ne sera affiché.
  #PB_Explorer_NoDriveRequester: Aucun message du type 'Insérer un disque dans le lecteur A:' ne sera affiché.
  #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:

- GetGadgetText(): Renvoie le chemin complet du répertoire ou fichier sélectionné.
- SetGadgetText(): Change l'élément actuellement sélectionné.
- GetGadgetState(): Permet de savoir si l'élément sélectionné est un répertoire ou un fichier.

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 et des marqueurs si l'option #PB_Explorer_GridLines est utilisée.

ExplorerTreeGadget() génère les évènements suivants, renvoyés par 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, 300, 300, "ExplorerTreeGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered) And CreateGadgetList(WindowID(0))
    ExplorerTreeGadget(0, 10, 10, 280, 280, "*.pb;*.pbi")
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf 

OS Supportés

Tous