4D v16.3

Open document

Accueil

 
4D v16.3
Open document

Open document 


 

Open document ( nomFichier {; typeFichier}{; mode} ) -> Résultat 
Paramètre Type   Description
nomFichier  Chaîne in 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 in Liste des types de documents à filtrer, ou "*" pour ne pas filtrer les documents
mode  Entier long in Mode d’ouverture du document
Résultat  RefDoc in Numéro de référence du document

La commande Open 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, Open document retourne une référence de document nulle, et la variable OK prend la valeur 0.

  • Si le document est correctement ouvert, Open 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, Open 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, veuillez consulter la page Introduction to Uniform Type Identifiers Overview sur le site developer.apple.com (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
Get Pathname Entier long 3
Read and Write Entier long 0
Read Mode Entier long 2
Write Mode Entier long 1

Lorsqu'un document est ouvert, Open document se place initialement au début du document, alors que Append 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 RECEIVE PACKET et SEND PACKET, que vous pouvez combiner avec les commandes Get document position et SET DOCUMENT POSITION pour accéder directement à certains endroits du document.

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

L'exemple suivant ouvre un document existant qui s'appelle “Note”, écrit la chaîne “Au revoir” dans le document et le referme. Tout contenu éventuellement présent dans le document est remplacé :

 C_TIME(vDoc)
 vDoc:=Open document("Note.txt";Read and Write//Ouvrir le document Note
 If(OK=1)
    SEND PACKET(vDoc;"Au revoir") //Ecrire un mot dans le document
    CLOSE DOCUMENT(vDoc) //Fermer le document
 End if

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

 vDoc:=Open document("PassFile";"TEXT") ` Le fichier est ouvert
 vRef:=Open document("PassFile";"TEXT";Read Mode` 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 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.



Voir aussi  

Append document
Create document

 
PROPRIÉTÉS 

Produit : 4D
Thème : Documents système
Numéro : 264

Cette commande modifie la variable système OKCette commande modifie la variable système DocumentCette commande modifie la variable système ErrorCommande(s) éligible(s) à l'exécution dans un process préemptif

 
HISTORIQUE 

Modifié : 4D v11 SQL

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)