GET PRINT OPTION
GET PRINT OPTION ( opção ; valor1 {; valor2} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| opção | Integer | → | Número de opção ou código de opção PDF |
| valor1 | Integer, Text | ← | Valor 1 da opção |
| valor2 | Integer, Text | ← | Valor 2 da opção |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
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 | (Windows apenas) valor1 unicamente: número correspondente ao índice, no array de bandejas devolvido pelo comando PRINT OPTION VALUES, da bandeja de papel a utilizar. Esta opção só se pode utilizar em Windows. |
| 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 | 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. |
| 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 |
| Print preview option | Inteiro longo | 18 | (sólo Windows) valor1: formato a utilizar para as vistas previas de impressão em Windows. Valores disponíveis: kp preview automatic (por padrão): utiliza a impressora e o visor XPS se estiverem disponíveis, em caso contrário utiliza a impressora e o visor PDF se disponíveis, caso contrário gera um erro. kp preview XPS: utiliza a impressora e o visor XPS se disponíveis, caso contrário gera um erro. kp preview PDF: utiliza a impressora e o visor PDF se disponíveis, do contrário se gera um erro valor2 (só pode ser utilizado com GET PRINT OPTION): formato de vista prévia de impressão utilizado realmente em Windows (pode diferir do valor1 dependendo da configuração). Valores disponíveis: kp preview none: nenhum formato disponível. kp preview XPS: impressora e visor XPS utilizados. kp preview PDF: impressora e visor PDF utilizados. |
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