4D Doc Center : SET PRINT OPTION

4D v14.3

SET PRINT OPTION


SET PRINT OPTION ( opção ; valor1 {; valor2} )

Parâmetro	Tipo	Descrição
opção	Inteiro longo, cadeia	Número da opção ou Código da opção de PDF
valor1	Inteiro longo, cadeia	valor 1 da opção
valor2	Inteiro longo, cadeia	Valor 2 da opção

Descrição

O comando SET PRINT OPTION se utiliza para modificar por programação o valor de una opção de impressão..

Cada opção definida utilizando este comando se aplica a toda la base e durante toda a sessão sempre que no se chame outro comando que modifique os parâmetros de impressão (PRINT SETTINGS, PRINT SELECTION sem o parâmetro > parâmetro, etc.).

O parâmetro opção lhe permite indicar la opção a modificar. Pode passar uma das constantes predefinidas do tema “Opções de Impressão”, ou um código de opção PDF (utilizável com o driver PDFCreator em Windows unicamente).

Passe nos parâmetros valor1 e valor2 (opcionalmente) os novos valores da opção especificada. O número e natureza dos valores passados depende do tipo de opção especificada.

Usar um número de opção (constante)

A seguinte tabela lista as opções e sus possíveis valores:

Opção (constante)	valor1	valor2
1 (Paper option)	Nome	-
	Largura	Alto
2 (Orientation option)	1=Vertical, 2=Horizontal	-
3 (Scale option)	Número (%)	-
4 (Number of copies option)	Número	-
5 (Paper source option)	Windows unicamente:
	Índice (número)	-
8 (Color option)	Windows unicamente:
	1=N/B, 2=Color	-
9 (Destination option)	1=Impressora,	-
	2=Arquivo (PC)/PS (Mac),	Rota de acesso
	3=Arquivo PDF,	Rota de acesso
	5=Tela (Mac)	-
11 (Double sided option)	Windows unicamente:
	0=Single-sided (padrão)	-
	1=Double-sided	Binding: 0=esquerda, 1=Arriba
12 (Spooler document name option)	Nome do documento a imprimir	-
13 (Mac spool file format option)	0=modo PDF, 1= modo PostScript	-
14 (Hide printing progress option)	0=Mostrar (por padrão), 1=Ocultar	-

Paper option (1): a lista de todos os nomes de papéis disponíveis podem ser obtidos utilizando o comando PRINT OPTION VALUES
Pode passar o nome do papel em valor1 (e, em este caso, omitir valor2), ou passar a largura do papel em valor1 e sua largura em valor2. A altura e largura deve ser expressa em píxels de tela.
Orientation option (2): pode passar 1 (Portrait), ou 2 (Landscape) em valor1.
Scale option (3): passe uma porcentagem em valor1. Atenção, algumas impressoras não permitem modificar a escala. Se passa um valor inválido, a propriedade se reajusta a 100% no momento da impressão..
Number of copies option (4): passe o número de cópias a imprimir em valor1.
Paper source option (5): passe o número correspondente ao índice, no array de bandejas devolvido pelo comando PRINT OPTION VALUES, da bandeja de papel a utilizar.
Nota: esta opção só pode ser utilizado em Windows.
Color option (8): em valor1, passe o código especificando o modo para administrar a cor: 1=Preto e branco (monocromático), 2=Cor.
Nota: esta opção só pode ser utilizado em Windows.
Destination option (9): em valor1, passe o código especificando o tipo de destino de impressão: 1=Impressora, 2=Arquivo (PC)/PS (Mac), 3=PDF Arquivo , 5=Tela (opção de driver Mac OS X).
Se valor1 é diferente de 1 ou 5, passe em valor2 a rota de acesso para o documento resultante. Esta rota será utilizada hasta que outra rota seja especificada. Se já existir um arquivo com o mesmo nome na localização de destino, será substituída.
Nota: em Windows, pode definir o destino da impressão em 3 (Arquivo PDF) quando o driver PDF Creator for instalado a partir da versão 12 de 4D. Este parâmetro é obrigatório para que 4D poda controlar a impressão vía PDF Creator em Windows. Quando se passam os valores (9;3;rota), 4D lança automaticamente una impressão PDF "silenciosa" e considera os códigos de opções passados eventualmente (note que se passar uma string vazia em valor2 ou omite este parâmetro, aparece uma caixa de diálogo de guardar arquivo no momento da impressão. Depois da impressão, os parâmetros atuais se restauram. Isto simplifica o controle das impressões PDF por 4D e permite escrever código multi-plataforma.
Se não são passados os valores (9;3;rota), a impressão não é controlada por 4D e os possíveis códigos de opções de PDF Creator são ignorados.
Double sided option (11): pode passar 0 (Single-sided o standard), ou 1 (Double-sided) em valor1. Se valor1 for igual a 1, pode definir a referencia a aplicar utilizando valor2: 0=Left binding (valor por padrão), 1=Top binding.
Nota: esta opção só pode ser utilizada em Windows.
Spooler document name option (12): passe em valor1, o nome do documento de impressão que deve aparecer em a lista de documentos do spooler.
Para utilizar ou substituir a operação padrão (utilizando o nome do método no caso de um método, o nome de a tabela para um registro, etc.), passe una string vazia em valor1.
Advertência: o nome definido por esta instrução será utilizado para todos os documentos de impressão de a sessão enquanto não se passe um novo nome o una string vazia.
Mac spool file format option (13): em valor1, passe 0 para fixar o trabalho de impressão em modo PDF (valor por padrão) e 1 para “forçar” o trabalho de impressão em modo PostScript. Esta opção não tem efeito em Windows.
Nota: em Mac OS X, a impressão se realizar por padrão como um PDF. Entretanto, o driver de impressão PDF não é compatível com imagens PICT encapsuladas com informação PostScript, estas imagens são geradas, mais particularmente, por software de desenho vetorial.
Para evitar este problema, esta opção lhe permite modificar o modo de impressão em Mac OS X para a sessão atual. Recorde que a impressão em modo PostScript pode trazer efeitos indesejáveis.
Hide printing progress option (14): passe 1 em valor1 para ocultar as janelas de progresso e 0 para mostrá-la novamente (operação por padrão). Esta opção é particularmente útil no caso de impressão PDF em Mac OS X.
Nota: já existe uma opção de progresso de impressão que se encontra na caixa de diálogo de Propriedades de la base (Página Interface). Entretanto, se aplica globalmente à aplicação e não oculta todas as janelas em Mac OS X.

Quando tiver fixado utilizando este comando, uma opção de impressão se conservará durante toda a sessão para toda a aplicação 4D. Será utilizada por os comandos PRINT SELECTION, PRINT RECORD, Print form e QR REPORT, como também pela impressão de 4D, incluindo em modo Desenho.

Notas:

É indispensável utilizar o parâmetro opcional > com os comandos PRINT SELECTION, PRINT RECORD e PAGE BREAK para evitar reinicializar as opções de impressão que foram definidas utilizando o comando SET PRINT OPTION.
O comando SET PRINT OPTION só opera com impressoras PostScript.

Usar um código de opção de PDF (Windows)

Para poder utilizar um código de opção PDF no parâmetro opção, deve haber instalado o driver PDFCreator em seu entorno 4D (para mayor informação, consulte a secção Integração do driver PDFCreator em Windows).
Além disso, para que o código de opção seja levado em consideração, deve ter ativado o driver de impressão PDF para 4D através da seguinte instrução:

SET PRINT OPTION(Destination option;3;nomArquivo)

Do contrário, os códigos de opção são ignorados.

Um código de opção PDF é um valor de tipo texto que consta de duas partes, TipoOpção e NomeOpção, combinados como "TipoOpção:NomeOpção". Esta é a descrição deste código:

TipoOpção indica si usted especifica una opção nativa de PDFCreator ou uma opção de administração PDF de 4D. São aceitos dois valores:
- PDFOptions = opção nativa
- PDFInfo = opção interna.
NomeOpção especifica a opção a definir (dependendo do valor de TipoOpção).
- Se TipoOpção = PDFOptions, pode passar uma das numerosas opções nativas de PDFCreator. Por exemplo, a opção UseAutosave afeta o backup automático. Para poder modificar esta opção, passe "PDFOptions:UseAutosave" no parâmetro opção e o valor a utilizar no parâmetro valor1. Para uma descrição completa das opções nativas de PDFCreator, consulte a documentação do driver PDFCreator.
- Se TipoOpcion = PDFInfo, pode passar em NomeOpção um dos seguintes seletores específicos:

Nota: depois de cada impressão, 4D restabelece automaticamente os parâmetros anteriores do driver PDFCreator com o fim de evitar toda interferência com os outros programas que utilizam PDFCreator.

Exemplo

O método a seguir ativa o driver PDF de maneira a imprimir todos os registros da tabela na localização C:\Test_PDF_X onde X é o número de sequência do registro:

 SET CURRENT PRINTER(PDFCreator Printer Name)

  // Em Windows, selecione a impressora virtual instalada por PDFCreator

 If(OK=1) // Se PDFCreator está instalado</p><p>ALL RECORDS([Table_1])

    For($i;1;Records in selection([Table_1]))

       SET PRINT OPTION(Destination option;3;"C:\\Test\\Test_PDF_"+String($i))

  // A opção de destino 3 lança uma tarefa de impressão PDFCreator

       PRINT RECORD([Table_1];*)

       NEXT RECORD([Table_1])

    End for

  // Reinicialização das opções do driver PDFCreator

    SET PRINT OPTION("PDFInfo:Reset standard options";0)

 End if

Variáveis e conjuntos do sistema

A variável sistema OK toma o valor 1 se o comando for executado corretamente; do contrário, toma o valor 0.

Se passa um código de opção inválido (opção não reconhecida por PDFCreator por exemplo), OK toma o valor 0.

Gestão de erros

Se o valor passado por uma opção é incorreto ou se não estiver disponível na impressora, o comando devolve um erro (que pode interceptar utilizando um método de gestão de erros instalado pelo comando ON ERR CALL) e o valor atual da opção permanece sem mudanças.