DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions Graveur de CD et DVD
  • Procédure manipulant chaque fichier ajouté
  • Prise en compte des fichiers listés
  • Compilation
  • Ajout de plusieurs fichiers identiques
  • Configuration nécessaire
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
GraveurAjouteRépertoire (Fonction)
En anglais : BurnerAddDirectory
Ajoute la totalité des fichiers d'un répertoire à la compilation. Lorsque tous les fichiers voulus seront ajoutés à la compilation, la gravure du CD ou du DVD pourra être réalisée (fonction GraveurEnregistre).
Pour chaque fichier ajouté, la fonction GraveurAjouteRépertoire appelle automatiquement une procédure spécifique écrite en WLangage. Cette procédure permet de manipuler le fichier en cours.
Remarque : Pour ajouter un fichier à la compilation, utilisez la fonction GraveurAjouteFichier.
WINDEVEtats et RequêtesCode Utilisateur (MCU)
// Gravure d'un CD de type données 
GraveurTypeMédia(médiaType_CD_ROM_XA) 
// Ajout des fichiers présents dans "C:\MonRépertoire" et dans ses sous-répertoires
// L'ajout peut Ãªtre interrompu avec la touche Echap du clavier
ResAjout est un booléen 
ResAjout = GraveurAjouteRépertoire("C:\MonRépertoire", ...
graveurAjoutRécursif + graveurAjoutInterruptible)
// Gravure d'un CD de type données 
GraveurTypeMédia(médiaType_CD_ROM_XA) 
// Ajout des fichiers présents dans "C:\MonRépertoire"
// La procédure ProcAjoutFichier sera appelée automatiquement pour chaque fichier ajouté
ResAjout est un booléen 
ResAjout = GraveurAjouteRépertoire("C:\MonRépertoire", "", ProcAjoutFichier)
// Pour visualiser cet exemple en totalité, cliquez sur le lien "Exemple"
// Gravure d'un CD de type audio
GraveurTypeMédia(médiaType_CDDA_CDROM) 
// Ajout des fichiers de type ".WAV" présents dans "C:\MesMusiques"
ResAjout est un booléen 
ResAjout = GraveurAjouteRépertoire("C:\MesMusiques\*.WAV")  
// Pour visualiser cet exemple en totalité, cliquez sur le lien "Exemple"
Syntaxe
<Résultat> = GraveurAjouteRépertoire(<Répertoire à ajouter> [, <Répertoire sur le CD ou DVD> [, <Procédure WLangage> [, <Pointeur>]]] [, <Options>])
<Résultat> : Booléen
  • Vrai si les fichiers du répertoire ont été ajoutés à la compilation,
  • Faux dans le cas contraire. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo.
Remarque : Il est nécessaire qu'un CD ou DVD soit présent dans le graveur. Ce CD ou DVD doit contenir assez d'espace pour graver une nouvelle session.
<Répertoire à ajouter> : Chaîne de caractères
Chemin et nom générique des fichiers à ajouter dans la compilation (260 caractères maximum). Ce chemin peut être un chemin complet, relatif ou de type UNC.
Les caractères génériques (* et ?) sont autorisés.
Dans le cas d'une compilation de type audio, ces fichiers doivent correspondre à des fichiers ".WAV" (44100 Hz, 16 bits).
WEBDEV - Code Serveur Le chemin du répertoire est relatif au serveur Web.
<Répertoire sur le CD ou DVD> : Chaîne de caractères optionnelle
Chemin du répertoire sur le CD ou sur le DVD. Ce chemin doit commencer par le caractère "antislash" ("\"). Par défaut, l'arborescence du répertoire sera recréée à partir de la racine du CD/DVD.
Dans le cas d'une compilation de type audio, ce paramètre n'est pas pris en compte. En effet, l'ensemble des fichiers sera automatiquement ajouté à la racine du CD/DVD.
<Procédure WLangage> : Nom de procédure optionnelle
Nom de la procédure WLangage ("callback") appelée pour chaque fichier ajouté. Cette procédure permet de manipuler le fichier en cours.
Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Chemin>, <Nom du fichier>, <Change>,
<Pointeur de la procédure>)

Les paramètres de cette procédure sont optionnels.
Il n'est pas nécessaire de passer des paramètres à cette procédure. En effet, ces paramètres sont renseignés automatiquement à chaque fichier traité.
Selon la valeur renvoyée par cette procédure, le fichier traité peut être ajouté ou non à la compilation (voir Notes).
<Pointeur> : Entier optionnel
Pointeur passé à la procédure <Nom de la procédure>.
<Options> : Combinaison de constantes de type Entier, paramètre optionnel
Type de parcours effectué pour l'ajout des fichiers des répertoires :
graveurAjoutInterruptibleLe parcours peut être interrompu en utilisant la touche ECHAP.
WEBDEV - Code Serveur Cette constante n'a aucun effet.
graveurAjoutNonRécursifLe parcours est non récursif. Les sous-répertoires ne sont pas pris en compte.
graveurAjoutRécursif
(Valeur par défaut)
Le parcours est récursif. Les sous-répertoires sont automatiquement pris en compte.
Remarques

Procédure manipulant chaque fichier ajouté

Pour chaque fichier ajouté, la fonction GraveurAjouteRépertoire appelle automatiquement la procédure <Nom de la procédure>. Cette procédure est une procédure locale ou globale.
Cette procédure doit être déclarée de la façon suivante :
PROCEDURE <Nom de la procédure> (<Chemin>, <Nom du fichier>, <Change>, <Pointeur de la procédure>)
  • <Chemin> est le chemin du fichier manipulé (il contient toujours un "\" à la fin; par exemple, "C:\Fichiers\").
  • <Nom du fichier> est une chaîne de caractères contenant le nom du fichier trouvé.
  • <Change> est une constante qui vaut :
    • flPremierFichier lorsque le fichier est le premier listé dans le <Chemin>,
    • flChangeRépertoire lorsque le fichier est le premier listé dans un sous-répertoire de <Chemin> (cela signifie qu'il y a eu changement de répertoire),
    • flFichier dans tous les autres cas.
    Voici les différentes valeurs pouvant être prises par <Change> :
    Fichier en cours<Change>
    Rep\Fichier 1flPremierFichier
    Rep\Fichier nflFichier
    Rep\SousRep 1\Fichier 1flChangeRépertoire
    Rep\SousRep 1\Fichier mflFichier
    Rep\SousRep 2\Fichier 1flChangeRépertoire
    Rep\SousRep 2\Fichier xflFichier
  • <Pointeur de la procédure> est un entier qui vaut la valeur passé dans le paramètre <Pointeur> de la fonction GraveurAjouteRépertoire. Si le paramètre <Pointeur> n'est pas précisé, <Pointeur> vaut 0.
Pour récupérer la valeur du <Pointeur de la procédure>, affectez la valeur du <Pointeur de la procédure> à la valeur du <Pointeur> dans la procédure avec la fonction Transfert.
Remarque : Les paramètres de cette procédure sont optionnels : il est possible par exemple de ne spécifier que le nom et le chemin.
Indiquez si nécessaire la valeur de retour de la procédure à l'aide du mot-clé RENVOYER. Les différentes valeurs possibles sont les suivantes :
  • 0 : le fichier n'est pas ajouté à la compilation et l'énumération des fichiers s'arrête.
  • 1 : le fichier est ajouté à la compilation et l'énumération des fichiers continue.
  • 2 : le fichier n'est pas ajouté à la compilation et l'énumération des fichiers continue.
Exemple :
PROCÉDURE AjoutElément(Répertoire, Nom, Change)
Trace(Répertoire + TAB, Nom + TAB, Change + TAB)
// Graver le fichier et continuer Ã©numération
RENVOYER 1
// Ne pas graver le fichier et s'arrêter
// RENVOYER 0
// Ne pas graver le fichier et continuer
// RENVOYER 2

Prise en compte des fichiers listés

Pour chaque fichier listé, il est possible :
  • soit d'ajouter le fichier à la compilation et de continuer l'énumération des fichiers. Utilisez la ligne suivante dans la procédure <Nom de la procédure> :
    RENVOYER  1
  • soit de ne pas ajouter le fichier à la compilation et de continuer l'énumération des fichiers. Utilisez la ligne suivante dans la procédure <Nom de la procédure> :
    RENVOYER 2
  • soit de ne pas ajouter le fichier à la compilation et d'arrêter l'énumération des fichiers. Utilisez la ligne suivante dans la procédure <Nom de la procédure> :
    RENVOYER 0
Si la procédure <Nom de la procédure> ne retourne aucune valeur, le fichier est ajouté à la compilation et l'énumération des fichiers continue.

Compilation

Une compilation correspond à l'ensemble des fichiers à graver sur un CD ou un DVD. Cette compilation sera prise en compte lors du prochain appel de la fonction GraveurEnregistre.
Une compilation est automatiquement créée lors du premier appel de la fonction GraveurAjouteFichier ou de la fonction GraveurAjouteRépertoire. Une seule compilation à la fois peut être créée.
Une compilation est automatiquement supprimée :
  • soit lors du changement du type du CD/DVD à graver (fonction GraveurTypeMédia).
  • soit lors de la sélection du graveur utilisé par défaut (fonction GraveurSélectionne).
  • soit après l'appel de la fonction GraveurEnregistre (uniquement si la gravure a été lancée, <Résultat> à Vrai).
  • soit lors de l'annulation de la gravure (fonction GraveurAnnuleGravure).
  • soit lors de la fermeture de l'application WINDEV ou du site WEBDEV en cours.

Ajout de plusieurs fichiers identiques

Si le même fichier est ajouté plusieurs fois à la compilation :
  • dans le cas d'un CD/DVD de type audio : ce fichier sera présent sur le CD/DVD autant de fois qu'il a été ajouté.
  • dans le cas d'un CD/DVD de type données : seul le dernier fichier ajouté (même nom, même répertoire de destination) sera présent sur le CD/DVD.

Configuration nécessaire

WINDEV La gravure de CD est disponible uniquement sous Windows XP et supérieur. La gravure de DVD est disponible sous Windows Vista, et sous Windows XP en utilisant la mise à jour KB932716 pour Windows XP (cette mise à jour doit être téléchargée depuis le site de Microsoft et installée car elle n'est pas prise en compte par le mécanisme de Live Update).
WEBDEV - Code Serveur La gravure de CD et DVD sera réalisée sur le serveur Web. Pour graver des CD ou des DVD, le serveur doit être sous Windows XP ou supérieur. Pour graver des CD sous Windows 2003 Serveur, il est nécessaire d'activer le service de gravure IMAPI (nommée "Service COM de gravage de CD IMAPI"). Pour graver des DVD sous Windows 2003 Serveur, il est nécessaire d'installer en plus la mise à jour KB932716.
Composante : wd290grv.dll
Version minimum requise
  • Version 10
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale