Creer document

version 6.7.1 (Modifiée)

Creer document (document{; type}) DocRef

La commande Creer document crée un document et retourne son numéro de référence de document.

Vous passez le nom ou le chemin d'accès complet du nouveau document dans document. Si document existe déjà, il est remplacé. Cependant, si le document est verrouillé ou est déjà ouvert, une erreur est générée.

Si vous passez une chaîne vide dans document, une boîte de dialogue standard d'enregistrement de fichiers apparaît et l'utilisateur peut spécifier le nom du document. Si dans ce cas l'utilisateur clique sur le bouton Annuler, Creer document retourne une référence de document nulle, et la variable OK prend la valeur 0.

Si le document est correctement créé et ouvert, Creer document retourne sa référence de document et la variable système OK prend la valeur 1. La variable système Document est mise à jour et retourne le chemin d'accès du document créé.

Que vous utilisiez ou non la boîte de dialogue standard d'enregistrement de fichiers, Creer document crée par défaut un document de type TEXT (Mac OS) ou .TXT (Windows). Pour créer un autre type de document, passez un type dans le paramètre optionnel type.

Sous Mac OS, vous passez un type de fichier.

Sous Windows, vous pouvez passer 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. Si vous souhaitez créer un document sans extension, un document comportant plusieurs extensions, ou un document comportant une extension de plus de trois caractères, n'utilisez pas le paramètre type et passez le nom complet dans document (cf. exemple 2).

Une fois que vous avez créé et 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 crée et ouvre un nouveau document qui s'appelle "Note", écrit la chaîne "Bonjour" et le referme :

   C_HEURE(vDoc) 
   vDoc := Creer document ("Note")  ` Créer un nouveau document qui s'appelle Note 
   Si (OK=1) 
      ENVOYER PAQUET (vDoc; "Bonjour")  ` Ecrire un mot dans le document 
      FERMER DOCUMENT (vDoc)  ` Fermer le document 
   Fin de si

(2) L'exemple suivant crée sous Windows des documents avec des extensions non standard :

   $vhMonDoc:=Creer document("LeDoc.ext1.ext2") `Plusieurs extensions
   $vhMonDoc:=Creer document("LeDoc.shtml") `Extension longue
   $vhMonDoc:=Creer document("LeDoc.") `Pas d'extension (le point "." est obligatoire)

Si le document est correctement créé, la variable système OK prend la valeur 1 et la variable système 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).

Ajouter a document, Ouvrir document.