PrintQueue.CreateXpsDocumentWriter Método

Definição

Namespace:: System.Printing

Assembly:: System.Printing.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria um objeto XpsDocumentWriter.

Sobrecargas

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

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Cria um XpsDocumentWriter objeto, abre uma caixa de diálogo de impressão comum do Windows, fornece a caixa de diálogo com um intervalo de páginas e uma descrição do trabalho de impressão e retorna um ref parâmetro (ByRef no Visual Basic) que representa informações sobre a área imageável 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 na qual o dispositivo pode imprimir. Como seu tipo de dados não tem construtor público, esse parâmetro é passado sem inicialização.

pageRangeSelection: PageRangeSelection

Um valor que especifica se todas as páginas devem ser impressas ou apenas um intervalo especificado pelo usuário.

pageRange: PageRange

O intervalo de páginas impressas.

Retornos

XpsDocumentWriter

Um XpsDocumentWriter que grava dados XPS em um fluxo. Ele pode ser null. (Os parâmetros e pageRangeSelectionpageRange todos os ref parâmetros documentImageableArea[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.)

Atributos: SecurityCriticalAttribute

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 pela impressora. Caso contrário, toner sujaria o mecanismo de fluxo de papel. A área que pode ser impressa é a "área imagens".

O tipo PrintDocumentImageableArea não tem construtor público. Portanto, a variável documentImageableArea deve ser declarada e atribuída null e somente depois passada para o método. Esse método exibe uma PrintDialog entrada necessária 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 aplicativo.

Aplica-se a

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Cria um XpsDocumentWriter objeto, abre uma caixa de diálogo de impressão comum do Windows e retorna um ref parâmetro (ByRef no Visual Basic) que representa informações sobre a área imagens 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

Retornos

XpsDocumentWriter

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

Atributos: SecurityCriticalAttribute

Comentários

O tipo PrintDocumentImageableArea não tem construtor público. Portanto, a variável documentImageableArea deve ser declarada e atribuída null e somente depois passada para o método. Esse método exibe uma PrintDialog entrada necessária 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 aplicativo.

Aplica-se a

CreateXpsDocumentWriter(PrintQueue)

Cria um XpsDocumentWriter objeto e o associa à 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 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()

Aplica-se a

CreateXpsDocumentWriter(Double, Double)

Cria um XpsDocumentWriter objeto 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

XpsDocumentWriter

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

Atributos: SecurityCriticalAttribute

Comentários

Esse método exibe uma PrintDialog entrada necessária 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 aplicativo.

Aplica-se a

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Cria um XpsDocumentWriter objeto, abre uma caixa de diálogo de impressão comum do Windows (e fornece uma descrição de trabalho) e retorna um ref parâmetro (ByRef no Visual Basic) que representa informações sobre a área imagens 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

Retornos

XpsDocumentWriter

Atributos: SecurityCriticalAttribute

Comentários

O tipo PrintDocumentImageableArea não tem construtor público. Portanto, a variável documentImageableArea deve ser declarada e atribuída null e somente depois passada para o método. Esse método exibe uma PrintDialog entrada necessária 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 aplicativo.

Aplica-se a

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Cria um XpsDocumentWriter objeto, abre uma caixa de diálogo de impressão comum do Windows, fornece a caixa de diálogo com um intervalo de páginas e retorna um ref parâmetro (ByRef no Visual Basic) que representa informações sobre a área imagens 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

pageRangeSelection: PageRangeSelection

Um valor que especifica se todas as páginas devem ser impressas ou apenas um intervalo especificado pelo usuário.

pageRange: PageRange

O intervalo de páginas impressas.

Retornos

XpsDocumentWriter

Atributos: SecurityCriticalAttribute

Comentários

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 aplicativo.

Aplica-se a

Comentários

Esta página foi útil?