Configuração de tamanho, escala e orientação

O método PrintJob.addPage() permite especificar a região de uma entidade gráfica que você deseja que seja impressa. O segundo parâmetro, printArea, está na forma de um objeto Rectangle. Há três opções para fornecer um valor para esse parâmetro:

• Crie um objeto Rectangle com propriedades específicas e, em seguida, use esse retângulo na chamada de addPage(), conforme no exemplo a seguir:

  private var rect1:Rectangle = new Rectangle(0, 0, 400, 200); 
  myPrintJob.addPage(sheet, rect1);

• Se você ainda não tiver especificado um objeto Rectangle, poderá fazer isso dentro da própria chamada, como no exemplo a seguir:

  myPrintJob.addPage(sheet, new Rectangle(0, 0, 100, 100));

• Se você planejar fornecer valores para o terceiro parâmetro na chamada de addPage(), mas não desejar especificar um retângulo, poderá usar null para o segundo parâmetro, como no exemplo a seguir:

  myPrintJob.addPage(sheet, null, options);

A largura e a altura do retângulo são valores em pixels. Uma impressora usa pontos como unidades de medida de impressão. Os pontos têm tamanho físico fixo (1/72 polegadas), mas o tamanho de um pixel na tela depende da resolução da tela específica. A taxa de conversão entre pixels e pontos depende das configurações da impressora e se a entidade gráfica está dimensionada. Um sprite não dimensionado, com 72 pixels de largura, terá uma polegada de largura na impressão, com um ponto igual a um pixel, independentemente da resolução da tela.

Você pode usar as equivalências a seguir para converter polegadas ou centímetros em twips (1/20 de um ponto) ou pontos:

• 1 ponto = 1/72 pol = 20 twips

• 1 pol = 72 pontos = 1440 twips

• 1 centímetro = 567 twips

Se você omitir o parâmetro printArea, ou se ele for passado incorretamente, a área total da entidade gráfica será impressa.

Para dimensionar um objeto Sprite antes de imprimi-lo, defina as propriedades da escala (consulte Manipulação do tamanho e dimensionamento de objetos) antes de chamar o método PrintJob.addPage() e defina-as novamente como seus valores originais após a impressão. A escala de um objeto Sprite não tem nenhuma relação com a propriedade printArea. Em outras palavras, se você especificar uma área de impressão de 50 x 50 pixels, serão impressos 2500 pixels. Se você dimensionar o objeto Sprite, serão impressos os mesmos 2500 pixels, mas o objeto Sprite será impresso no tamanho dimensionado.

Para obter um exemplo, consulte Exemplo de impressão: escala, corte e resposta.

Como o Flash Player e o AIR podem detectar as configurações de orientação, você pode criar lógica no ActionScript para ajustar o tamanho ou a rotação do conteúdo em resposta às configurações da impressora, conforme ilustrado no exemplo a seguir:

if (myPrintJob.orientation == PrintJobOrientation.LANDSCAPE) 
{ 
    mySprite.rotation = 90; 
}

import flash.printing.PrintJobOrientation;

Usando uma estratégia semelhante à manipulação das configurações de orientação da impressora, você pode ler as configurações de altura e largura da página e responder a elas incorporando alguma lógica em uma instrução if. O código a seguir mostra um exemplo:

if (mySprite.height > myPrintJob.pageHeight) 
{ 
    mySprite.scaleY = .75; 
}

Além disso, as configurações da margem de uma página podem ser determinadas comparando as dimensões da página e do papel, conforme ilustrado no exemplo a seguir:

margin_height = (myPrintJob.paperHeight - myPrintJob.pageHeight) / 2; 
margin_width = (myPrintJob.paperWidth - myPrintJob.pageWidth) / 2;