GET PRINT OPTION

4D v15.4

GET PRINT OPTION


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

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

Descrição

O comando GET PRINT OPTION devolve os valores atuais de uma opção de impressão.

O parâmetro opção lhe permite especificar a opção a obter. Pode passar uma das seguintes constantes pré-definidas, localizadas no tema “Opções de Impressão” (inteiro longo) ou um código de opção PDF (string).

As constantes de opção são as seguintes:

Constante	Tipo	Valor	Comentário
Paper option	Inteiro longo	1	Se usar apenas valor1, contém o nome do papel. SE usar ambos parâmetros, value1 contém a largura do papel e valor2 contém a altura do papel. A largura e altura são expressas em píxels. Use o comando PRINT OPTION VALUES para obter o nome, altura e largura de todos os formatos de papel oferecidos pela impressora.
Orientation option	Inteiro longo	2	valor1 apenas: 1=Retrato, 2=Paisagem. Se uma opção de orientação diferente for usada, GET PRINT OPTION retorna 0 em valor1. Versões 64-bit: Esta opção pode ser chamada dentro de um trabalho de impressão, que significa que pode trocar de retrato a paisagem, ou vice versa, durante o mesmo trabalho de impressão.
Scale option	Inteiro longo	3	valor1 apenas: valor escalar em porcentagem. Tome cuidado, algumas impressoras não permitem que essa escala seja modificada. Se passar um valor inválido, a propriedade é resetada para 100% ao começar a impressão.
Number of copies option	Inteiro longo	4	valor1 apenas: número de cópias a imprimir.
Paper source option	Inteiro longo	5
Color option	Inteiro longo	8	(Só em Windows) valor1 apenas: código especificando o modo para manejar cor: 1=Branco e preto (monocromático) , 2=Cor. versões 64-bit: Esta opção não é compatível com versões 4D 64-bit (obsoleto)
Destination option	Inteiro longo	9	valo1: código especificando o tipo de destino de impressão: 1=Printer, 2=(PC)/PS File (Mac), 3=PDF file, 5=Screen (opção OS X driver). Se valor1 for diferente de 1 ou 5, valor2 contém rota de caminho para o documento resultante. Esta rota será usada até que outra rota seja especificada. Se um arquivo com o mesmo nome já existir no local destino, será substituído. Com GET PRINT OPTION, se o valor atual não estiver na lista pré-definida, valor1 contém -1 e a variável de sistema OK é marcada como 1. Se um erro ocorrer, valor1 eda variável sistema OK é estabelecida como 0. Nota: Em Windows, pode estabelecer o destino de impressão para 3 (PDF File) quando o driver PDF Creator tiver sido instalado. Quando os valores (9;3;path) são passados, 4D automaticamente inicia uma impressão PDF "silenciosa" que leva em consideração qualquer opção de código que são passadas (note que se passar uma string vazia em valor2 ou omitir este parâmetro, um diálogo de salvar arquivo aparece quando imprimir. Depois da impressão, as configurações atuais são restauradas. Isso simplifica controle de impressão de PDF para 4D e permite que crie código multiplataforma. Quando os valores (9;3;path) não são passados, impressão não é controlada por 4D e qualquer código de opção PDF Creator que forem passados são ignorados.
Double sided option	Inteiro longo	11	(Windows apenas) value1: 0=Single-sided or standard, 1=Double-sided. Se value1=1, value2 contém a binding: 0=Left binding (padrão), 1=Top binding. Nota: Esta opção pode somente ser usada em Windows.
Spooler document name option	Inteiro longo	12	valor1 unicamente: nome do documento de impressão atual, que aparece na lista de documentos da fila de impressão. O nome definido para esta instrução será utilizada para todos os documentos de impressão da sessão até que um novo nome ou uma string vazia não seja passada. Para utilizar ou reestabelecer o funcionamento normal (usando o nome de método no caso de um método, o nome da tabela para um registro, etc.), passe uma string vazia em valor1.
Mac spool file format option	Inteiro longo	13	(apenas em Mac) valor1 apenas: 0=trabalho de impressão em modo PDF (valor padrão) 1=trabalho de impressão em modo PostScript. Notas: - Esta opção não tem efeito em Windows. - Em OS X, a impressão é feita como um PDF de maneira padrão. Entretanto o driver de impressão PDF não é compatível com imagens PICT com informação PostScript encapsulada — estas imagens são geradas, mais especificamente, por software de desenho vetorial. Para evitar este problema, esta opção permite que modifique o modo de impressão para usar OS X para a sessão atual. Lembre que impressão em modo PostScript pode levar a efeitos colaterais indesejados. Versões 64-bit: Esta opção não é compatível foi substituida pela opção Generic PDF driver do comando SET CURRENT PRINTER
Hide printing progress option	Inteiro longo	14	valor1 unicamente: 1=ocultar janelas de progresso, 0= mostrar as janelas de progresso de impressão (como padrão). Esta é uma opção particularmente útil no caso de impressão PDF em OS X. Nota: já existe uma opção de progresso de impressão acessível vía o quadro de diálogo Propriedades do banco de dados (página Interface). Entretanto, se aplica globalmente a aplicação e nãooculta todas as janelas em OS X.

Um código de opção PDF consta de duas partes, TipoOpção e NomeOpção, combinadas como "TipoOpção:NomeOpção".

O comando devolve nos parâmetros valor1 e (opcionalmente) valor2, os valores atuais da opção especificada. Para maior informação sobre opções, códigos de opção PDF e valores possíveis, consulte a descrição do comando SET PRINT OPTION.

Considere as seguintes características específicas do comando GET PRINT OPTION:

opcion = 1 (paper option): devolve o nome do papel atual em valor1 se valor2 for omitido. Se for passado valor2, o comando devolve, respectivamente, a largura e a altura do papel em valor1 e valor2. Utilize o comando PRINT OPTION VALUES para obter o nome, a altura e a largura de todos os formatos de papel oferecidos pela impressora.

opcion = 2 (orientation option): devolve 1 (Vertical) ou 2 (Horizontal). Se for utilizada uma opção de orientação diferente, valor1 toma o valor 0.

opcion = 5 (paper source option): em valor1, devolve o índice (no array de bandejas devolvidas pelo comando PRINT OPTION VALUES) da bandeja de papel utilizada (valor2 deve ser omitido).
Nota: esta opção só pode ser utilizada em Windows.

option = 8 (color option): devolve um código em valor1 especificando o modo de administração da cor: 1=preto e branco (monocromo), 2=Cor.
Nota: esta opção só pode ser utilizada em Windows.

opcion = 9 (destination option): se o valor atual não estiver na lista pré-definida, valor1 contém -1 e a variável sistema OK toma o valor 1. Se ocorre um erro, valor1 e a variável sistema OK tomam o valor 0. Se valor1 contiver um valor pré-definido diferente de 1 ou 5, valor2 contém a rota de acesso do arquivo impresso.

opcion = 11 (double sided option): devolve 0 (padrão ou um só lado, valor por padrão) ou 1 (pelos dois lados) em valor1. Se valor1 for igual a 1, valor2 pode devolver um dos seguintes valores: 0=encadernação esquerda (por padrão), 1=Encadernação superior.
Nota: esta opção só pode ser utilizada em Windows.

opcion = 12 (spooler document name option): devolve o nome do documento de impressão atual em valor1, se tiver sido definido préviamente. Do contrário, devolve uma string vazia.

Nota: o comando GET PRINT OPTION só funciona com impressoras PostScript. É possível utilizar este comando com outros tipos de impressoras, tais como PCL ou tinta, mas neste caso, é possível que algumas opções não estão disponíveis.

Variáveis e conjuntos do sistema

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

Ver também

PRINT OPTION VALUES
SET PRINT OPTION