PrintQueue.CreateXpsDocumentWriter Método

Definición

Espacio de nombres:

System.Printing

Ensamblado:

System.Printing.dll

Crea un objeto XpsDocumentWriter.

Sobrecargas

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	Crea un objeto XpsDocumentWriter, abre un diálogo de impresión común de Windows, proporciona un intervalo de páginas y una descripción del trabajo de impresión al cuadro de diálogo y devuelve un parámetro ref (ByRef en Visual Basic) que representa información sobre el área de impresión y las dimensiones de los medios.
CreateXpsDocumentWriter(PrintDocumentImageableArea)	Crea un objeto XpsDocumentWriter, abre un diálogo de impresión común de Windows y devuelve un parámetro ref (ByRef en Visual Basic) que representa información sobre el área de impresión y las dimensiones de los soportes.
CreateXpsDocumentWriter(PrintQueue)	Crea un objeto XpsDocumentWriter y lo asocia a la cola de impresión especificada.
CreateXpsDocumentWriter(Double, Double)	Crea un objeto XpsDocumentWriter con las dimensiones especificadas.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	Crea un objeto XpsDocumentWriter, abre un cuadro de diálogo de impresión común de Windows (y le proporciona una descripción de trabajo) y devuelve un parámetro ref (ByRef en Visual Basic) que representa información sobre el área de impresión y las dimensiones de los soportes.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)	Crea un objeto XpsDocumentWriter, abre un diálogo de impresión común de Windows, proporciona un intervalo de páginas al cuadro de diálogo y devuelve un parámetro ref (ByRef en Visual Basic) que representa información sobre el área de impresión y las dimensiones de los medios.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Crea un objeto XpsDocumentWriter, abre un diálogo de impresión común de Windows, proporciona un intervalo de páginas y una descripción del trabajo de impresión al cuadro de diálogo y devuelve un parámetro ref (ByRef en Visual Basic) que representa información sobre el área de impresión y las dimensiones de los medios.

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

Referencia a un objeto que contiene las dimensiones del área de la página en la que el dispositivo puede imprimir. Puesto que su tipo de datos no tiene ningún constructor público, este parámetro se pasa sin inicializar.

pageRangeSelection

PageRangeSelection

Valor que especifica si se van a imprimir todas las páginas o solo un intervalo especificado por el usuario.

pageRange

PageRange

Intervalo de páginas que se imprime.

Devoluciones

XpsDocumentWriter

XpsDocumentWriter que escribe los datos XPS en una secuencia. Puede ser null. (Los parámetros documentImageableArea, pageRangeSelection y pageRange son todos parámetros ref [ByRef en Visual Basic] que el usuario inicializa y se devuelven cuando se cierra el cuadro de diálogo, por lo que cada uno representa un elemento devuelto adicional.)

Comentarios

Muchas impresoras necesitan hasta un cuarto de pulgada de espacio sin imprimir alrededor de los bordes de cada página para agarrar el papel y moverlo a través de la impresora. De lo contrario, el tóner desacertaría el mecanismo de flujo de papel. El área que se puede imprimir es el "área de imagen".

El tipo PrintDocumentImageableArea no tiene ningún constructor público. Por lo tanto, la variable documentImageableArea debe declararse y asignarse a null y solo después pasarse al método . Este método muestra una PrintDialog entrada necesaria del usuario. El usuario configura su trabajo de impresión en el cuadro de diálogo (incluida la selección de una impresora, tamaño de papel, orientación y intervalo de páginas). Cuando se cierra el cuadro de diálogo y pageRangeSelectionpageRange tiene valores, y documentImageableArea apunta a un objeto real cuyas propiedades se inicializan.

Si el usuario cancela o cierra el cuadro de diálogo, el valor devuelto es null. Como consecuencia, la aplicación debe comprobar null el valor devuelto.

Consulte también

• IsXPS Conformance Tool

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Crea un objeto XpsDocumentWriter, abre un diálogo de impresión común de Windows y devuelve un parámetro ref (ByRef en Visual Basic) que representa información sobre el área de impresión y las dimensiones de los soportes.

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

Referencia a un objeto que contiene las dimensiones del área de la página en la que el dispositivo puede imprimir. Puesto que su tipo de datos no tiene ningún constructor público, este parámetro se pasa sin inicializar.

Devoluciones

XpsDocumentWriter

XpsDocumentWriter que escribe los datos XPS en una secuencia. Puede ser null. (El parámetro documentImageableArea es un parámetro ref [ByRef en Visual Basic] que el método inicializa, por lo que representa un segundo elemento devuelto.)

Comentarios

Muchas impresoras necesitan hasta un cuarto de pulgada de espacio sin imprimir alrededor de los bordes de cada página para agarrar el papel y moverlo a través de la impresora. De lo contrario, el tóner desacertaría el mecanismo de flujo de papel. El área que se puede imprimir es el "área de imagen".

El tipo PrintDocumentImageableArea no tiene ningún constructor público. Por lo tanto, la variable documentImageableArea debe declararse y asignarse a null y solo después pasarse al método . Este método muestra una PrintDialog entrada necesaria del usuario. Una vez que el usuario ha seleccionado una impresora, tamaño de papel y orientación y cerrado el cuadro de diálogo, documentImageableArea apunta a un objeto real y se inicializan sus propiedades.

Si el usuario cancela o cierra el cuadro de diálogo, el valor devuelto es null. Como consecuencia, la aplicación debe comprobar null el valor devuelto.

Consulte también

• IsXPS Conformance Tool

CreateXpsDocumentWriter(PrintQueue)

Crea un objeto XpsDocumentWriter y lo asocia a la cola de impresión 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

Cola de impresión para imprimir el documento XPS.

Devoluciones

XpsDocumentWriter

Objeto XpsDocumentWriter que escribe en una secuencia XPS.

Ejemplos

En el ejemplo siguiente se muestra cómo usar este método para crear un 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()

Consulte también

• IsXPS Conformance Tool

CreateXpsDocumentWriter(Double, Double)

Crea un objeto XpsDocumentWriter con las dimensiones 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

Ancho del documento XPS.

height

Double

Alto del documento XPS.

Devoluciones

XpsDocumentWriter

Objeto XpsDocumentWriter que escribe en una secuencia XPS. Puede ser null.

Comentarios

Este método muestra una PrintDialog entrada necesaria del usuario. Si el usuario cancela o cierra el cuadro de diálogo, el valor devuelto es null. Como consecuencia, la aplicación debe comprobar null el valor devuelto.

Consulte también

• IsXPS Conformance Tool

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Crea un objeto XpsDocumentWriter, abre un cuadro de diálogo de impresión común de Windows (y le proporciona una descripción de trabajo) y devuelve un parámetro ref (ByRef en Visual Basic) que representa información sobre el área de impresión y las dimensiones de los soportes.

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

Nombre para el trabajo de impresión. Aparece en la interfaz de usuario de impresión de Windows.

documentImageableArea

PrintDocumentImageableArea

Referencia a un objeto que contiene las dimensiones del área de la página en la que el dispositivo puede imprimir. Puesto que su tipo de datos no tiene ningún constructor público, este parámetro se pasa sin inicializar.

Devoluciones

XpsDocumentWriter

XpsDocumentWriter que escribe los datos XPS en una secuencia. Puede ser null. (El parámetro documentImageableArea es un parámetro ref [ByRef en Visual Basic] que el método inicializa, por lo que representa un segundo elemento devuelto.)

Comentarios

Muchas impresoras necesitan hasta un cuarto de pulgada de espacio sin imprimir alrededor de los bordes de cada página para agarrar el papel y moverlo a través de la impresora. De lo contrario, el tóner desacertaría el mecanismo de flujo de papel. El área que se puede imprimir es el "área de imagen".

El tipo PrintDocumentImageableArea no tiene ningún constructor público. Por lo tanto, la variable documentImageableArea debe declararse y asignarse a null y solo después pasarse al método . Este método muestra una PrintDialog entrada necesaria del usuario. Una vez que el usuario ha seleccionado una impresora, tamaño de papel y orientación y cerrado el cuadro de diálogo, documentImageableArea apunta a un objeto real y se inicializan sus propiedades.

Si el usuario cancela o cierra el cuadro de diálogo, el valor devuelto es null. Como consecuencia, la aplicación debe comprobar null el valor devuelto.

Consulte también

• IsXPS Conformance Tool

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Crea un objeto XpsDocumentWriter, abre un diálogo de impresión común de Windows, proporciona un intervalo de páginas al cuadro de diálogo y devuelve un parámetro ref (ByRef en Visual Basic) que representa información sobre el área de impresión y las dimensiones de los medios.

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

Nombre para el trabajo de impresión. Aparece en la interfaz de usuario de impresión de Windows.

documentImageableArea

PrintDocumentImageableArea

Referencia a un objeto que contiene las dimensiones del área de la página en la que el dispositivo puede imprimir. Puesto que su tipo de datos no tiene ningún constructor público, este parámetro se pasa sin inicializar.

pageRangeSelection

PageRangeSelection

Valor que especifica si se van a imprimir todas las páginas o solo un intervalo especificado por el usuario.

pageRange

PageRange

Intervalo de páginas que se imprime.

Devoluciones

XpsDocumentWriter

XpsDocumentWriter que escribe los datos XPS en una secuencia. Puede ser null. (Los parámetros documentImageableArea, pageRangeSelection y pageRange son todos parámetros ref [ByRef en Visual Basic] que el usuario inicializa y se devuelven cuando se cierra el cuadro de diálogo, por lo que cada uno representa un elemento devuelto adicional.)

Comentarios

Muchas impresoras necesitan hasta un cuarto de pulgada de espacio sin imprimir alrededor de los bordes de cada página para agarrar el papel y moverlo a través de la impresora. De lo contrario, el tóner desacertaría el mecanismo de flujo de papel. El área que se puede imprimir es el "área de imagen".

El tipo PrintDocumentImageableArea no tiene ningún constructor público. Por lo tanto, la variable documentImageableArea debe declararse y asignarse a null y solo después pasarse al método . Este método muestra una PrintDialog entrada necesaria del usuario. El usuario configura su trabajo de impresión en el cuadro de diálogo (incluida la selección de una impresora, tamaño de papel, orientación y intervalo de páginas). Cuando se cierra el cuadro de diálogo y pageRangeSelectionpageRange tiene valores, y documentImageableArea apunta a un objeto real cuyas propiedades se inicializan.

Si el usuario cancela o cierra el cuadro de diálogo, el valor devuelto es null. Como consecuencia, la aplicación debe comprobar null el valor devuelto.

Consulte también

• IsXPS Conformance Tool