Componente PrintForm (Visual Basic)
O PrintFormo componente para Visual Basic permite imprimir uma imagem de um formulário do Windows em tempo de execução. Substitui o seu comportamento da PrintForm método nas versões anteriores do Visual Basic.
Visão geral sobre o componente PrintForm
Um cenário comum para Windows Forms é criar um formulário que está formatado para se parecer com um formulário de papel ou um relatórioe, em seguida, para imprimir uma imagem do formulário. Embora você possa usar um PrintDocumento componente para fazer isso, ele exigiria muito código. O PrintForm componente permite que você imprimir uma imagem de um formulário a uma impressora, uma janelade visualização de impressão ou em um arquivo sem usar um PrintDocument componente.
O PrintForm componente está localizado na Visual Basic PowerPacks guia da caixa de ferramentas. Quando é arrastado para um formulário é exibido na bandeja do componente , a pequena área sob a borda inferior do formulário. Quando o componente for selecionado, as propriedades que definem o seu comportamento podem ser definidas no Propriedadesjanela. Todas essas propriedades também podem ser definidas no código. Você também pode criar uma instância da PrintFormo componente em código sem adicionar o componente em tempo de design.
Quando você imprime um formulário, tudo na área do cliente do formulário é impresso. Isso inclui todos os controles e qualquer texto ou elementos gráficos desenhados no formulário por métodos gráficos. Por padrão, barra de título, barras de rolagem e borda do formulárionão são impressos. Também por padrão, o PrintForm componente imprime apenas a parte visível do formulário. Por exemplo, se o usuário redimensiona o formulário em tempo de execução, somente os controles e elementos gráficos que são visíveis no momento serão impressas.
O padrão de impressora usada pelo PrintForm componente é determinado pelas configurações do 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.
Principais métodos, propriedades e eventos
Ométodo de chaveda PrintForm componente é o Print método, que imprime uma imagem do formulário para uma impressora, a janelade visualização de impressão ou o arquivo. Há duas versões do Print método:
Uma básica versão 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)
O PrintOption parâmetro do método sobrecarregado determina a implementação subjacente usada para imprimir o formulário, barra de título, barras de rolagem e borda do formuláriosão impressos e se rolável partes do formulário são impressas.
O PrintAction propriedade da</C2> PrintForm componente. Esta propriedade determina se a saída é enviada para uma impressora, exibida em uma janelade visualização de impressão ou salvo como um arquivo de PostScript encapsulado. Se a PrintAction propriedade estiver definida como PrintToFile, o PrintFileName propriedade Especifica o caminho e nome de arquivo.
O PrinterSettings propriedade fornece acesso a uma base PrinterSettingso objeto que permite que você especificar a impressora para uso e o número de cópias a serem impressas. Você pode também consulta os recursos da impressora, como, por exemplo, cor ou o suporte duplex. Esta propriedade não constar o Propriedadesjanela; ele pode ser acessado somente a partir do código.
O Form propriedade é usada para especificar o formulário para imprimir quando você chama o PrintForm componente por meio de programação. Se o componente é adicionado a um formulário em tempo 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 documento será impresso.
Evento EndPrint. Ocorre após a última página é impressa.
Evento QueryPageSettings. Ocorre imediatamente antes de cada página é impressa.
Comentários
Se um formulário contiver texto ou elementos gráficos desenhados pelo Graphics métodos, use o basic Print (Print()) o método para imprimi-lo. Elementos gráficos podem não ser renderizadas 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 do formulário poderá ser cortado. Quando você cria 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 cliente de um formulário (Visual Basic)
Como imprimir áreas cliente e não cliente de um formulário (Visual Basic)
Como imprimir um formulário rolável (Visual Basic)