Ouvrir document

version 6.8 (Modifiée)

Ouvrir document (document{; type{; mode}}) DocRef

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.

Sous Mac OS, si vous appelez la boîte de dialogue standard d'ouverture de fichiers, tous les types de documents sont affichés par défaut. Pour afficher un type spécifique de document, passez un type dans le paramètre optionnel type.

Sous Windows, si vous appelez la boîte de dialogue standard d'ouverture de fichiers, tous les documents *.* sont affichés par défaut. Pour afficher d'autres types de documents, passez une extension de fichier Windows (de 1 à 3 caractères) ou un type de fichier Mac OS associé à l'aide de la commande ASSOCIER TYPES FICHIER dans le paramètre optionnel type.

Sous Windows, même si vous n'appelez pas la boîte de dialogue standard d'ouverture de fichiers, vous pouvez passer une valeur dans type pour spécifier le type de document à ouvrir. Par défaut, Ouvrir document tente d'ouvrir un fichier .TXT. Si vous passez le paramètre type, Ouvrir document tentera d'ouvrir le document dont le nom est "document.type". Exemple :

   vhRefDoc:=Ouvrir document("C:\\Lettre";"WRI")

Dans ce cas, 4e Dimension recherche le document "C:\\Lettre.WRI" sur le disque dur. Si vous passez plus de trois caractères dans type, Ouvrir document prend en compte seulement les trois premiers caractères. Si aucun type de document n'est spécifié, 4e Dimension essaie d'ouvrir le document sans extension de fichier. S'il ne le trouve pas, il essaie d'ouvrir le document avec l'extension .TXT. S'il ne le trouve pas, l'erreur "Fichier non trouvé" est affichée.

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

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.

(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";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

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 soit le nom, soit le chemin d'accès et le nom du fichier document, suivant la valeur passée dans document (si vous avez passé un nom de fichier, Document contiendra ce nom, si vous avez passé un chemin d'accès complet, Document contiendra ce chemin d'accès complet).

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.

Ajouter a document, Creer document.