4D Doc Center : Print object

4D v13.4

Print object


Print object ( {* ;} objeto {; posX {; posY {; largura {; alto}}}} ) -> Resultado

Parâmetro	Tipo	Descrição
*	Operador	Se especificado, objeto é um nome de objeto (string). Se omitido, objeto é uma variável
objeto	Objeto de formulário	Nome de objeto (se* for especificado) ou variável (se * é omitido)
posX	Inteiro longo	Localização horizontal do objeto
posY	Inteiro longo	Localização Vertical do objeto
largura	Inteiro longo	Largura do objeto (pixels)
alto	Inteiro longo	Altura do objeto (pixels)
Resultado	Booleano	Verdade = objeto impresso completamente; de outro modo False

Descrição

O comando Print object permite imprimir o objeto de formulário designado pelos parâmetros objeto e *, na localização definida pelos parâmetros posX e posY.

O comando Print object permite imprimir unicamente os objetos de formulários projeto. Antes de chamar a este comando, deve designar o formulário projeto que contenha os objetos a imprimir utilizando o comando OPEN PRINTING FORM.

Se passa o parâmetro opcional *, indica que o parâmetro objeto for um nome de objeto (string de caracteres). Se não passa o parâmetro *, está indicando que objeto é uma variável. Neste caso, se passa uma referência de variável (tipo de objeto unicamente) ao invés de uma string.

Os parâmetros posX e posY especificam o ponto de partida para a impressão dos objetos. Estes valores devem ser expressos em píxels. Se estes parâmetros se omitem, o objeto se imprime de acordo com sua localização no formulário.

Os parâmetros ancho e alto se utilizam para especificar a largura e a altura do objeto de formulário. O comando Print object não trata objetos de tamanho variável. Deve utilizar o comando OBJECT GET BEST SIZE para manejar o tamanho dos objetos. Também pode utilizar o comando OBJECT GET BEST SIZE para determinar o tamanho mais adequado para os objetos que contenham texto. Do mesmo modo, Print object não provoca saltos de página automáticos. Deve manejá-los de acordo a suas necessidades.

Pode utilizar os comandos de 4D para modificar rapidamente as propriedades do objeto (cor, tamanho, etc).

O comando devolve True se o objeto for impresso completamente e False se este não for o caso, em outras palavras, se não puder imprimir todos os dados associados com o objeto dentro do marco estabelecido. Normalmente, o comando devolve False quando se imprime um list box se todas as linhas do list box não pode ser impressa. Neste caso, basta com chamar ao comando Print object várias vezes até que devolva True: um mecanismo específico provoca de forma automática o deslocamento do conteúdo do objeto depois de cada chamada.

Notas:

na versão atual de 4D v12, só os objetos de tipo list box tem este mecanismo (o comando sempre devolve True para qualquer outro tipo de objeto). Nas próximas versões de 4D, este funcionamento se ampliará a outros objetos com conteúdos variáveis.
O comando LISTBOX GET PRINT INFORMATION permite controlar o estado da impressão durante a operação.

O comando Print object só pode ser utilizado no contexto de um trabalho de impressão aberto previamente com o comando OPEN PRINTING JOB. Se não se chama neste contexto, o comando não faz nada. Vários comandos Print object podem chamar-se no mesmo trabalho de impressão.

Nota: as listas hierárquicas, os subformulários e as áreas web não podem ser impressas.

Exemplo 1

Exemplo de impressão de dez objetos em um formulário:

 PRINT SETTINGS

 If(OK=1)

    OPEN PRINTING JOB

    If(OK=1)

       OPEN PRINTING FORM("PrintForm")

       x:=100

       y:=50

       GET PRINTABLE AREA(hpaper;wpaper)

       For($i;1;10)

          OBJECT GET BEST SIZE(*;"Obj"+String($i);bestwidth;bestheight)

          $end:=Print object(*;"Obj"+String($i))

          y:=y+bestheight+15

          If(y>hpaper)

             PAGE BREAK(>)

             y:=50

          End if

       End for

    End if

    CLOSE PRINTING JOB

 End if

Exemplo 2

Exemplo de impressão de um list box completo:

 Repeat

    $end:=Print object(*;"minhalistbox")

 Until($end)