PrintQueue.CreateXpsDocumentWriter Método

Definição

Cria um objeto XpsDocumentWriter.

Sobrecargas

Name Description
CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Cria um objeto XpsDocumentWriter, abre um diálogo de impressão Windows comum, fornece ao diálogo um intervalo de páginas e uma descrição do trabalho de impressão, e retorna um parâmetro ref (ByRef em Visual Basic) que representa informação sobre a área visualizável e as dimensões do suporte.

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Cria um objeto XpsDocumentWriter, abre um diálogo Windows impressão comum e devolve um parâmetro ref (ByRef em Visual Basic) que representa informação sobre a área visualizável e as dimensões do suporte.

CreateXpsDocumentWriter(PrintQueue)

Cria um XpsDocumentWriter objeto e associa-o à fila de impressão especificada.

CreateXpsDocumentWriter(Double, Double)

Cria um XpsDocumentWriter objeto com as dimensões especificadas.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Cria um objeto XpsDocumentWriter, abre uma Windows caixa de diálogo comum de impressão (e fornece-lhe uma descrição do trabalho) e devolve um parâmetro ref (ByRef em Visual Basic) que representa informação sobre a área visualizável e as dimensões do suporte.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Cria um objeto XpsDocumentWriter, abre um diálogo de impressão Windows comum, fornece ao diálogo um intervalo de páginas e devolve um parâmetro ref (ByRef em Visual Basic) que representa informação sobre a área visualizável e as dimensões do suporte.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Cria um objeto XpsDocumentWriter, abre um diálogo de impressão Windows comum, fornece ao diálogo um intervalo de páginas e uma descrição do trabalho de impressão, e retorna um parâmetro ref (ByRef em Visual Basic) que representa informação sobre a área visualizável e as dimensões do suporte.

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 onde o dispositivo pode imprimir. Como o seu tipo de dado não tem construtor público, este parâmetro é passado sem inicializar.

pageRangeSelection
PageRangeSelection

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

pageRange
PageRange

A variedade de páginas que é impressa.

Devoluções

E XpsDocumentWriter que escreve dados XPS num fluxo. Isto pode ser null. (Os parâmetros documentImageableArea, pageRangeSelection e pageRange são todos ref [ByRef em Visual Basic] que são inicializados pelo utilizador e devolvidos quando o diálogo é fechado, pelo que cada um representa um item adicional devolvido.)

Atributos

Observações

Muitas impressoras precisam de até um quarto de polegada de espaço não impresso à volta das bordas de cada página para segurar o papel e movê-lo pela impressora. Caso contrário, o toner iria complicar o mecanismo de fluxo do papel. A área que pode ser impressa é a "área imagética".

O tipo PrintDocumentImageableArea não tem construtor público. Assim, a variável documentImageableArea deve ser declarada e atribuída ao null método e só depois passada ao método. Este método apresenta uma PrintDialog entrada necessária do utilizador. O utilizador configura o seu trabalho de impressão no diálogo (incluindo a seleção da impressora, tamanho do papel, orientação e intervalo de página). Quando o diálogo está fechado, pageRangeSelection tem pageRange valores, e documentImageableArea aponta para um objeto real cujas propriedades são inicializadas.

Se o utilizador cancelar ou fechar o diálogo, o valor de retorno é null. Como consequência, o valor de retorno deve ser verificado null pela sua candidatura.

Ver também

Aplica-se a

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Cria um objeto XpsDocumentWriter, abre um diálogo Windows impressão comum e devolve um parâmetro ref (ByRef em Visual Basic) que representa informação sobre a área visualizável e as dimensões do suporte.

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 onde o dispositivo pode imprimir. Como o seu tipo de dado não tem construtor público, este parâmetro é passado sem inicializar.

Devoluções

E XpsDocumentWriter que escreve dados XPS num fluxo. Isto pode ser null. (O parâmetro documentImageableArea é um parâmetro ref [ByRef em Visual Basic] que é inicializado pelo método, representando assim um segundo item devolvido.)

Atributos

Observações

Muitas impressoras precisam de até um quarto de polegada de espaço não impresso à volta das bordas de cada página para segurar o papel e movê-lo pela impressora. Caso contrário, o toner iria complicar o mecanismo de fluxo do papel. A área que pode ser impressa é a "área imagética".

O tipo PrintDocumentImageableArea não tem construtor público. Assim, a variável documentImageableArea deve ser declarada e atribuída ao null método e só depois passada ao método. Este método apresenta uma PrintDialog entrada necessária do utilizador. Depois de o utilizador selecionar uma impressora, tamanho e orientação do papel e fechar o diálogo, aponta documentImageableArea para um objeto real e as suas propriedades são inicializadas.

Se o utilizador cancelar ou fechar o diálogo, o valor de retorno é null. Como consequência, o valor de retorno deve ser verificado null pela sua candidatura.

Ver também

Aplica-se a

CreateXpsDocumentWriter(PrintQueue)

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

Devoluções

E XpsDocumentWriter que escreva num stream do XPS.

Exemplos

O exemplo seguinte mostra como usar este 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()

Ver também

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

O auge do documento XPS.

Devoluções

E XpsDocumentWriter que escreva num stream do XPS. Isto pode ser null.

Atributos

Observações

Este método apresenta uma PrintDialog entrada necessária do utilizador. Se o utilizador cancelar ou fechar o diálogo, o valor de retorno é null. Como consequência, o valor de retorno deve ser verificado null pela sua candidatura.

Ver também

Aplica-se a

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Cria um objeto XpsDocumentWriter, abre uma Windows caixa de diálogo comum de impressão (e fornece-lhe uma descrição do trabalho) e devolve um parâmetro ref (ByRef em Visual Basic) que representa informação sobre a área visualizável e as dimensões do suporte.

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. Aparece na interface de impressão do Windows.

documentImageableArea
PrintDocumentImageableArea

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

Devoluções

E XpsDocumentWriter que escreve dados XPS num fluxo. Isto pode ser null. (O parâmetro documentImageableArea é um parâmetro ref [ByRef em Visual Basic] que é inicializado pelo método, representando assim um segundo item devolvido.)

Atributos

Observações

Muitas impressoras precisam de até um quarto de polegada de espaço não impresso à volta das bordas de cada página para segurar o papel e movê-lo pela impressora. Caso contrário, o toner iria complicar o mecanismo de fluxo do papel. A área que pode ser impressa é a "área imagética".

O tipo PrintDocumentImageableArea não tem construtor público. Assim, a variável documentImageableArea deve ser declarada e atribuída ao null método e só depois passada ao método. Este método apresenta uma PrintDialog entrada necessária do utilizador. Depois de o utilizador selecionar a impressora, tamanho e orientação do papel e fechar o diálogo, aponta documentImageableArea para um objeto real e as suas propriedades são inicializadas.

Se o utilizador cancelar ou fechar o diálogo, o valor de retorno é null. Como consequência, o valor de retorno deve ser verificado null pela sua candidatura.

Ver também

Aplica-se a

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Cria um objeto XpsDocumentWriter, abre um diálogo de impressão Windows comum, fornece ao diálogo um intervalo de páginas e devolve um parâmetro ref (ByRef em Visual Basic) que representa informação sobre a área visualizável e as dimensões do suporte.

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. Aparece na interface de impressão do Windows.

documentImageableArea
PrintDocumentImageableArea

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

pageRangeSelection
PageRangeSelection

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

pageRange
PageRange

A variedade de páginas que é impressa.

Devoluções

E XpsDocumentWriter que escreve dados XPS num fluxo. Isto pode ser null. (Os parâmetros documentImageableArea, pageRangeSelection e pageRange são todos ref [ByRef em Visual Basic] que são inicializados pelo utilizador e devolvidos quando o diálogo é fechado, pelo que cada um representa um item adicional devolvido.)

Atributos

Observações

Muitas impressoras precisam de até um quarto de polegada de espaço não impresso à volta das bordas de cada página para segurar o papel e movê-lo pela impressora. Caso contrário, o toner iria complicar o mecanismo de fluxo do papel. A área que pode ser impressa é a "área imagética".

O tipo PrintDocumentImageableArea não tem construtor público. Assim, a variável documentImageableArea deve ser declarada e atribuída ao null método e só depois passada ao método. Este método apresenta uma PrintDialog entrada necessária do utilizador. O utilizador configura o seu trabalho de impressão no diálogo (incluindo a seleção da impressora, tamanho do papel, orientação e intervalo de página). Quando o diálogo está fechado, pageRangeSelection tem pageRange valores, e documentImageableArea aponta para um objeto real cujas propriedades são inicializadas.

Se o utilizador cancelar ou fechar o diálogo, o valor de retorno é null. Como consequência, o valor de retorno deve ser verificado null pela sua candidatura.

Ver também

Aplica-se a