Compartir a través de


PrintQueue.CreateXpsDocumentWriter Método

Definición

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);
[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

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

Atributos

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

Se aplica a

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);
[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

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

Atributos

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

Se aplica a

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

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

Se aplica a

CreateXpsDocumentWriter(Double, Double)

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

Ancho del documento XPS.

height
Double

Alto del documento XPS.

Devoluciones

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

Atributos

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

Se aplica a

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);
[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

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

Atributos

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

Se aplica a

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);
[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

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

Atributos

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

Se aplica a