WR SET PRINT OPTION

O comando SET WR PRINT OPTION se utiliza para modificar o valor de uma opção de impressão por programação para a área 4D Write designada pelo parâmetro area. Cada opção definida utilizando este comando seguirá sendo aplicada à área 4D Write até que esta area seja apagada. As opções que normalmente são guardadas com os documentos 4D Write (como a orientação) também é guardada.

Os parâmetros de impressão atuais de 4D e de outras áreas 4D Write não se modificam.

O parâmetro opçao permite especificar a opção a modificar. Pode passar um valor ou uma das seguintes constantes predefinidas, do tema "WR Print options".

Passe o novo valor da opçao especificada nos parâmetros valor1 e (opcionalmente) valor2 e valor3. O número e a natureza dos valores a passar dependem do tipo de opção especificado.

Alguns valores podem ter sido definidos através de constantes, que se encontram no tema WR Parameters. Para maior informação sobre as opções e seus valores, consulte a seguinte tabela:

• wr paper option (1): A lista de todos os nomes de papeis disponíveis podem ser obtidos utilizando o comando PRINT OPTION VALUES.
  Pode passar o nome do papel em valor3 (e neste caso passe 0 em valor1 e valor2), ou passe o alto do papel em valor1 e seu largo em valor2. O largo e o alto devem ser expressos em píxels.
• wr orientation option (2): pode passar a constante wr portrait (1) ou wr landscape (2) em valor1.
• wr scale option (3): passe um porcentagem em valor1. Tenham cuidado, algumas impressoras não permitem modificar a escala. Se passar um valor não válido, a propriedade se restabelece ao 100% no momento da impressão.
• wr number of copies option (4): passe o número de copias a imprimir em valor1.
• wr paper source option (5): em valor1, passe o valor do elemento info1Array que corresponde ao elemento de arrayNomes devolvido pelo comando PRINT OPTION VALUES. Este array contém o nome da bandeja de papel a utilizar.
  Nota: Esta opção só pode ser utilizada em Windows.
• wr pages from option (6): passe o número da página onde deseja começar a imprimir em valor1. O valor por padrão é 1.
• wr pages to option (7): passe o número da última página a imprimir em valor1. Se passar -1, todo o documento será impresso (-1 é equivalente a passar a última página do documento).
• wr color option (8) valor1: em , passe a constante wr black and white (1) (monocromo) ou wr color (2).
  Nota: Esta opção só pode ser utilizada em Windows.
• wr destination option (9): em valor1, passe uma das seguintes constantes: wr send to printer (1), wr send to file (2) (arquivo para PC, PS para Mac) ou wr send to file (3) (somente Mac OS).
  Sempre passe 0 em valor2.
  Se valor1 é diferente de 1, passe a via de acesso para o documento resultante em valor3. Esta via será utilizada até que outra via seja especificada. Se um arquivo com o mesmo nome já existe no lugar de destino, será substituído. Em Windows unicamente: se passar uma cadeia vazia em valor3 ou omite este parâmetro, aparece um diálogo de guardar arquivo no momento da impressão. Se a operação falha, o parâmetro impressora (1) se aplica.
• wr double sided option (11): pode passar a constante wr single sided (0) (padrão) ou wr double sided (1) em valor1. Se valor1 vale 1, pode definir que tipo de ligação aplicar utilizando valor2: constante wr left binding (0, valor por padrão) ou wr top binding (1)
  Nota: Esta opção só pode ser utilizada em Windows.
• wr spooler document name option (12): em valor3, passe o nome do documento de impressão que deve aparecer na lista dos documentos do servidor de impressão. Passe 0 em valor1 e valor2.
  Para utilizar ou restabelecer o funcionamento normal (usando o nome do método no caso de um método, o nome da tabela para um registro, etc.), passe uma cadeia vazia em valor3.
  Atenção: O nome definido por esta instrução será utilizado para todos os documentos de impressão da sessão sempre que não passe um novo nome ou uma cadeia vazia.

Se o valor passado para opçao não é válido ou não está disponível na impressora, o comando devolve um erro (que pode interceptar utilizando um método de gestão de erros instalado pelo comando WR ON ERROR) e o valor atual da opção se mantém sem mudanças.

A variável sistema OK toma o valor 1 se o comando foi executado corretamente, caso contrário, toma o valor 0.