ExplorerTreeGadget()

Syntaxe

Resultat = ExplorerTreeGadget(#Gadget, X, Y, Largeur, Hauteur, Repertoire$, [, Options])
Description
Créé un gadget qui affiche une liste des dossiers.
Il permet à l'utilisateur de choisir un fichier ou un dossier situé à n'importe quel endroit des disques.

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

Options (optionnel) Peut être une combinaison de: 
  #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.

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 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.
  
  - 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.

  Note: SetGadgetColor() n'est pas pris en charge sur la plate-forme MacOS X.
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 de 'Glisser & Déposer'.

Exemple

  If OpenWindow(0, 0, 0, 300, 300, "ExplorerTreeGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered) 
    ExplorerTreeGadget(0, 10, 10, 280, 280, "*.pb;*.pbi")
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Voir aussi

GetGadgetText(), SetGadgetText(), GetGadgetState(), GetGadgetColor(), SetGadgetColor(), ExplorerComboGadget(), ExplorerListGadget(), TreeGadget()

OS Supportés

Tous

<- ExplorerListGadget() - Gadget Index - FrameGadget() ->