Partilhar via


PrintQueue.CreateXpsDocumentWriter Método

Definição

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);
[System.Security.SecurityCritical]
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref System.Printing.PrintDocumentImageableArea documentImageableArea, ref System.Windows.Controls.PageRangeSelection pageRangeSelection, ref 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);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter
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

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 refByRef 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).

Atributos

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

Aplica-se a

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);
[System.Security.SecurityCritical]
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref System.Printing.PrintDocumentImageableArea documentImageableArea);
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref System.Printing.PrintDocumentImageableArea documentImageableArea);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter
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

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

Atributos

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

Aplica-se a

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

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

Aplica-se a

CreateXpsDocumentWriter(Double, Double)

Cria um objeto XpsDocumentWriter com as dimensões especificadas.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(double % width, double % height);
[System.Security.SecurityCritical]
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref double width, ref double height);
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref double width, ref double height);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : double * double -> System.Windows.Xps.XpsDocumentWriter
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

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

Atributos

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

Aplica-se a

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);
[System.Security.SecurityCritical]
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (string jobDescription, ref System.Printing.PrintDocumentImageableArea documentImageableArea);
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (string jobDescription, ref System.Printing.PrintDocumentImageableArea documentImageableArea);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter
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

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

Atributos

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

Aplica-se a

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);
[System.Security.SecurityCritical]
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);
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);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter
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

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 refByRef 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).

Atributos

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

Aplica-se a