4D Doc Center : Ouvrir document

4D v14.3

Ouvrir document


Ouvrir document ( nomFichier {; typeFichier}{; mode} ) -> Résultat

Paramètre	Type	Description
nomFichier	Chaîne	Nom du document ou Chemin d'accès complet au document ou Chaîne vide pour afficher la boîte de dialogue
typeFichier	Chaîne	Liste des types de documents à filtrer, ou "*" pour ne pas filtrer les documents
mode	Entier long	Mode d’ouverture du document
Résultat	RefDoc	Numéro de référence du document

Description

La commande Ouvrir document ouvre le document dont vous avez passé le nom dans nomFichier.

Si vous passez une chaîne vide ("") dans nomFichier, une boîte de dialogue standard d'ouverture de fichiers apparaît et l'utilisateur peut désigner le document. Si dans ce cas l'utilisateur clique sur le bouton Annuler, aucun document n'est ouvert, Ouvrir document retourne une référence de document nulle, et la variable OK prend la valeur 0.

Si le document est correctement ouvert, Ouvrir document retourne sa référence de document et la variable OK prend la valeur 1.
Si le document était déjà ouvert en lecture et que le paramètre mode est omis, Ouvrir document l'ouvre en mode lecture/écriture par défaut et la variable OK prend la valeur 1.
Si le document était déjà ouvert en écriture et que vous tentez de l'ouvrir en mode écriture, une erreur -43 est générée. En revanche, vous pouvez l'ouvrir en mode lecture dans ce cas, la variable OK prend la valeur 1.
Si le document n'existe pas, une erreur est générée.

Passez dans le paramètre typeFichier 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 un 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 :
https://developer.apple.com/library/mac/#documentation/FileManagement/Conceptual/
understanding_utis/understand_utis_intro/understand_utis_intro.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 typeFichier.

Le paramètre optionnel mode permet de définir le mode d’ouverture du fichier document. Quatre modes d’ouverture sont disponibles. 4D vous propose les constantes prédéfinies suivantes, placées dans le thème Documents système :

Constante	Type	Valeur
Lecture et écriture	Entier long	0
Lire chemin accès	Entier long	3
Mode écriture	Entier long	1
Mode lecture	Entier long	2

Lorsqu'un document est ouvert, Ouvrir document se place initialement au début du document, alors que Ajouter a document se place à la fin.

Une fois que vous avez ouvert un document, vous pouvez écrire ou lire des valeurs dans ce document à l'aide des commandes RECEVOIR PAQUET et ENVOYER PAQUET, que vous pouvez combiner avec les commandes Position dans document et CHANGER POSITION DANS DOCUMENT pour accéder directement à certains endroits du document.

N'oubliez pas d'appeler finalement FERMER DOCUMENT pour le document.

Exemple 1

L'exemple suivant ouvre un document existant qui s'appelle “Note”, écrit la chaîne “Au revoir” dans le document et le referme. Si le document contient déjà la chaîne “Bonjour”, elle est remplacée :

 C_HEURE(vDoc)

 vDoc:=Ouvrir document("Note.txt";Lecture et écriture) ` Ouvrir le document Note

 Si(OK=1)

    ENVOYER PAQUET(vDoc;"Au revoir") ` Ecrire un mot dans le document

    FERMER DOCUMENT(vDoc) ` Fermer le document

 Fin de si

Exemple 2

Vous pouvez lire un document déjà ouvert en écriture :

 vDoc:=Ouvrir document("PassFile";"TEXT") ` Le fichier est ouvert

 vRef:=Ouvrir document("PassFile";"TEXT";Mode lecture) ` Le fichier est lu

Variables et ensembles système

Si le document est correctement ouvert, la variable système OK prend la valeur 1, sinon elle prend la valeur 0. Après l'appel, la variable système Document contient le nom complet du document.
Si vous passez la valeur 3 dans mode, la fonction retourne ?00:00:00? (pas de référence de document). Le document n’est pas ouvert mais les variables système Document et OK sont mises à jour :

OK prend la valeur 1,
Document contient le chemin d’accès et le nom du fichier document.

Note : Si vous passez une chaîne vide dans document, une boîte de dialogue d’ouverture de fichiers apparaît. Si elle est validée, Document et OK sont mises à jour comme décrit ci-dessus. Si elle est annulée, OK prend la valeur 0.