PrintForm componente (Visual Basic)
The PrintForm componente para Visual Basic 2008 permite que você imprimir uma imagem de um formulário do Windows em time de execução. Substitui o comportamento que o PrintForm método nas versões anteriores do Visual Basic.
Visão geral do PrintForm componente
Um cenário comum para o Windows Forms é criar um formulário é formatado para se parecer com um formulário de papel ou um relatório e, em seguida, imprimir uma imagem do formulário.Embora você possa usar um PrintDocument componente para fazer isso, seria necessário muito código. The PrintForm componente permite que você imprimir uma imagem de um formulário para uma impressora, uma janela de visualização de impressão ou um arquivo sem usar um PrintDocument componente.
The PrintForm componente está localizado na Visual Basic PowerPacks Guia de do Caixa de ferramentas.Quando é arrastado para um formulário que ele aparece na bandeja de componentes, a pequena área sob a borda inferior do formulário.Quando o componente for selecionado, propriedades que definem o comportamento podem ser conjunto no Propriedades janela.Todas essas propriedades também podem ser conjunto no código.Você também pode criar uma instância do PrintForm componente em código sem adicionar o componente em time de design.
Quando você imprime um formulário, todos os itens da área de cliente do formulário é impresso.Isso inclui todos os controles e qualquer texto ou elementos gráficos desenhados no formulário pelo métodos gráficos.Por do padrão, o formulário BAR de título, as BARs de rolar e da borda não são impressos.Também por padrão, a PrintForm componente imprime apenas a parte visível do formulário. Por exemplo, se o usuário redimensiona o formulário em time de execução, os controles e elementos gráficos que são visíveis no momento serão impressas.
A impressora padrão usada pelo PrintForm componente é determinado pelas configurações de painel de controle do sistema operacional.
Após a impressão é iniciada, um padrão PrintDocument caixa de diálogo de impressão é exibida. Esta caixa de diálogo permite que os usuários cancelar o trabalho de impressão.
chave Métodos, propriedades e eventos
O chave método do PrintForm componente é o Print método, que imprime uma imagem do formulário para uma impressora, uma janela de visualização de impressão ou um arquivo. Há duas versões do Print método:
Uma versão básica sem parâmetros: Print()
Uma versão sobrecarregada com parâmetros que especificam o comportamento de impressão: Print(printForm As Form, printFormOption As PrintOption)
The PrintOption parâmetro do método sobrecarregado determina a implementação subjacente usada para imprimir o formulário, se a BAR de título do formulário, barras de rolar e borda são impressos e se rolável partes do formulário serão impressas.
The PrintAction propriedade é uma propriedade de chave a PrintForm componente. Esta propriedade determina se a saída é enviada para uma impressora, exibida em uma janela de visualização de impressão ou salva sistema autônomo um arquivo EPS.Se o PrintAction propriedade estiver definida como PrintToFile, o PrintFileName propriedade especifica o nome de arquivo e caminho.
The PrinterSettings propriedade fornece acesso a uma base PrinterSettings objeto que permite que você especifique essas configurações sistema autônomo a impressora para uso e o número de cópias a serem impressas. Você também pode consultar sistema autônomo capacidades da impressora, sistema autônomo a cor ou o suporte duplex.Esta propriedade não aparece no Propriedades janela; ela pode ser acessada somente de código.
The Form propriedade é usada para especificar o formulário para imprimir quando você chamar o PrintForm componente por meio de programação. Se o componente for adicionado a um formulário em time de design, o formulário é o padrão.
Principais eventos para o PrintForm componente incluem o seguinte:
Evento BeginPrint.Ocorre quando o Print método é chamado e antes da primeira página do imprime documento.
Evento EndPrint.Ocorre após a última página ser impressa.
Evento QueryPageSettings.Ocorre imediatamente antes de cada página é impressa.
Comentários
Se um formulário contiver texto ou elemento gráfico desenhado pelo Graphics métodos, usar básico Print (Print()) método imprimi-lo. Elementos gráficos não podem processar em alguns sistemas operacionais quando o sobrecarregado Print método é usado.
Se a largura de um formulário for maior do que a largura do papel na impressora, do lado direito da forma podem ser cortado.Ao criar formulários para impressão, certifique-se de que o formulário se encaixa no papel de tamanho padrão.
Exemplo
O exemplo a seguir mostra um uso comum do PrintForm componente.
' Visual Basic.
Dim pf As New PrintForm
pf.Form = Me
pf.PrintAction = PrintToPrinter
pf.Print()
Consulte também
Tarefas
Como: Imprimir um formulário usando o componente PrintForm (Visual Basic)
Como: Imprimir a área de cliente de um formulário (Visual Basic)
Como: Imprimir Client e áreas de cliente não de um formulário (Visual Basic)
Como: Imprimir um formulário de rolagem (Visual Basic)