GET PRINT OPTION

4D v16.3

GET PRINT OPTION


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

Parâmetro	Tipo	Descrição
opção	Inteiro longo	Número de opção ou código de opção PDF
valor1	Inteiro longo, Texto	Valor 1 da opção
valor2	Inteiro longo, Texto	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 obter uma opção padrão (inteiro longo), ou um código de opção PDF (string). O comando devolve, nos parâmetros valor1 e (opcionalmente) valor2, o valor atual da opção especificada.

Para especificar uma opção de impresão padrão, pode utilizar uma das seguintes constantes predefinidas, que estão no tema “Opções de Impressão”:

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	(apenas em Mac) 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.
Page range option	Inteiro longo	15	valor1=primeira página a imprimir (valor padrão é 1) e (opcional) valor2=número da última página a imprimir (valor padrão -1 = fim do documento).
Legacy printing layer option	Inteiro longo	16	(4D versões 64-bit em Windows apenas) value1 apenas: 1=seleciona a capa de impressão legado baseada em GDI para os trabalhos de impressão subsequente. 0=seleciona a capa de impressão D2D (padrão). Versões 64-bit Este seletor é suportado apenas em aplicações 4D 64-bit monousuário em Windows; é ignorada em outras plataformas. Sua intenção é permitir a plugins legado que imprimam dentro de trabalhos 4D em aplicações4D 64-bit

Um código de opção PDF consta de duas partes, TipoOpção e NomreOpção, combinadas como "TipoOpção:NomeOpção". Para maior informação sobre códigos de opção PDF e valores possíveis, consulte a descrição do comando SET PRINT OPTION.

Nota: o comando GET PRINT OPTION principalmente é compatível com impressoras PostScript. Pode utilizar este comando com outros tipos de impressoras, como PCL ou tinta, mas neste caso, é possível que algumas opções não estejam 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