Saltar para o conteúdo principal
Versão: Próximo

PRINTERS LIST

PRINTERS LIST ( arrayNoms {; altNomesArray {; modelosArray}} )

ParâmetroTipoDescrição
arrayNomsText arrayNomes das impressoras
altNomesArrayText arrayWindows: localização das impressoras; macOS: Nomes personalizados das impressoras
modelosArrayText arrayModelos de impressoras

Esse comando não é seguro para thread e não pode ser usado em código adequado.

Descrição

O comando PRINTERS LIST preenche os arrays passados como parâmetros com os nomes e opcionalmente com a localização os nomes personalizados e os modelos de impressão disponíveis para a máquina.

Nota: se as impressoras se manejam utilizando um servidor de impressão (spooler), se devolve a rota de acesso completa (em Windows) ou o nome do spooler (em Mac OS).

Passe no parâmetro nomesArray o nome de um array de texto. Depois da execução do comando, este array conterá os nomes das impressoras disponíveis. Em Mac OS, este será o “sistema” fixo de nomes.

Pode passar um segundo array opcional, altNomesArray. O conteúdo de este array dependerá da plataforma:

  • Em Windows, para cada impressora, você obtém sua localização em red (o porto local).
  • Em Mac OS, para cada impressora, você obtém seu nome personalizado, o qual pode se modificado pelo usuário. Este nome pode ser utilizado, por exemplo, em caixas de diálogos.

O parâmetro opcional modelosArray se utiliza para obter o modelo de cada impressora.

Utilize os comandos SET CURRENT PRINTER e Get current printer para modificar ou obter a impressora selecionada em 4D. Deve passar os nomes devolvidos no primeiro array (nomesArray).

Em Windows, o nome de una impressora pode ser modificado manualmente ao nível do sistema de operação. Por outro lado, sua localização e seu modelo estão associados a suas características físicas. Portanto, você pode utilizar os valores de array opcionais para verificar as características da impressora selecionada, geralmente, você pode verificar que todos as máquinas dos clientes utilizam a mesma impressora.

Em Mac OS, esta verificação pode ser realizada a cabo utilizando o nome da impressora (nome do servidor de impressão), que é o mesmo para cada máquina que estiver conectada.

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 e os arrays se devolvem vazios.

Ver também

Get current printer
SET CURRENT PRINTER