ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / CD and DVD burning functions
  • Compilation
  • Adding several identical files
  • Required configuration
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
BurnerAddFile (Function)
In french: GraveurAjouteFichier
Adds a file to the compilation. When all the requested files have been added to the compilation, the CD/DVD can be burned (BurnerSave).
Remark: To add all the files found in a directory to the compilation, use BurnerAddDirectory.
// Burn a data CD
BurnerMediaType(mediaType_CD_ROM_XA)
// Add the files
ResAdd is boolean
ResAdd = BurnerAddFile("C:\MyDirectory\MyFileA.TXT", "\MyFiles\FileA.TXT")
ResAdd = BurnerAddFile("C:\MyDirectory\MyFileB.TXT", "\MyFiles\FileB.TXT")
// To view the entire example, click the "Example" link
// Burn an audio CD
BurnerMediaType(mediaType_CDDA_CDROM)
// Add the files
ResAdd is boolean
ResAdd = BurnerAddFile("C:\MyMusic\MySongA.WAV")
ResAdd = BurnerAddFile("C:\MyMusic\MySongB.WAV")
// To view the entire example, click the "Example" link
Syntax
<Result> = BurnerAddFile(<File to add> [, <File on CD or DVD>])
<Result>: Boolean
  • True if the file was added to the compilation,
  • False otherwise. To get more details on the error, use ErrorInfo.
Remark: A CD or a DVD must be found in the burner. This CD or DVD must have enough space to burn a new session.
<File to add>: Character string
Name and path of file that will be added into the compilation (up to 260 characters). A full path, a relative path or a UNC path can be used.
For an audio compilation, these files must correspond to ".WAV" files (44100 Hz, 16 bits).
<File on CD or DVD>: Optional character string
Name and path of file on the CD or DVD. This path must start with a backslash character ("\").
By default, the file will be added at the root of the CD/DVD.
This parameter is ignored for an audio compilation. Indeed, the file will be automatically added at the root of the CD/DVD.
Remarks

Compilation

A compilation corresponds to the set of files that must be burned on a CD or DVD. This compilation will be taken into account next time BurnerSave is called.
A compilation is automatically created during the first call to BurnerAddFile or BurnerAddDirectory. A single compilation can be created at a time.
A compilation is automatically deleted:
  • when changing the type of CD/DVD to burn (BurnerMediaType).
  • when selecting the default burner (BurnerSelect).
  • after the call to BurnerSave (only if the burn process was started, <Result> is set to True).
  • when canceling the burn process (BurnerCancel).
  • when closing the current WINDEV application or WEBDEV site.

Adding several identical files

If the same file is added several times to the compilation:
  • for an audio CD/DVD: this file will be found on the CD/DVD as many times as it was added.
  • for a data CD/DVD: only the last added file (same name, same directory on the CD/DVD) will be found on the CD/DVD.

Required configuration

Component: wd290grv.dll
Minimum version required
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help