El comando SET WR PRINT OPTION se utiliza para modificar el valor de una opción de impresión por programación para el área 4D Write designada por el parámetro area. Cada opción definida utilizando este comando seguirá aplicándose al área 4D Write hasta que esta area se borre. Las opciones que se suelen guardar con los documentos 4D Write (como la orientación) también se guardan.
Los parámetros de impresión actuales de 4D y de otras áreas 4D Write no se modifican.
El parámetro opcion permite especificar la opción a modificar. Puede pasar un valor o una de las siguientes constantes predefinidas, del tema "WR Opciones de impresión".
Pase el nuevo valor de la opcion especificada en los parámetros valor1 y (opcionalmente) valor2 y valor3. El número y la naturaleza de los valores a pasar dependen del tipo de opción especificado.
Algunos valores pueden haber sido definidos a través de constantes, que se encuentran en el tema WR Parámetros. Para mayor información sobre las opciones y sus valores, consulte la siguiente tabla:
Constante opción (Valor) | valor1 | valor2 | valor3 |
wr paper option (1) | Alto | Ancho | - |
| 0 | 0 | Nombre |
wr orientation option (2) | wr portrait (1), wr landscape (2) | - | - |
wr scale option (3) | Número(%) | - | - |
wr number of copies option (4) | Número | - | - |
wr paper source option (5) | Windows únicamente: |
| Index (Número) | - | - |
wr pages from option (6) | Número(1=por defecto) | - | - |
wr pages to option (7) | Número(1=por defecto, fin del documento) | - | - |
wr color option (8) | wr black and white (1), wr color (2) | - | - |
wr destination option (9) | wr send to printer (1), | 0 | - |
| wr send to file (2), | 0 | Ruta de acceso |
| wr send to PDF file (3) | 0 | Ruta de acceso |
wr double sided option (11) | Windows únicamente: |
| wr single sided (0) (estándar) | - | - |
| wr double sided (1) | wr left binding (0) | - |
| (por defecto), wr top binding |
wr spooler document name option (12) | 0 | 0 | Nombre del documento |
- wr paper option (1): la lista de todos los nombres de papeles disponibles se puede obtener utilizando el comando PRINT OPTION VALUES.
Puede pasar el nombre del papel en valor3 (y en este caso pase 0 en valor1 y valor2), o pase el alto del papel en valor1 y su ancho en valor2. El ancho y el alto deben expresarse en píxeles. - wr orientation option (2): puede pasar la constante wr portrait (1) o wr landscape (2) en valor1.
- wr scale option (3): pase un porcentaje en valor1. Tenga cuidado, algunas impresoras no permiten modificar la escala. Si pasa un valor no válido, la propiedad se restablece al 100% en el momento de la impresión.
- wr number of copies option (4): pase el número de copias a imprimir en valor1.
- wr paper source option (5): en valor1, pase el valor del elemento info1Array que corresponde al elemento de arrayNombres devuelto por el comando PRINT OPTION VALUES. Este array contiene el nombre de la bandeja de papel a utilizar.
Nota: esta opción sólo se puede utilizar en Windows. - wr pages from option (6): pase el número de la página donde desea empezar a imprimir en valor1. El valor por defecto es 1.
- wr pages to option (7): pase el número de la última página a imprimir en valor1. Si pasa -1, todo el documento se imprimirá (-1 es equivalente a pasar la última página del documento).
- wr color option (8): en valor1, pase la constante wr black and white (1) (monocromo) o wr color (2).
Nota: esta opción sólo se puede utilizar en Windows. - wr destination option (9): en valor1, pase una de las siguientes constantes: wr send to printer (1), wr send to file (2) (archivo para PC, PS para Mac) o wr send to file (3) (sólo Mac OS).
Siempre pase 0 en valor2.
Si valor1 es diferente de 1, pase la ruta de acceso para el documento resultante en valor3. Esta ruta se utilizará hasta que otra ruta se especifique. Si un archivo con el mismo nombre ya existe en el lugar de destino, se reemplazará. Bajo Windows únicamente: si pasa una cadena vacía en valor3 u omite este parámetro, aparece un diálogo de guardar archivo en el momento de la impresión. Si la operación falla, el parámetro impresora (1) se aplica. - wr double sided option (11): puede pasar la constante wr single sided (0) (estándar) o wr double sided (1) en valor1. Si valor1 vale 1, puede definir que tipo de encuadernación aplicar utilizando valor2: constante wr left binding (0, valor por defecto) o wr top binding (1)
Nota: esta opción sólo se puede utilizar en Windows. - wr spooler document name option (12): en valor3, pase el nombre del documento de impresión que debe aparecer en la lista de los documentos del servidor de impresión. Pase 0 en valor1 y valor2.
Para utilizar o restablecer el funcionamiento normal (usando el nombre del método en el caso de un método, el nombre de la tabla para un registro, etc.), pase una cadena vacía en valor3.
Atención: el nombre definido por esta instrucción se utilizará para todos los documentos de impresión de la sesión siempre que no se pase un nuevo nombre o una cadena vacía.
Si el valor pasado para opcion no es válido o si no está disponible en la impresora, el comando devuelve un error (que puede interceptar utilizando un método de gestión de errores instalado por el comando WR ON ERROR) y el valor actual de la opción se mantiene sin cambios.
La variable sistema OK toma el valor 1 si el comando se ha ejecutado correctamente, de lo contrario, toma el valor 0.