SerializerWriter.CreateVisualsCollator Método

Definición

Espacio de nombres:

System.Windows.Documents.Serialization

Ensamblado:

PresentationFramework.dll

Si se reemplaza en una clase derivada, devuelve un elemento SerializerWriterCollator que escribe elementos Visual intercalados en la serialización Stream.

Sobrecargas

CreateVisualsCollator()	Si se reemplaza en una clase derivada, devuelve un SerializerWriterCollator que escribe elementos Visual intercalados.
CreateVisualsCollator(PrintTicket, PrintTicket)	Si se reemplaza en una clase derivada, devuelve un SerializerWriterCollator que escribe elementos Visual intercalados junto con los vales de impresión proporcionados.

Ejemplos

En el ejemplo siguiente se muestra el uso del CreateVisualsCollator método .

private void SaveVisuals(XpsDocumentWriter xpsdw, List<Visual> vc)
{
    // Setup for writing multiple visuals
    VisualsToXpsDocument vToXpsD = (VisualsToXpsDocument)xpsdw.CreateVisualsCollator();

    // Iterate through all visuals in the collection
    foreach (Visual v in vc)
    {
        vToXpsD.Write(v);   //Write each visual to single page
    }

    // End writing multiple visuals
    vToXpsD.EndBatchWrite();
}

Private Sub SaveVisuals(ByVal xpsdw As XpsDocumentWriter, ByVal vc As List(Of Visual))
    ' Setup for writing multiple visuals
    Dim vToXpsD As VisualsToXpsDocument = CType(xpsdw.CreateVisualsCollator(), VisualsToXpsDocument)

    ' Iterate through all visuals in the collection
    For Each v As Visual In vc
        vToXpsD.Write(v) 'Write each visual to single page
    Next v

    ' End writing multiple visuals
    vToXpsD.EndBatchWrite()
End Sub

CreateVisualsCollator()

Si se reemplaza en una clase derivada, devuelve un SerializerWriterCollator que escribe elementos Visual intercalados.

public:
 abstract System::Windows::Documents::Serialization::SerializerWriterCollator ^ CreateVisualsCollator();

public abstract System.Windows.Documents.Serialization.SerializerWriterCollator CreateVisualsCollator ();

abstract member CreateVisualsCollator : unit -> System.Windows.Documents.Serialization.SerializerWriterCollator

Public MustOverride Function CreateVisualsCollator () As SerializerWriterCollator

Devoluciones

SerializerWriterCollator

SerializerWriterCollator que escribe elementos Visual intercalados en la serialización de salida del documento Stream.

Ejemplos

En el ejemplo siguiente se muestra el uso del CreateVisualsCollator método .

private void SaveVisuals(XpsDocumentWriter xpsdw, List<Visual> vc)
{
    // Setup for writing multiple visuals
    VisualsToXpsDocument vToXpsD = (VisualsToXpsDocument)xpsdw.CreateVisualsCollator();

    // Iterate through all visuals in the collection
    foreach (Visual v in vc)
    {
        vToXpsD.Write(v);   //Write each visual to single page
    }

    // End writing multiple visuals
    vToXpsD.EndBatchWrite();
}

Private Sub SaveVisuals(ByVal xpsdw As XpsDocumentWriter, ByVal vc As List(Of Visual))
    ' Setup for writing multiple visuals
    Dim vToXpsD As VisualsToXpsDocument = CType(xpsdw.CreateVisualsCollator(), VisualsToXpsDocument)

    ' Iterate through all visuals in the collection
    For Each v As Visual In vc
        vToXpsD.Write(v) 'Write each visual to single page
    Next v

    ' End writing multiple visuals
    vToXpsD.EndBatchWrite()
End Sub

Notas a los implementadores

CreateVisualsCollator() debe devolver un SerializerWriterCollator que escriba en la misma serialización Stream que la SerializerWriter que se usa para crearla.

CreateVisualsCollator(PrintTicket, PrintTicket)

Si se reemplaza en una clase derivada, devuelve un SerializerWriterCollator que escribe elementos Visual intercalados junto con los vales de impresión proporcionados.

public:
 abstract System::Windows::Documents::Serialization::SerializerWriterCollator ^ CreateVisualsCollator(System::Printing::PrintTicket ^ documentSequencePT, System::Printing::PrintTicket ^ documentPT);

public abstract System.Windows.Documents.Serialization.SerializerWriterCollator CreateVisualsCollator (System.Printing.PrintTicket documentSequencePT, System.Printing.PrintTicket documentPT);

abstract member CreateVisualsCollator : System.Printing.PrintTicket * System.Printing.PrintTicket -> System.Windows.Documents.Serialization.SerializerWriterCollator

Public MustOverride Function CreateVisualsCollator (documentSequencePT As PrintTicket, documentPT As PrintTicket) As SerializerWriterCollator

Parámetros

documentSequencePT

PrintTicket

Preferencias de impresión predeterminadas para el contenido de FixedDocumentSequence.

documentPT

PrintTicket

Preferencias de impresión predeterminadas para el contenido de FixedDocument.

Devoluciones

SerializerWriterCollator

SerializerWriterCollator que escribe elementos Visual intercalados en la serialización de salida del documento Stream.

Ejemplos

En el ejemplo siguiente se muestra el uso del CreateVisualsCollator método .

private void SaveVisuals(XpsDocumentWriter xpsdw, List<Visual> vc)
{
    // Setup for writing multiple visuals
    VisualsToXpsDocument vToXpsD = (VisualsToXpsDocument)xpsdw.CreateVisualsCollator();

    // Iterate through all visuals in the collection
    foreach (Visual v in vc)
    {
        vToXpsD.Write(v);   //Write each visual to single page
    }

    // End writing multiple visuals
    vToXpsD.EndBatchWrite();
}

Private Sub SaveVisuals(ByVal xpsdw As XpsDocumentWriter, ByVal vc As List(Of Visual))
    ' Setup for writing multiple visuals
    Dim vToXpsD As VisualsToXpsDocument = CType(xpsdw.CreateVisualsCollator(), VisualsToXpsDocument)

    ' Iterate through all visuals in the collection
    For Each v As Visual In vc
        vToXpsD.Write(v) 'Write each visual to single page
    Next v

    ' End writing multiple visuals
    vToXpsD.EndBatchWrite()
End Sub

Comentarios

documentSequencePT o documentPT puede ser null si no hay ninguna configuración de impresión preferida.

Este método no valida ni modifica los vales de impresión especificados para un determinado PrintQueue. Si es necesario, utilice el método PrintQueue.MergeAndValidatePrintTicket para crear un PrintQueue específico de PrintTicket que sea válido para una impresora dada.

Notas a los implementadores

CreateVisualsCollator(PrintTicket, PrintTicket) debe devolver un SerializerWriterCollator que escriba en la misma serialización Stream que la SerializerWriter que la crea.