|
|
|
|
- Procedure para la gestión de cada archivo añadido
- Tener en cuenta los archivos listados
- Recopilación
- Añadir varios archivos idénticos
- Configuración necesaria
BurnerAddDirectory( Función) Añade todos los archivos encontrados en un directorio a la compilación.. Una vez añadidos todos los archivos deseados a la compilación, se puede grabar el CD o DVD ( BurnerSave). Por cada archivo agregado, la función BurnerAddDirectory llama automáticamente a un procedimiento específico escrito en WLanguage. Este Procedure se utiliza para manipular el archivo actual. // Burn a data CD BurnerMediaType(médiaType_CD_ROM_XA) // Add the files found in "C:\MyDirectory" // The ProcAddFile procedure will be automatically called for each added file ResAdd is boolean ResAdd = BurnerAddDirectory("C:\MyDirectory", "", ProcAddFile) // To view the entire example, click the "Example" link
// Burn an audio CD BurnerMediaType(médiaType_CDDA_CDROM) // Add the ".WAV" files found in "C:\MyMusic" ResAdd is boolean ResAdd = BurnerAddDirectory("C:\MyMusic\*.WAV") // To view the entire example, click the "Example" link
Sintaxis
<Result> = BurnerAddDirectory(<Directory to add> [, <Directory on CD or DVD> [, <WLanguage procedure> [, <Pointer>]]] [, <Options>])
<Result>: booleano - True si los archivos del directorio se agregaron a la compilación,
- False en caso contrario. Para obtener más información sobre el error, utilice la función ErrorInfo.
Observación: Un CD o DVD debe encontrarse en la grabadora.. Este CD o DVD debe tener suficiente espacio para grabar una nueva sesión.
<Directory to add>: Cadena de caracteres Ruta y nombre genérico de los ficheros que se añadirán a la compilación (hasta 260 caracteres). La ruta puede ser una ruta completa, relativa o UNC. Los caracteres genéricos (* y?) están permitidos. Para una compilación de audio, estos archivos deben corresponder al archivo ".WAV" (44100 Hz, 16 bits).
<Directory on CD or DVD>: Cadena de caracteres opcional Ruta del directorio en el CD o DVD. Esta ruta debe comenzar con un carácter de barra invertida ("\"). Por Default, la estructura de árbol del directorio será recreada a partir de la raíz del CD/DVD. Este parámetro se ignora para una compilación de audio. De hecho, todos los archivos se añadirán automáticamente en la raíz del CD/DVD. <WLanguage procedure>: Nombre de la Procedure opcional El nombre de WLanguage Procedure ("callback") llamado para cada archivo añadido. Este Procedure se utiliza para manipular el archivo actual. Este procedimiento tiene el siguiente formato:
PROCEDURE <Procedure name>(<Path>, <File name>, <Change>, <Procedure pointer>) Los parámetros de este Procedure son opcionales. No hay necesidad de pasarle parámetros a este Procedure. De hecho, estos parámetros se rellenan automáticamente cada vez que se procesa un fichero. El archivo se añadirá (o no) a la compilación según el valor devuelto por esta Procedure (ver las Notas. <Pointer>: Entero opcional Puntero pasado al procedimiento <Nombre de procedimiento>. <Options>: Combinación de constantes enteras, parámetro opcional Tipo de búsqueda realizada para añadir los archivos encontrados en los directorios: | | burnerInterruptibleAddition | La navegación se puede interrumpir pulsando la tecla ESC.
| burnerNonRecursiveAddition | La navegación es una navegación no recursiva. Los subdirectorios son ignorados. | burnerRecursiveAddition (Valor predeterminado) | La exploración es recursiva. Los subdirectorios se tienen en cuenta automáticamente. |
Observaciones Procedure para la gestión de cada archivo añadido Por cada archivo agregado, la función BurnerAddDirectory llama automáticamente al procedimiento <Nombre de procedimiento>. Este Procedure es un Procedure local o global. Esta Procedure debe ser declarada de la siguiente manera: PROCEDURE <Procedure name> (<Path>, <File name>, <Change>, <Procedure pointer>) - <Ruta> es la ruta del archivo manipulado (siempre termina con una barra invertida "\"; por ejemplo "C:Archivos\").
- <Nombre de archivo> es una cadena de caracteres que contiene el nombre del archivo encontrado.
- <Cambio> es una constante set a:
- flFirstFilecuando el archivo es el primero listado en <Ruta>,
- flChangeDir cuando el archivo es el primer archivo listado en un subdirectorio de <Path> (lo que significa que el directorio ha cambiado),
- flFile en los demás casos.
Los diferentes valores que puede tomar <Change> son los siguientes:
| | Archivo actual | <Cambiar> |
---|
Dir\Archivo 1 | flFirstFile | Dir\Archivo n | flFile | Dir\SubDir 1\Archivo 1 | flChangeDir | Dir\SubDir 1\Archivo m | flFile | Dir\SubDir 2\Archivo 1 | flChangeDir | Dir\SubDir 2\Archivo x | flFile |
- <Puntero Procedure> es un entero cuyo valor es el que se pasa al parámetro <Puntero> de BurnerAddDirectory. Si no se especifica <Pointer>, <Pointer> es set a 0.
Para obtener el valor de <puntero Procedure>, su valor debe asignarse al valor de <puntero> en la Procedure con Transferir. Observación: Los parámetros de este Procedure son opcionales: tiene la posibilidad de especificar el nombre y el ruta por ejemplo. Especifique (si es necesario) el valor de retorno de la Procedure mediante la palabra clave RETURN. Los valores posibles son los siguientes: - 0: el archivo no se agrega a la compilación y la enumeración de archivos se detiene.
- 1: el fichero se añade a la compilación y la enumeración del fichero continúa.
- 2: el archivo no se añade a la compilación y la enumeración del archivo continúa.
Ejemplo: PROCÉDURE AddElement(Directory, Name, Change) Trace(Directory + TAB, Name + TAB, Change + TAB) // Burn the file and continue the enumeration RESULT 1 // Don't burn the file and stop // RESULT 0 // Don't burn the file and continue // RESULT 2
Tener en cuenta los archivos listados Para cada archivo listado, puede hacerlo: - añadir el archivo a la compilación y continuar la enumeración de los archivos. Utilice la siguiente línea de código en el <nombre de Procedure> Procedure:
- no añadir ningún archivo a la compilación y continuar la enumeración de los archivos. Utiliza la siguiente línea de código en <nombre de la Procedure>:
- no añadir ningún archivo a la compilación y detener la enumeración de los archivos. Utiliza la siguiente línea de código en <nombre de la Procedure>:
Si <Procedure nombre> Procedure no devuelve ningún valor, el archivo se añade a la compilación y la enumeración de los archivos continúa. Recopilación Una compilación corresponde a la set de archivos que deben ser grabados en un CD o DVD. Esta recopilación se tendrá en cuenta la próxima vez que se llame a BurnerSave. Una compilación se crea automáticamente al llamar por primera vez a la función QuemadorAñadirArchivo o BurnerAddDirectory. Se puede crear una sola compilación a la vez. Una compilación se elimina automáticamente: - al cambiar el tipo de CD/DVD a grabar (BurnerMediaTipo).
- al seleccionar el quemador default (QuemadorSeleccionar).
- después de llamar a la función BurnerSave (solo si se inició la grabación, <Resultado> se establece en True).
- al cancelar la grabación process (QuemadorCancelar).
- al cerrar la aplicación WINDEV o el sitio WEBDEV actual.
Añadir varios archivos idénticos Si el mismo archivo se añade varias veces a la compilación: - para un CD/DVD de audio: este archivo se encontrará en el CD/DVD tantas veces como se agregó.
- para un CD/DVD de datos: sólo el último archivo añadido (mismo nombre, mismo directorio de destino) se encontrará en el CD/DVD.
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|