SerializerWriter.CreateVisualsCollator Methode

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

Gibt zurück

Ein SerializerWriterCollator, der sortierte Visual-Elemente in den Serialisierungs-Stream der Dokumentausgabe schreibt.

Beispiele

Das folgende Beispiel zeigt die Verwendung der CreateVisualsCollator -Methode.

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

Hinweise für Ausführende

CreateVisualsCollator() sollte eine SerializerWriterCollator zurückgeben, die in dieselbe Serialisierung Stream schreibt wie die, die SerializerWriter zum Erstellen verwendet wird.

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

Parameter

Gibt zurück

Ein SerializerWriterCollator, der sortierte Visual-Elemente in den Serialisierungs-Stream der Dokumentausgabe schreibt.

Beispiele

Das folgende Beispiel zeigt die Verwendung der CreateVisualsCollator -Methode.

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

Hinweise

documentSequencePT oder documentPT kann sein null , wenn keine bevorzugten Druckeinstellungen vorhanden sind.

Diese Methode überprüft oder ändert die angegebenen Drucktickets für eine bestimmte PrintQueue. Verwenden Sie bei Bedarf die PrintQueue.MergeAndValidatePrintTicket-Methode, um ein für die PrintQueue spezifisches PrintTicket zu erstellen, das für einen bestimmten Drucker gültig ist.

Hinweise für Ausführende

CreateVisualsCollator(PrintTicket, PrintTicket) sollte eine SerializerWriterCollator zurückgeben, die in dieselbe Serialisierung Stream schreibt wie die, die SerializerWriter sie erstellt.