SET CURRENT PRINTER

4D v16.3

SET CURRENT PRINTER


SET CURRENT PRINTER ( nomImpr )

Parâmetro	Tipo	Descrição
nomImpr	String	Nome da impressora a ser usada

Descrição

O comando SET CURRENT PRINTER utiliza para designar a impressora a utilizar par imprimir com a aplicação 4D atual.

Passe o nome da impressora a selecionar no parâmetro nomImpr. Para obter una lista de impressoras disponíveis, utilize de antemão o novo comando PRINTERS LIST
Se passa uma string vazia em nomImpr, se utilizará a impressora atual definida no sistema.

O comando SET CURRENT PRINTER designa a impressora virtual instalada por o driver PDFCreator como destino de impressão. 4D usa o driver PDFCreator para facilitar a impressão de documentos PDF em Windows (ver Integração do driver PDFCreator em Windows). Para imprimir um documento PDF, no parâmetro nomImpr, passe o nome da impressora virtual instalada pelo driver PDFCreator. Por padrão, o nome da impressora virtual é "PDFCreator". Entretanto, este nome pode ter sido modificado quando se instalou o driver. Para que 4D busque e utilize automaticamente o nome da impressora virtual, inclusive se for personalizado, passe a constante PDFCreator Printer name em nomImpr. Esta constante se encontra no tema Opções de Impressão.

Constante	Tipo	Valor
PDFCreator Printer name	Cadeia	PDFCreator

    A partir de Windows 10:
    Windows 10 inclui um driver PDF de impressora nativo, que permite a 4D criar PDFs diretamente sem a necessidade de um driver externo como PDFCreator.
    O nome do driver é "Microsoft Print to PDF" (veja um exemplo na seção Integração do driver PDFCreator em Windows).

    Em OS X e a partir de Windows 10 (4D v15 R5 64-bit e superior):
    Uma constante encontrada no tema Opções de Impressão permite designar o PDF printer genérico automáticamente, independente da plataforma. Isso facilita a escrita de código genérico.

Constante	Tipo	Valor	Comentário
Generic PDF driver	Cadeia	_4d_pdf_printer	Nota: esta funcionalidade não está disponível nas versões 32 bits de 4D. Em OS X, declara o driver pré-determinado como impressora atual. Este driver não é visível e não está na lista devolvida pelo comando PRINTERS LIST. a rota de acesso ao documento PDF deve ser definida utilizando o comando SET PRINT OPTION, se não, se devolve o erro 3107. Em Windows, declara o driver PDF de Windows (chamado "Microsoft Print to PDF") como impressora atual. Esta constante está disponível em Windows 10 unicamente, quando está instalada a opção PDF. Com outras versões de Windows, ou quando não houver nenhum driver PDF disponível, o comando não faz nada e a variável OK toma o valor 0.

O comando SET CURRENT PRINTER deve ser chamado antes de SET PRINT OPTION, de maneira que as opções disponíveis correspondam à impressora selecionada. Por outra parte, SET CURRENT PRINTER deve ser chamada depois dePAGE SETUP, do contrário os parâmetros da impressora são perdidos.

Este comando pode ser utilizado com os comandosPRINT SELECTION, PRINT RECORD, Print form, e QR REPORT e se aplica a todas as impressões de 4D, incluso no ambiente Desenho.

Os comandos de impressão devem ser chamadas obrigatoriamente com o parâmetro > (onde seja relevante) de modo a que os parâmetros especificados não sejam perdidos.

Variáveis e conjuntos do sistema

Se a seleção de impressora é realizada corretamente, a variável sistema OK toma o valor 1. Se ocorre o contrário (por exemplo se não se encontra a impressora atribuída), a variável sistema OK toma o valor 0 e a impressora atual permanece sem mudanças.

Exemplo

Creiação de um documento PDF em Windows 10 com 4D Developer Edition 64-bit:

 C_TEXT($pdfpath)

 $pdfpath:=System folder(Desktop)+"test.pdf"

 SET CURRENT PRINTER(Generic PDF driver)

 SET PRINT OPTION(Destination option;2;$pdfpath)

 ALL RECORDS([Table_1])

 PRINT SELECTION([Table_1];*)

 SET CURRENT PRINTER("")

Ver também

Get current printer
PRINTERS LIST