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