Developpez.com - 4D
X

Choisissez d'abord la catégorieensuite la rubrique :


Utilisation de la commande Selectionner document (4D 2004)

Date de publication : Janvier 2005

Par Jamras KOMONCHAROENSIRI (Technical Support 4D Inc.)
 

4D 2004 introduit une nouvelle commande appelée Selectionner document. Cette commande donne à 4D des possibilités nouvelles dans le maniement des sélections de fichiers. Cette Note Technique examine cette nouvelle commande et présente plusieurs exemples pour vous aider à mieux l'appréhender.

I. Syntaxe de la commande
II. Exemple 1 : Ouverture du dialogue de sélection dans un répertoire spécifique
III. Exemple 2 : Permettre le filtrage de types
IV. Exemple 3 : Autoriser les sélections multiples
V. Exemple 4 : Autoriser les sélections multiples, y compris les alias de fichiers
VI. Exemple 5 : Autoriser l’utilisateur à sélectionner un progiciel (Mac OS X seulement)
VII. Exemple 6 : Autoriser l’utilisateur à sélectionner un élément dans un progiciel (Mac OS X seulement)
VIII. Résumé


I. Syntaxe de la commande

Selectionner document (répertoire; typesFichiers; titre; options{; sélectionnés}) -> Chaîne


Pour vous aider à mieux comprendre le rôle de chaque paramètre, voici six exemples :


II. Exemple 1 : Ouverture du dialogue de sélection dans un répertoire spécifique

Le répertoire par défaut est fixé à: "Applications"

$repertoire := ":Applications"
$nomfichier :=Selectionner document ($repertoire; $filtre ;$titre ;$option ;$tabDocument)


Si on affecte à $repertoire la chaîne vide (""), 4D ouvrira comme répertoire par défaut le dossier "Documents" sous Mac OS X, "Mes documents" sous Windows.



III. Exemple 2 : Permettre le filtrage de types

Supposons que vous vouliez autoriser l’utilisateur à ouvrir seulement des fichiers TEXT ou JPEG. Pour obtenir cela, vous pouvez fixer la liste des types et les passer à la commande (séparés par des « ; ») comme cidessous :

$filtre:="JPEG;TEXT"   `"jpg;txt" sous Windows


Sur Windows, si l’utilisateur filtre un type de fichier particulier, les fichiers de ce type ne seront pas affichés.

Sur Mac OS X, les fichiers filtrés apparaîtront comme non sélectionnables.

info Note : Si vous ajoutez * à la liste du filtre, le dialogue de sélection offrira une option permettant de sélectionner tous les types de fichiers.

IV. Exemple 3 : Autoriser les sélections multiples

L’utilisateur peut sélectionner un ou plusieurs fichiers si l’option Fichiers multiples (ou 1) est ajoutée au paramètre d’options.

$option := Fichiers multiples
$nomfichier :=Selectionner document ($repertoire; $filtre ;$titre ;$option ;$tabDocument)


Tous les chemins sélectionnés seront inclus dans la variable tableau $tabDocument.



V. Exemple 4 : Autoriser les sélections multiples, y compris les alias de fichiers

En complément de l’autorisation des sélections multiples, vous pouvez ajouter une autre constante, Sélection alias (ou 8) au paramètre d’options pour permettre à l’utilisateur de sélectionner un alias de fichier.

$option := Fichiers multiples + Sélection alias  `1 + 8
$nomfichier :=Selectionner document ($repertoire; $filtre ;$titre ;$option ;$tabDocument)


Le chemin absolu de l’alias choisi sera inséré dans le tableau $tabDocument.


VI. Exemple 5 : Autoriser l’utilisateur à sélectionner un progiciel (Mac OS X seulement)

Cette option est disponible uniquement pour Mac OS X. La constante que vous devez ajouter au paramètre d’options est Sélection progiciel (ou 4).

$option := Sélection progiciel   ` 4
$nomfichier :=Selectionner document ($repertoire; $filtre ;$titre ;$option ;$tabDocument)


Si vous voulez autoriser l’utilisateur à sélectionner un alias de progiciel, vous pouvez le faire en ajoutant Sélection progiciel et Sélection alias au paramètre d’options.

$option := Sélection progiciel + Sélection alias   ` 4 + 8
$nomfichier :=Selectionner document ($repertoire; $filtre ;$titre ;$option ;$tabDocument)


info Note : Le chemin absolu de l’alias de progiciel sélectionné sera ajouté au tableau $tabDocument.

VII. Exemple 6 : Autoriser l’utilisateur à sélectionner un élément dans un progiciel (Mac OS X seulement)

Dans certains cas, vous pouvez vouloir autoriser l’utilisateur à sélectionner un élément à l’intérieur d’un progiciel. Vous pouvez le faire en ajoutant les deux constantes Ouverture progiciel et Sélection progiciel au paramètre d’options.

$option := Ouverture progiciel + Sélection progiciel   `2 + 4
$nomfichier :=Selectionner document ($repertoire; $filtre ;$titre ;$option ;$tabDocument)


info Note : Lorsqu’on utilise à la fois Ouverture progiciel et Sélection progiciel dans le paramètre d’options, un alias du progiciel est considéré comme un vrai progiciel. C’est pourquoi le chemin inséré dans le tableau $tabDocument est le chemin absolu du contenu du progiciel.

VIII. Résumé

Cette note technique a fourni plusieurs exemples pour vous aider à comprendre l’utilisation de la commande Selectionner document et pour vous donner une idée de la manière de l’utiliser. En passant différents paramètres à la commande, vous pouvez faire différents types de sélections de fichiers.

__________________________________________________
Copyright © 1985-2009 4D SA - Tous droits réservés
Tous les efforts ont été faits pour que le contenu de cette note technique présente le maximum de fiabilité possible.
Néanmoins, les différents éléments composant cette note technique, et le cas échéant, le code, sont fournis sans garantie d'aucune sorte. L'auteur et 4D S.A. déclinent donc toute responsabilité quant à l'utilisation qui pourrait être faite de ces éléments, tant à l'égard de leurs utilisateurs que des tiers.
Les informations contenues dans ce document peuvent faire l'objet de modifications sans préavis et ne sauraient en aucune manière engager 4D SA. La fourniture du logiciel décrit dans ce document est régie par un octroi de licence dont les termes sont précisés par ailleurs dans la licence électronique figurant sur le support du Logiciel et de la Documentation afférente. Le logiciel et sa documentation ne peuvent être utilisés, copiés ou reproduits sur quelque support que ce soit et de quelque manière que ce soit, que conformément aux termes de cette licence.
Aucune partie de ce document ne peut être reproduite ou recopiée de quelque manière que ce soit, électronique ou mécanique, y compris par photocopie, enregistrement, archivage ou tout autre procédé de stockage, de traitement et de récupération d'informations, pour d'autres buts que l'usage personnel de l'acheteur, et ce exclusivement aux conditions contractuelles, sans la permission explicite de 4D SA.
4D, 4D Calc, 4D Draw, 4D Write, 4D Insider, 4ème Dimension ®, 4D Server, 4D Compiler ainsi que les logos 4e Dimension, sont des marques enregistrées de 4D SA.
Windows,Windows NT,Win 32s et Microsoft sont des marques enregistrées de Microsoft Corporation.
Apple, Macintosh, Power Macintosh, LaserWriter, ImageWriter, QuickTime sont des marques enregistrées ou des noms commerciaux de Apple Computer,Inc.
Mac2Win Software Copyright © 1990-2002 est un produit de Altura Software,Inc.
4D Write contient des éléments de "MacLink Plus file translation", un produit de DataViz, Inc,55 Corporate drive,Trumbull,CT,USA.
XTND Copyright 1992-2002 © 4D SA. Tous droits réservés.
XTND Technology Copyright 1989-2002 © Claris Corporation.. Tous droits réservés ACROBAT © Copyright 1987-2002, Secret Commercial Adobe Systems Inc.Tous droits réservés. ACROBAT est une marque enregistrée d'Adobe Systems Inc.
Tous les autres noms de produits ou appellations sont des marques déposées ou des noms commerciaux appartenant à leurs propriétaires respectifs.
__________________________________________________
 



Valid XHTML 1.1!Valid CSS!

Ce document est issu de http://www.developpez.com et reste la propriété exclusive de son auteur. La copie, modification et/ou distribution par quelque moyen que ce soit est soumise à l'obtention préalable de l'autorisation de l'auteur.
Contacter le responsable de la rubrique 4D