PRINT SELECTION
PRINT SELECTION ( {tabela}{;}{* | > } )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| tabela | Table | → | Tabela para a qual imprimir a seleção, ou Tabela por padrão, se for omitido |
| * | > | Operador | → | * para apagar as caixas de diálogo de impressão, ou > para não reiniciar as preferências de impressão |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
PRINT SELECTION imprime a seleção atual de tabela. Os registros se imprimem no formulário de salida atual da tabela do processo atual. PRINT SELECTION realiza a mesma ação que o comando Imprimir do ambiente Usuário. Se a seleção está vazia, PRINT SELECTION não faz nada.
Por padrão, PRINT SELECTION mostra as caixas de diálogo de impressão (na versão 32-bits) ou a caixa de diálogo de Formato de Impressão (na versão 4D 64-bits), antes de imprimir. Se o usuário cancelar uma das caixas de diálogo de impressão, o comando se cancela e o relatório não se imprime. Pode eliminar estas caixas de diálogo utilizando o parâmetro opcional asterisco (*) ou o parâmetro opcional “maior que” (>):
• O parâmetro * provoca um trabalho de impressão utilizando os parâmetros de impressão atuais (parâmetros por padrão ou aqueles definidos pelos comandos _o_PAGE SETUP ou SET PRINT OPTION).
• Além disso, o parâmetro > provoca um trabalho de impressão sem reiniciar os parâmetros de impressão atuais. Este parâmetro é útil para executar várias chamadas sucessivas a PRINT SELECTION (por exemplo ao interior de um loop) conservando os parâmetros de impressão personalizados previamente definidos. Para ver um exemplo de utilização deste parâmetro, consulte a descrição do comando PRINT RECORD.
Durante a impressão, o método de formulário de saída e os métodos de objeto do formulário se executam em função dos eventos selecionados nas propriedades dos formulários e dos objetos, no ambiente Desenho, assim como dos eventos gerados efetivamente:
* Um evento On Header é gerado logo antes que a área de cabeçalho se imprima.
* Um evento On Printing Detail é gerado logo antes que um registro se imprima.
* Um evento On Printing Break é gerado logo antes que uma área de quebra se imprima.
* Um evento On Printing Footer é gerado logo antes que um pé de página se imprima.
Pode saber se PRINT SELECTION está imprimindo o primeiro cabeçalho provando Before selection durante um evento On Header. Igualmente pode verificar o último pé de página, provando End selection durante um evento On Printing Footer. Para maior informação, consulte a descrição destes comandos, como também dos comandos Form event code e Level .
Para imprimir uma seleção ordenada com subtotais ou quebras utilizando PRINT SELECTION, deve primeiro ordenar a seleção. Depois, em cada área de quebra do relatório, incluir uma variável com um método de objeto que atribui o subtotal à variável . Igualmente pode utilizar funções estatísticas e aritméticas como Sum e Average para atribuir valores às variáveis. Para maior informação, consulte as descrições de Subtotal, BREAK LEVEL e ACCUMULATE.
Aviso: Não use PAGE BREAK com o comando PRINT SELECTION. PAGE BREAK é usada com o comando Print form.
Depois de um chamado a PRINT SELECTION, a variável OK toma o valor 1 se a impressão for completada. Se a impressão foi interrompida, a variável OK toma o valor 0 (zero) (por exemplo se o usuário clicar em Cancelar nas caixas de diálogo de impressão).
4D Server: este comando pode ser executado em 4D Server no marco de um procedimento armazenado. Neste contexto:
* Tenha certeza que nenhuma caixa de diálogo apareça na máquina servidor (exceto para uma necessidade específica). Para fazer isto, é necessário chamar ao comando com o parâmetro * o >.
* Em caso de um problema com a impressora (sem papel, impressora desconectada, etc.), não é gerada mensagem de erro.
Exemplo
O exemplo a seguir seleciona todos os registros na tabela [Pessoas]. O comando DISPLAY SELECTION é então chamado para mostrar os registros e permitir ao usuário selecionar os registros a imprimir. Finalmente, utiliza os registros selecionados com o comando USE SET, e os imprime com PRINT SELECTION:
ALL RECORDS([Pessoas]) // Seleção de todos os registros
DISPLAY SELECTION([Pessoas];*) // Visualização dos registros
USE SET("UserSet") // Utilizar unicamente os registros selecionados pelo usuário
PRINT SELECTION([Pessoas]) // Imprimir os registros selecionados pelo usuário
Ver também
_o_PAGE SETUP
ACCUMULATE
BREAK LEVEL
Level
Subtotal