Imprimir utilizando a pré-visualização de impressão

É comum na programação do Windows Forms oferecer visualização de impressão, além de serviços de impressão. Uma maneira fácil de adicionar visualização de impressão à sua aplicação é usar um PrintPreviewDialog controlo em combinação com a lógica PrintPage de manipulação de eventos para imprimir um ficheiro.

Para visualizar um documento de texto com um controle PrintPreviewDialog

  1. No Visual Studio, use o painel Gerenciador de Soluções e clique duas vezes no formulário a partir do qual deseja imprimir. Isso abre o Visual Designer.

  2. No painel Caixa de Ferramentas , clique duas vezes no componente e no componente para adicioná-los ao formulário.

  3. Adicione um Button ao formulário ou use um botão que já esteja no formulário.

  4. No Visual Designer do formulário, selecione o botão. No painel de Propriedades , selecione o botão de filtro de eventos e, em seguida, clique duas vezes no evento Click para gerar um manipulador de eventos.

  5. O código de evento Click deve estar visível. Fora do escopo do manipulador de eventos, adicione duas variáveis de cadeia de caracteres privadas à classe chamada documentContents e stringToPrint:

    // Declare a string to hold the entire document contents.
private string documentContents="";

// Declare a variable to hold the portion of the document that
// is not printed.
private string stringToPrint="";

    ' Declare a string to hold the entire document contents.
Private documentContents As String
' Declare a variable to hold the portion of the document that
' is not printed.
Private stringToPrint As String

  6. De volta ao código do manipulador de eventos Click, defina a propriedade DocumentName para o documento que você deseja imprimir e abra e leia o conteúdo do documento para a cadeia de caracteres adicionada anteriormente.

    string docName = "testPage.txt";
string docPath = @"C:\";
string fullPath = System.IO.Path.Combine(docPath, docName);
printDocument1.DocumentName = docName;
stringToPrint = System.IO.File.ReadAllText(fullPath);

    Dim docName As String = "testPage.txt"
Dim docPath As String = "C:\Users\v-rsatao\Desktop\"
Dim fullPath As String = System.IO.Path.Combine(docPath, docName)

PrintDocument1.DocumentName = docName
stringToPrint = System.IO.File.ReadAllText(fullPath)

  7. Como faria para imprimir o documento, no manipulador de eventos PrintPage, use a propriedade Graphics da classe PrintPageEventArgs e o conteúdo do arquivo para calcular linhas por página e renderizar o conteúdo do documento. Depois que cada página for desenhada, verifique se é a última página e defina a propriedade HasMorePages do PrintPageEventArgs de acordo. O evento PrintPage é acionado até que HasMorePages seja false. Quando o documento terminar a renderização, redefina a cadeia de caracteres a ser renderizada. Além disso, certifique-se de que o evento PrintPage esteja associado ao seu método de manipulação de eventos.

    Observação

    Se você implementou a impressão em seu aplicativo, as etapas 5 e 6 podem já ter sido concluídas.

    No exemplo de código a seguir, o manipulador de eventos é usado para imprimir o arquivo "testPage.txt" na mesma fonte usada no formulário.

    void PrintDocument1_PrintPage(object sender, PrintPageEventArgs e)
{
    int charactersOnPage = 0;
    int linesPerPage = 0;

    // Sets the value of charactersOnPage to the number of characters
    // of stringToPrint that will fit within the bounds of the page.
    e.Graphics.MeasureString(stringToPrint, this.Font,
        e.MarginBounds.Size, StringFormat.GenericTypographic,
        out charactersOnPage, out linesPerPage);

    // Draws the string within the bounds of the page.
    e.Graphics.DrawString(stringToPrint, this.Font, Brushes.Black,
    e.MarginBounds, StringFormat.GenericTypographic);

    // Remove the portion of the string that has been printed.
    stringToPrint = stringToPrint.Substring(charactersOnPage);

    // Check to see if more pages are to be printed.
    e.HasMorePages = (stringToPrint.Length > 0);

    // If there are no more pages, reset the string to be printed.
    if (!e.HasMorePages)
        stringToPrint = documentContents;
}

    Private Sub PrintDocument1_PrintPage(ByVal sender As Object, ByVal e As PrintPageEventArgs) Handles PrintDocument1.PrintPage

    Dim charactersOnPage As Integer = 0
    Dim linesPerPage As Integer = 0

    ' Sets the value of charactersOnPage to the number of characters 
    ' of stringToPrint that will fit within the bounds of the page.
    e.Graphics.MeasureString(stringToPrint, Me.Font, e.MarginBounds.Size,
        StringFormat.GenericTypographic, charactersOnPage, linesPerPage)

    ' Draws the string within the bounds of the page.
    e.Graphics.DrawString(stringToPrint, Me.Font, Brushes.Black,
        e.MarginBounds, StringFormat.GenericTypographic)

    ' Remove the portion of the string that has been printed.
    stringToPrint = StringToPrint.Substring(charactersOnPage)

    ' Check to see if more pages are to be printed.
    e.HasMorePages = stringToPrint.Length > 0

    ' If there are no more pages, reset the string to be printed.
    If Not e.HasMorePages Then
        stringToPrint = documentContents
    End If

End Sub

  8. Defina a propriedade Document do controle PrintPreviewDialog para o componente PrintDocument no formulário.

    printPreviewDialog1.Document = printDocument1;

    PrintPreviewDialog1.Document = PrintDocument1

  9. Chame o método ShowDialog no controle PrintPreviewDialog. Observe o código realçado a seguir, você normalmente chamaria ShowDialog a partir do Click método de manipulação de eventos de um botão. Chamar ShowDialog gera o evento PrintPage e renderiza a saída para o controle PrintPreviewDialog. Quando o usuário seleciona o ícone de impressão na caixa de diálogo, o evento PrintPage é gerado novamente, enviando a saída para a impressora em vez da caixa de diálogo de visualização. Assim, a cadeia de caracteres é redefinida no final do processo de renderização na etapa 4.

    O exemplo de código a seguir mostra o Click método de manipulação de eventos para um botão no formulário. O método de manipulação de eventos chama os métodos para ler o documento e mostrar a caixa de diálogo de visualização de impressão.

    private void Button1_Click(object sender, EventArgs e)
{
    string docName = "testPage.txt";
    string docPath = @"C:\";
    string fullPath = System.IO.Path.Combine(docPath, docName);
    printDocument1.DocumentName = docName;
    stringToPrint = System.IO.File.ReadAllText(fullPath);

    printPreviewDialog1.Document = printDocument1;

    printPreviewDialog1.ShowDialog();
}

    Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click

    Dim docName As String = "testPage.txt"
    Dim docPath As String = "C:\Users\v-rsatao\Desktop\"
    Dim fullPath As String = System.IO.Path.Combine(docPath, docName)

    PrintDocument1.DocumentName = docName
    stringToPrint = System.IO.File.ReadAllText(fullPath)

    PrintPreviewDialog1.Document = PrintDocument1

    PrintPreviewDialog1.ShowDialog()

End Sub

Ver também

  • Last updated on