4D Doc Center : GET PRINT OPTION

4D v13.4

GET PRINT OPTION


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

Parâmetro	Tipo	Descrição
opção	Inteiro longo, cadeia	Número de opção ou código de opção PDF
valor1	Inteiro longo, cadeia	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
Paper option	Inteiro longo	1
Orientation option	Inteiro longo	2
Scale option	Inteiro longo	3
Number of copies option	Inteiro longo	4
Paper source option	Inteiro longo	5
Color option	Inteiro longo	8
Destination option	Inteiro longo	9
Double sided option	Inteiro longo	11
Spooler document name option	Inteiro longo	12
Mac spool file format option	Inteiro longo	13
Hide printing progress option	Inteiro longo	14

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.

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