Método PrintForm.Print (Form, PrintForm.PrintOption)

Artigo
10/26/2012

Envia uma imagem de um formulário do Windows para o destino especificado pelo PrintAction propriedade, especificando o formulário e opções de impressão

Namespace: Microsoft.VisualBasic.PowerPacks.Printing
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (em Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxe

'Declaração
Public Sub Print ( _
    form As Form, _
    printOption As PrintForm.PrintOption _
)

public void Print(
    Form form,
    PrintForm.PrintOption printOption
)

public:
void Print(
    Form^ form, 
    PrintForm::PrintOption printOption
)

member Print : 
        form:Form * 
        printOption:PrintForm.PrintOption -> unit

public function Print(
    form : Form, 
    printOption : PrintForm..::..PrintOption
)

Parâmetros

form
Tipo: System.Windows.Forms.Form

printOption
Tipo: Microsoft.VisualBasic.PowerPacks.Printing.PrintForm.PrintOption

Comentários

O Print método imprime todos os objetos visíveis em um formulário.Isso inclui qualquer texto ou elementos gráficos desenhados com Graphics métodos.

Se o formulário especificado na printForm parâmetro não tem o foco e o PrintOption parâmetro está definido de qualquer CompatibleModeClientAreaOnly ou CompatibleModeFullWindow, uma exceção é gerada.Se PrintOption for definido como ClientAreaOnly, FullWindow, ou Scrollable, qualquer formulário em seu aplicativo pode ser especificado, mesmo se ele não tem o foco.

Observação
Quando o PrintOption parâmetro está definido de qualquer CompatibleModeClientAreaOnly ou CompatibleModeFullWindow, o formulário especificado pelo Form a propriedade deve ter o foco.Se não estiver, uma exceção é gerada.Para evitar isso, chame o Focus método do formulário antes de chamar Print.

Por padrão, apenas a área do cliente do formulário é impresso.Se você quiser incluir a barra de título, as barras de rolagem e borda na imagem impressa, defina a PrintOption parâmetro a um CompatibleModeFullWindow ou FullWindow.

Por padrão, apenas a parte visível na área de cliente ou o formulário é impresso.Se um usuário tenha redimensionado o formulário em tempo de execução, ele será impresso como atualmente visível na tela.Se, no entanto, a parte do formulário tiver sido movido fora da borda da tela, o formulário ainda será impresso como se fosse completamente visível.

Se você deseja imprimir o formulário em seu tamanho projetado, defina a PrintOption parâmetro para Scrollable.

O Print método usa uma das duas implementações subjacentes para impressão.A implementação é determinada pelo PrintOption parâmetro.Quando esse parâmetro for definido como CompatibleModeClientAreaOnly ou CompatibleModeFullWindow, uma implementação que é compatível com o 6.0 Visual Basic PrintForm método é usado.Quando esse parâmetro for definido como ClientAreaOnly, FullWindow ou Scrollable, uma implementação diferente que não exige o formulário tenha o foco é usada.

Observação
Em alguns sistemas operacionais, texto ou elementos gráficos desenhados com Graphics métodos podem não ser exibidas corretamente.Além disso, se você definir a PrintOption parâmetro para ClientAreaOnly, FullWindow ou Scrollable, talvez você precise chamar o Refresh método do formulário imediatamente depois de chamar Print.Se você não chamar este método, os artefatos podem aparecer no formulário.

Em alguns sistemas operacionais, texto ou elementos gráficos desenhados com Graphics métodos podem não ser exibidas corretamente.Além disso, se você definir a PrintOption parâmetro para ClientAreaOnly, FullWindow ou Scrollable, talvez você precise chamar o Refresh método do formulário imediatamente depois de chamar Print.Se você não chamar este método, os artefatos podem aparecer no formulário.

Exemplos

O exemplo a seguir imprime o formulário atual para a impressora padrão de sistema, imprimindo apenas a área do cliente em seu tamanho exibido no momento e usando o método não-compatíveis de impressão.Este exemplo requer que você tenha um PrintForm componente denominado PrintForm1 em um formulário.

PrintForm1.PrintAction = Printing.PrintAction.PrintToPrinter
PrintForm1.Print(Me, ClientAreaOnly)
Me.Refresh

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.