PrintDocument.DocumentName Propriedade

Definição

Obtém ou define o nome de documento a ser exibido (por exemplo, em uma caixa de diálogo de status de impressão ou em uma fila de impressão) enquanto o documento está sendo impresso.

public string DocumentName { get; set; }

Valor da propriedade

O nome do documento a ser exibido ao imprimir o documento. O padrão é "documento".

Exemplos

O exemplo de código a seguir imprime um documento com a primeira página em cores, se a impressora der suporte a ele e define o DocumentName como um nome amigável. O exemplo requer que uma PrintDocument variável chamada printDoc tenha sido criada e os PrintPage eventos e QueryPageSettings sejam tratados.

Use os System.Drawing namespaces e System.Drawing.Printing para este exemplo.


private void MyButtonPrint_OnClick(object sender, System.EventArgs e)
{
    
    // Set the printer name and ensure it is valid. If not, provide a message to the user.
    printDoc.PrinterSettings.PrinterName = "\\mynetworkprinter";

    if (printDoc.PrinterSettings.IsValid) {
    
        // If the printer supports printing in color, then override the printer's default behavior.
        if (printDoc.PrinterSettings.SupportsColor) {

            // Set the page default's to not print in color.
            printDoc.DefaultPageSettings.Color = false;
        }

        // Provide a friendly name, set the page number, and print the document.
        printDoc.DocumentName = "My Presentation";
        currentPageNumber = 1;
        printDoc.Print();
    }
    else {
        MessageBox.Show("Printer is not valid");
    }
}

private void MyPrintQueryPageSettingsEvent(object sender, QueryPageSettingsEventArgs e)
{
    // Determines if the printer supports printing in color.
    if (printDoc.PrinterSettings.SupportsColor) {

        // If the printer supports color printing, use color.
        if (currentPageNumber == 1 ) {

            e.PageSettings.Color = true;
        }
    }    
}

Comentários

A DocumentName propriedade não especifica o arquivo a ser impresso. Em vez disso, especifique a saída a ser impressa manipulando o PrintPage evento . Para obter um exemplo, consulte a visão geral da PrintDocument classe.

Aplica-se a

Confira também