Selectionner document

version 2004

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

La commande Selectionner document affiche une boîte de dialogue standard d'ouverture de documents, permettant à l'utilisateur de désigner un ou plusieurs fichier(s), et retourne le nom et/ou le chemin d'accès complet du ou des fichier(s) sélectionné(s).

Le paramètre répertoire indique le dossier dont le contenu doit être affiché initialement dans la boîte de dialogue d'ouverture de documents. Vous pouvez passer trois types de valeurs :

• un texte contenant le chemin d'accès complet du répertoire à afficher.

• une chaîne vide ("") pour afficher le dossier d'utilisateur par défaut du système ("Mes documents" sous Windows, "Documents" sous Mac OS).

• un numéro de chemin d'accès mémorisé (de 1 à 32000) pour afficher le dossier associé.

Avec ce principe, vous pouvez conserver en mémoire le chemin d'accès du dossier ouvert au moment où l'utilisateur a cliqué sur le bouton de sélection, c'est-à-dire le dossier choisi par l'utilisateur. Lors du premier appel d'un numéro arbitraire (par exemple 5), la commande affiche le dossier d'utilisateur par défaut du système (équivaut à passer une chaîne vide). L'utilisateur pourra alors éventuellement naviguer parmi les dossiers de son disque dur. Au moment où il cliquera sur le bouton de sélection, le chemin d'accès sera mémorisé et associé au numéro 5. Lors des appels suivants du numéro 5, le chemin d'accès mémorisé sera utilisé par défaut. En cas de sélection d'un nouvel emplacement, le chemin numéro 5 sera mis à jour, et ainsi de suite.

Ce mécanisme vous permet de mémoriser jusqu'à 32000 chemins d'accès. Sous Windows, chaque chemin est conservé durant la session uniquement. Sous Mac OS, les chemins sont conservés par le système, ils restent mémorisés d'une session à l'autre.

Note : Ce mécanisme est identique à celui utilisé par la commande Selectionner dossier. Les numéros de chemins d'accès mémorisés sont partagés entre les deux commandes.

Passez dans le paramètre typeFichiers le ou les type(s) de fichier(s) pouvant être sélectionnés dans la boîte de dialogue d'ouverture. Vous pouvez passer une liste de plusieurs types séparés par un ; (point virgule). Pour chaque type défini, une ligne sera ajoutée dans le menu de choix de type de la boîte de dialogue.

Sous Mac OS, vous pouvez passer soit type Mac OS classique (TEXT, APPL, etc.), soit un type UTI (Uniform Type Identifier). Les types UTIs ont été définis par Apple afin de répondre aux besoins d'uniformisation des types de fichiers. Par exemple, "public.text" est le type UTI des fichiers de type texte. Pour plus d'informations sur les UTIs, reportez-vous à l'adresse http://developer.apple.com/documentation/Carbon/Conceptual/understanding_utis/index.html (documentation en anglais).

Sous Windows, vous pouvez également passer un type de fichier classique Mac OS — 4D effectue la correspondance en interne — ou l'extension des fichiers (.txt, .exe, etc.). A noter que sous Windows, l'utilisateur aura la possibilité de "forcer" l'affichage de tous les types de fichiers en saisissant *.* dans la boîte de dialogue. Toutefois dans ce cas, 4D effectuera une vérification supplémentaire des types des fichiers sélectionnés : si l'utilisateur sélectionne un type de fichier non autorisé, la commande retourne une erreur.

Si vous ne souhaitez pas restreindre les fichiers affichés à un ou plusieurs types, passez la chaîne "*" (étoile) ou ".*" dans typeFichiers.

Passez dans le paramètre titre le libellé devant apparaître dans la boîte de dialogue. Par défaut, si vous passez une chaîne vide, le libellé "Ouvrir" est affiché.

Le paramètre options permet de spécifier les fonctions avancées autorisées dans la boîte de dialogue d'ouverture. 4D vous propose les constantes prédéfinies suivantes, placées dans le thème "Documents système" :

Vous pouvez passer une constante ou une combinaison de constantes.

• Fichiers multiples : autoriser la sélection simultanée de plusieurs fichiers à l'aide des combinaisons Maj+clic (sélection contiguë) et Ctrl+clic (Windows) ou Commande+clic (Mac OS). Dans ce cas, le paramètre sélectionnés, s'il est passé, contient la liste de tous les fichiers sélectionnés. Par défaut, si cette constante n'est pas utilisée, la commande n'autorise pas la sélection de plusieurs fichiers.

• Ouverture progiciel (Mac OS uniquement) : autoriser l'ouverture des progiciels (packages) et la visualisation de leur contenu. Par défaut, si cette constante n'est pas utilisée, la commande n'autorise pas l'ouverture des progiciels.

• Sélection progiciel (Mac OS uniquement) : autoriser la sélection de progiciels (packages) en tant qu'entités. Par défaut, si cette constante n'est pas utilisée, la commande ne permet pas de sélectionner les progiciels en tant que tels. Dans ce cas, même si la constante Ouverture progiciel est utilisée, il est impossible d'ouvrir ou de sélectionner un progiciel.

• Sélection alias : autoriser la sélection de raccourcis (Windows) ou d'alias (Mac OS) en tant que documents. Par défaut, si cette constante n'est pas utilisée, la commande n'autorise pas la sélection de raccourcis ou d'alias en tant que tels. Si l'utilisateur sélectionne ce type de document, la commande retourne le chemin de l'élément cible. Lorsque vous passez la constante, la commande retourne le chemin de l'alias ou du raccourci lui-même.

• Utiliser fenêtre feuille (Mac OS uniquement) : afficher la boîte de dialogue de sélection sous forme de fenêtre feuille (cette option est ignorée sous Windows).

Les fenêtres feuilles sont des fenêtres spécifiques de l'interface Mac OS X, bénéficiant notamment d'une animation graphique (pour plus d'informations, reportez-vous à la section Types de fenêtres). Par défaut, si cette constante n'est pas utilisée, la commande affiche une boîte de dialogue standard.

Si vous ne souhaitez pas utiliser d'option, passez 0 dans le paramètre options.

Le paramètre facultatif sélectionnés permet de récupérer le chemin d'accès complet (chemin d'accès + nom) de chaque fichier sélectionné par l'utilisateur. La commande crée, dimensionne et remplit le tableau en fonction de la sélection de l'utilisateur. Ce paramètre est utile lorsque l'option Fichiers multiples est utilisée, ou lorsque vous souhaitez connaître le chemin d'accès du fichier sélectionné (il suffit dans ce cas de soustraire de la valeur du tableau le nom du fichier retourné par la commande). Si aucun fichier n'a été sélectionné, le tableau est retourné vide.

La commande retourne le nom (nom+extension sous Windows) du fichier sélectionné. Si plusieurs fichiers ont été sélectionnés, la commande retourne le nom du premier fichier de la liste des fichiers sélectionnés. La liste des fichiers peut être récupérée dans le paramètre sélectionnés. Si aucun fichier n'a été sélectionné, la commande retourne une chaîne vide.

Cet exemple permet de désigner un fichier de données 4D :

   C_ENTIER LONG($platForm)
   PROPRIETES PLATE FORME($platForm)
   Si ($platForm=Windows )
      $DocType:=".4DD"
   Sinon
      $DocType:="com.4d.4d.data-file"   `Type UTI
   Fin de si
   $Options:=Sélection alias +Ouverture progiciel +Utiliser fenêtre feuille
   $Doc:=Selectionner document("";$DocType;"Sélectionner le fichier de données";$Options)

Ouvrir document, Selectionner dossier.

Si la commande a été correctement exécutée et qu'un document valide a été sélectionné, la variable système OK prend la valeur 1 et la variable système Document contient le chemin d'accès complet du fichier sélectionné.

Si aucun fichier n'a été sélectionné (par exemple si l'utilisateur a cliqué sur le bouton Annuler dans la boîte de dialogue d'ouverture), la variable système OK prend la valeur 0 et la variable système Document est vide.