PrintQueue.CreateXpsDocumentWriter Método

Definição

Namespace:

System.Printing

Assembly:

System.Printing.dll

Cria um objeto de XpsDocumentWriter .

Sobrecargas

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	Cria um objeto XpsDocumentWriter, abre uma caixa diálogo de impressão comum do Windows, fornece um intervalo de página e uma descrição do trabalho de impressão à caixa de diálogo e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da mídia.
CreateXpsDocumentWriter(PrintDocumentImageableArea)	Cria um objeto XpsDocumentWriter, abre uma caixa de diálogo de impressão comum do Windows e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da mídia.
CreateXpsDocumentWriter(PrintQueue)	Cria um objeto XpsDocumentWriter e o associa com a fila de impressão especificada.
CreateXpsDocumentWriter(Double, Double)	Cria um objeto XpsDocumentWriter com as dimensões especificadas.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	Cria um objeto XpsDocumentWriter, abre uma caixa de diálogo de impressão comum do Windows (e fornece a ela uma descrição do trabalho) e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da mídia.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)	Cria um objeto XpsDocumentWriter, abre uma caixa diálogo de impressão comum do Windows, fornece um intervalo de página à caixa de diálogo e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da mídia.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Cria um objeto XpsDocumentWriter, abre uma caixa diálogo de impressão comum do Windows, fornece um intervalo de página e uma descrição do trabalho de impressão à caixa de diálogo e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da mídia.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::Printing::PrintDocumentImageableArea ^ % documentImageableArea, System::Windows::Controls::PageRangeSelection % pageRangeSelection, System::Windows::Controls::PageRange % pageRange);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref System.Printing.PrintDocumentImageableArea documentImageableArea, ref System.Windows.Controls.PageRangeSelection pageRangeSelection, ref System.Windows.Controls.PageRange pageRange);

static member CreateXpsDocumentWriter : PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (ByRef documentImageableArea As PrintDocumentImageableArea, ByRef pageRangeSelection As PageRangeSelection, ByRef pageRange As PageRange) As XpsDocumentWriter

Parâmetros

documentImageableArea

PrintDocumentImageableArea

Uma referência a um objeto que contém as dimensões da área da página em que o dispositivo pode imprimir. Como seu tipo de dados não tem um construtor público, este parâmetro é passado não inicializado.

pageRangeSelection

PageRangeSelection

Um valor que especifica se deve-se imprimir todas as páginas ou apenas um intervalo especificado pelo usuário.

pageRange

PageRange

O intervalo de páginas que é impresso.

Retornos

XpsDocumentWriter

Um XpsDocumentWriter que grava dados XPS em um fluxo. Ele pode ser null. (Os parâmetros documentImageableArea, pageRangeSelection e pageRange são todos parâmetros ref – ByRef no Visual Basic – que são inicializados pelo usuário e retornados quando a caixa de diálogo é fechada, portanto, cada um representa um item retornado adicional).

Comentários

Muitas impressoras precisam de até um quarto de polegada de espaço não impresso ao redor das bordas de cada página para segurar o papel e movê-lo através da impressora. Caso contrário, toner sujaria o mecanismo de fluxo de papel. A área que pode ser impressa é a "área de imagem".

O tipo PrintDocumentImageableArea não tem construtor público. Portanto, a variável documentImageableArea deve ser declarada e atribuída a null e somente depois passada para o método . Esse método exibe uma PrintDialog entrada que exige do usuário. O usuário configura seu trabalho de impressão na caixa de diálogo (incluindo a seleção de uma impressora, tamanho do papel, orientação e intervalo de páginas). Quando a caixa de diálogo é fechada e pageRangeSelectionpageRange tem valores e documentImageableArea aponta para um objeto real cujas propriedades são inicializadas.

Se o usuário cancelar ou fechar a caixa de diálogo, o valor retornado será null. Como consequência, o valor retornado deve ser verificado null pelo seu aplicativo.

Confira também

• Ferramenta de Conformidade isXPS

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Cria um objeto XpsDocumentWriter, abre uma caixa de diálogo de impressão comum do Windows e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da mídia.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::Printing::PrintDocumentImageableArea ^ % documentImageableArea);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref System.Printing.PrintDocumentImageableArea documentImageableArea);

static member CreateXpsDocumentWriter : PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (ByRef documentImageableArea As PrintDocumentImageableArea) As XpsDocumentWriter

Parâmetros

documentImageableArea

PrintDocumentImageableArea

Uma referência a um objeto que contém as dimensões da área da página em que o dispositivo pode imprimir. Como seu tipo de dados não tem um construtor público, este parâmetro é passado não inicializado.

Retornos

XpsDocumentWriter

Um XpsDocumentWriter que grava dados XPS em um fluxo. Ele pode ser null. (O parâmetro documentImageableArea é um parâmetro ref – ByRef no Visual Basic – que é inicializado pelo método, portanto ele representa um segundo item retornado).

Comentários

Muitas impressoras precisam de até um quarto de polegada de espaço não impresso ao redor das bordas de cada página para segurar o papel e movê-lo através da impressora. Caso contrário, toner sujaria o mecanismo de fluxo de papel. A área que pode ser impressa é a "área de imagem".

O tipo PrintDocumentImageableArea não tem construtor público. Portanto, a variável documentImageableArea deve ser declarada e atribuída a null e somente depois passada para o método . Esse método exibe uma PrintDialog entrada que exige do usuário. Depois que o usuário tiver selecionado uma impressora, o tamanho do papel e a orientação e fechado a caixa de diálogo, documentImageableArea apontará para um objeto real e suas propriedades serão inicializadas.

Se o usuário cancelar ou fechar a caixa de diálogo, o valor retornado será null. Como consequência, o valor retornado deve ser verificado null pelo seu aplicativo.

Confira também

• Ferramenta de Conformidade isXPS

CreateXpsDocumentWriter(PrintQueue)

Cria um objeto XpsDocumentWriter e o associa com a fila de impressão especificada.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::Printing::PrintQueue ^ printQueue);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (System.Printing.PrintQueue printQueue);

static member CreateXpsDocumentWriter : System.Printing.PrintQueue -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (printQueue As PrintQueue) As XpsDocumentWriter

Parâmetros

printQueue

PrintQueue

Uma fila de impressão para imprimir o documento XPS.

Retornos

XpsDocumentWriter

Um XpsDocumentWriter que grava em um fluxo de XPS.

Exemplos

O exemplo a seguir mostra como usar esse método para criar um XpsDocumentWriter.

// -------------------- GetPrintXpsDocumentWriter() -------------------
/// <summary>
///   Returns an XpsDocumentWriter for the default print queue.</summary>
/// <returns>
///   An XpsDocumentWriter for the default print queue.</returns>
private XpsDocumentWriter GetPrintXpsDocumentWriter()
{
    // Create a local print server
    LocalPrintServer ps = new LocalPrintServer();

    // Get the default print queue
    PrintQueue pq = ps.DefaultPrintQueue;

    // Get an XpsDocumentWriter for the default print queue
    XpsDocumentWriter xpsdw = PrintQueue.CreateXpsDocumentWriter(pq);
    return xpsdw;
}// end:GetPrintXpsDocumentWriter()

' -------------------- GetPrintXpsDocumentWriter() -------------------
''' <summary>
'''   Returns an XpsDocumentWriter for the default print queue.</summary>
''' <returns>
'''   An XpsDocumentWriter for the default print queue.</returns>
Private Function GetPrintXpsDocumentWriter() As XpsDocumentWriter
    ' Create a local print server
    Dim ps As New LocalPrintServer()

    ' Get the default print queue
    Dim pq As PrintQueue = ps.DefaultPrintQueue

    ' Get an XpsDocumentWriter for the default print queue
    Dim xpsdw As XpsDocumentWriter = PrintQueue.CreateXpsDocumentWriter(pq)
    Return xpsdw
End Function ' end:GetPrintXpsDocumentWriter()

Confira também

• Ferramenta de Conformidade isXPS

CreateXpsDocumentWriter(Double, Double)

Cria um objeto XpsDocumentWriter com as dimensões especificadas.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(double % width, double % height);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref double width, ref double height);

static member CreateXpsDocumentWriter : double * double -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (ByRef width As Double, ByRef height As Double) As XpsDocumentWriter

Parâmetros

width

Double

A largura do documento XPS.

height

Double

A altura do documento XPS.

Retornos

XpsDocumentWriter

Um XpsDocumentWriter que grava em um fluxo de XPS. Ele pode ser null.

Comentários

Esse método exibe uma PrintDialog entrada que exige do usuário. Se o usuário cancelar ou fechar a caixa de diálogo, o valor retornado será null. Como consequência, o valor retornado deve ser verificado null pelo seu aplicativo.

Confira também

• Ferramenta de Conformidade isXPS

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Cria um objeto XpsDocumentWriter, abre uma caixa de diálogo de impressão comum do Windows (e fornece a ela uma descrição do trabalho) e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da mídia.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::String ^ jobDescription, System::Printing::PrintDocumentImageableArea ^ % documentImageableArea);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (string jobDescription, ref System.Printing.PrintDocumentImageableArea documentImageableArea);

static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (jobDescription As String, ByRef documentImageableArea As PrintDocumentImageableArea) As XpsDocumentWriter

Parâmetros

jobDescription

String

Um nome para o trabalho de impressão. Ele aparece na interface do usuário de impressão do Windows.

documentImageableArea

PrintDocumentImageableArea

Uma referência a um objeto que contém as dimensões da área da página em que o dispositivo pode imprimir. Como seu tipo de dados não tem um construtor público, este parâmetro é passado não inicializado.

Retornos

XpsDocumentWriter

Um XpsDocumentWriter que grava dados XPS em um fluxo. Ele pode ser null. (O parâmetro documentImageableArea é um parâmetro ref – ByRef no Visual Basic – que é inicializado pelo método, portanto ele representa um segundo item retornado).

Comentários

Muitas impressoras precisam de até um quarto de polegada de espaço não impresso ao redor das bordas de cada página para segurar o papel e movê-lo através da impressora. Caso contrário, toner sujaria o mecanismo de fluxo de papel. A área que pode ser impressa é a "área de imagem".

O tipo PrintDocumentImageableArea não tem construtor público. Portanto, a variável documentImageableArea deve ser declarada e atribuída a null e somente depois passada para o método . Esse método exibe uma PrintDialog entrada que exige do usuário. Depois que o usuário tiver selecionado uma impressora, o tamanho do papel e a orientação e fechado a caixa de diálogo, documentImageableArea apontará para um objeto real e suas propriedades serão inicializadas.

Se o usuário cancelar ou fechar a caixa de diálogo, o valor retornado será null. Como consequência, o valor retornado deve ser verificado null pelo seu aplicativo.

Confira também

• Ferramenta de Conformidade isXPS

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Cria um objeto XpsDocumentWriter, abre uma caixa diálogo de impressão comum do Windows, fornece um intervalo de página à caixa de diálogo e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da mídia.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::String ^ jobDescription, System::Printing::PrintDocumentImageableArea ^ % documentImageableArea, System::Windows::Controls::PageRangeSelection % pageRangeSelection, System::Windows::Controls::PageRange % pageRange);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (string jobDescription, ref System.Printing.PrintDocumentImageableArea documentImageableArea, ref System.Windows.Controls.PageRangeSelection pageRangeSelection, ref System.Windows.Controls.PageRange pageRange);

static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (jobDescription As String, ByRef documentImageableArea As PrintDocumentImageableArea, ByRef pageRangeSelection As PageRangeSelection, ByRef pageRange As PageRange) As XpsDocumentWriter

Parâmetros

jobDescription

String

Um nome para o trabalho de impressão. Ele aparece na interface do usuário de impressão do Windows.

documentImageableArea

PrintDocumentImageableArea

Uma referência a um objeto que contém as dimensões da área da página em que o dispositivo pode imprimir. Como seu tipo de dados não tem um construtor público, este parâmetro é passado não inicializado.

pageRangeSelection

PageRangeSelection

Um valor que especifica se deve-se imprimir todas as páginas ou apenas um intervalo especificado pelo usuário.

pageRange

PageRange

O intervalo de páginas que é impresso.

Retornos

XpsDocumentWriter

Um XpsDocumentWriter que grava dados XPS em um fluxo. Ele pode ser null. (Os parâmetros documentImageableArea, pageRangeSelection e pageRange são todos parâmetros ref – ByRef no Visual Basic – que são inicializados pelo usuário e retornados quando a caixa de diálogo é fechada, portanto, cada um representa um item retornado adicional).

Comentários

Muitas impressoras precisam de até um quarto de polegada de espaço não impresso ao redor das bordas de cada página para segurar o papel e movê-lo através da impressora. Caso contrário, toner sujaria o mecanismo de fluxo de papel. A área que pode ser impressa é a "área de imagem".

O tipo PrintDocumentImageableArea não tem construtor público. Portanto, a variável documentImageableArea deve ser declarada e atribuída a null e somente depois passada para o método . Esse método exibe uma PrintDialog entrada que exige do usuário. O usuário configura seu trabalho de impressão na caixa de diálogo (incluindo a seleção de uma impressora, tamanho do papel, orientação e intervalo de páginas). Quando a caixa de diálogo é fechada e pageRangeSelectionpageRange tem valores e documentImageableArea aponta para um objeto real cujas propriedades são inicializadas.

Se o usuário cancelar ou fechar a caixa de diálogo, o valor retornado será null. Como consequência, o valor retornado deve ser verificado null pelo seu aplicativo.

Confira também

• Ferramenta de Conformidade isXPS