4D Write v14

WR SET PRINT OPTION

Página Inicial

 
4D Write v14
WR SET PRINT OPTION

WR SET PRINT OPTION 


 

WR SET PRINT OPTION ( area ; opçao ; valor1 ; valor2 ; valor3 ) 
Parâmetro Tipo   Descrição
area  Inteiro longo in Área 4D Write
opçao  Inteiro longo in Número de opção
valor1  Inteiro longo in Valor 1 da opção
valor2  Inteiro longo in Valor 2 da opção
valor3  cadeia in Valor 3 da opção

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:

Constante opção (Valor)valor1valor2valor3
wr paper option (1)AltoLargo-
00Nome
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 unicamente:
Index (Número)--
wr pages from option (6)Número(1=por padrão)--
wr pages to option (7)Número(1=por padrão, fim do 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 Via de acesso
wr send to PDF file (3)0Via de acesso
wr double sided option (11)Windows unicamente:
wr single sided (0) (estandarte)--
wr double sided (1)wr left binding (0) -
(por padrão), wr top binding
wr spooler document name option (12) 00Nome do documento
  • 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.

 
PROPRIEDADES 

Produto: 4D Write
Tema: WR Impressão
Número 89421

 
HISTÓRIA 

Criado por: 4D Write 2004

 
VER TAMBÉM 

WR GET PRINT OPTION

 
ARTICLE USAGE

4D Write - Linguagem ( 4D Write v11.6)
4D Write - Linguagem ( 4D Write v12)
4D Write - Linguagem ( 4D Write v14)
4D Write - Linguagem ( 4D v13)
4D Write - Linguagem ( 4D Write v14 R2)
4D Write - Linguagem ( 4D Write v14 R3)
4D Write - Linguagem ( 4D Write v14 R4)