ExplorerListGadget()

Syntaxe

Resultat = ExplorerListGadget(#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 est 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_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.
  #PB_Explorer_HiddenFiles        : Affiche les fichiers cachés (seulement avec Linux et OS X).

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:
  - AddGadgetColumn()   : Ajoute une colonne (prédéfinie ou additionnelle). Voir AddGadgetColumn() pour plus d'informations.
  - 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é.
  - SetGadgetItemState(): Modifier l'état sélectionné de l'élément spécifié.
  - CountGadgetItems()  : Compte le nombre d'éléments dans le répertoire.

  - GetGadgetAttribute() / SetGadgetAttribute(): avec l'attribut suivant(seulement sous Windows):
    #PB_Explorer_DisplayMode : Change le mode d'affichage du gadget. Le mode peut être l'une des constantes suivantes:
    #PB_Explorer_LargeIcon   : Mode grandes icônes
    #PB_Explorer_SmallIcon   : Mode petites icônes
    #PB_Explorer_List        : Mode Liste
    #PB_Explorer_Report      : Mode Détails (colonnes, mode par défaut)

  - GetGadgetItemAttribute() / SetGadgetItemAttribute(): Avec l'attribut suivant:

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

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

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

Exemple

  If OpenWindow(0, 0, 0, 400, 200, "ExplorerListGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered) 
    ExplorerListGadget(0, 10, 10, 380, 180, "*.*", #PB_Explorer_MultiSelect)
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Voir aussi

AddGadgetColumn(), RemoveGadgetColumn(), GetGadgetText(), SetGadgetText(), GetGadgetState(), GetGadgetItemState(), SetGadgetItemState(), GetGadgetItemText(), SetGadgetItemText(), CountGadgetItems(), GetGadgetAttribute(), SetGadgetAttribute(), GetGadgetItemAttribute(), SetGadgetItemAttribute(),SetGadgetColor(), GetGadgetColor(), ExplorerComboGadget(), ExplorerTreeGadget(), ListIconGadget()

OS Supportés

Tous

<- ExplorerComboGadget() - Gadget Index - ExplorerTreeGadget() ->