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

Artigo
05/17/2015

Envia uma imagem de um formulário do Windows para o destino especificado o 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: 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 gráfico desenhado com Graphics métodos.

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

Dica

Quando o PrintOption parâmetro for definido como CompatibleModeClientAreaOnly ou CompatibleModeFullWindow, o formulário especificado pelo Form 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ê deseja incluir a barra de título, barras de rolagem e borda na imagem impressa, defina o PrintOption parâmetro como CompatibleModeFullWindow ou FullWindow.

Por padrão, somente a parte visível da área do cliente ou do formulário é impresso. Se um usuário tiver redimensionado o formulário em tempo de execução, ele será impresso como atualmente visíveis na tela. Se, no entanto, parte do formulário foi 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 o PrintOption parâmetro 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 é definido como CompatibleModeClientAreaOnly ou CompatibleModeFullWindow, uma implementação que é compatível com o Visual Basic 6.0 PrintForm método é usado. Quando esse parâmetro é definido como ClientAreaOnly, FullWindow ou Scrollable, uma implementação diferente que não exige que o formulário tem o foco é usada.

Dica

Em alguns sistemas operacionais, texto ou gráfico desenhado com Graphics métodos podem não ser exibidos corretamente.Além disso, se você definir o PrintOption parâmetro para ClientAreaOnly, FullWindow ou Scrollable, talvez você precise chamar o Refresh método do formulário imediatamente após chamar Print.Se você não chamar esse método, artefatos podem aparecer no formulário.

Exemplos

O exemplo a seguir imprime o formulário atual para a impressora padrão de sistema, imprimindo somente a área do cliente em seu tamanho atualmente exibido e usando o método não compatível 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ável.