|
|
|
|
- Procédure manipulant chaque fichier ajouté
- Prise en compte des fichiers listés
- Compilation
- Ajout de plusieurs fichiers identiques
- Configuration nécessaire
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.
GraveurTypeMédia(médiaType_CD_ROM_XA)
ResAjout est un booléen
ResAjout = GraveurAjouteRépertoire("C:\MonRépertoire", "", ProcAjoutFichier)
GraveurTypeMédia(médiaType_CDDA_CDROM)
ResAjout est un booléen
ResAjout = GraveurAjouteRépertoire("C:\MesMusiques\*.WAV")
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).
<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 : | | graveurAjoutInterruptible | Le parcours peut être interrompu en utilisant la touche ECHAP.
| graveurAjoutNonRécursif | Le 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 1 | flPremierFichier | Rep\Fichier n | flFichier | Rep\SousRep 1\Fichier 1 | flChangeRépertoire | Rep\SousRep 1\Fichier m | flFichier | Rep\SousRep 2\Fichier 1 | flChangeRépertoire | Rep\SousRep 2\Fichier x | flFichier |
- <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)
RENVOYER 1
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> :
- 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> :
- 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> :
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 Composante : wd290grv.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|