version 11 (Modifiée)
Ouvrir document (document{; leType{; mode}}) DocRef
Paramètre | Type | Description | |
document | Alpha | Nom du document ou | |
Chemin d'accès complet au document ou | |||
Chaîne vide pour afficher la boîte de dialogue | |||
leType | Alpha | Liste des types de documents à filtrer, ou | |
"*" pour ne pas filtrer les documents | |||
mode | Entier | Mode d'ouverture du document | |
Résultat | DocRef | Numéro de référence du document |
Description
La commande Ouvrir document ouvre le document dont vous avez passé le nom dans document.
Si vous passez une chaîne vide ("") dans document, 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 et que le paramètre mode n'est pas précisé, Ouvrir document l'ouvre en mode lecture et la variable OK prend la valeur 1.
• Si le document était déjà ouvert et que vous tentez de l'ouvrir en mode écriture, une erreur est générée.
• Si le document n'existe pas, une erreur est générée.
Passez dans le paramètre leType 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 leType.
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 (valeur par défaut) | Entier | 0 |
Mode écriture | Entier | 1 |
Mode lecture | Entier | 2 |
Lire chemin accès | Entier | 3 |
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.
Exemples
(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
(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 le fichier désigné par document n'est pas trouvé ou 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.
Référence
Ajouter a document, Creer document.