SerializerWriter.CreateVisualsCollator Méthode

Définition

Espace de noms:

System.Windows.Documents.Serialization

Assembly:

PresentationFramework.dll

En cas de substitution dans une classe dérivée, retourne un SerializerWriterCollator qui écrit des éléments Visual assemblés dans le Stream de sérialisation.

Surcharges

CreateVisualsCollator()	En cas de substitution dans une classe dérivée, retourne un SerializerWriterCollator qui écrit des éléments Visual assemblés.
CreateVisualsCollator(PrintTicket, PrintTicket)	En cas de substitution dans une classe dérivée, retourne un SerializerWriterCollator qui écrit des éléments Visual assemblés avec les tickets d’impression donnés.

Exemples

L’exemple suivant montre l’utilisation de la CreateVisualsCollator méthode .

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

En cas de substitution dans une classe dérivée, retourne un SerializerWriterCollator qui écrit des éléments Visual assemblés.

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

Retours

SerializerWriterCollator

SerializerWriterCollator qui écrit des éléments Visual assemblés dans le Stream de sérialisation de sortie de document.

Exemples

L’exemple suivant montre l’utilisation de la CreateVisualsCollator méthode .

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

Notes pour les responsables de l’implémentation

CreateVisualsCollator() doit retourner un SerializerWriterCollator qui écrit dans la même sérialisation Stream que celle utilisée pour le SerializerWriter créer.

CreateVisualsCollator(PrintTicket, PrintTicket)

En cas de substitution dans une classe dérivée, retourne un SerializerWriterCollator qui écrit des éléments Visual assemblés avec les tickets d’impression donnés.

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

Paramètres

documentSequencePT

PrintTicket

Préférences d’impression par défaut pour le contenu FixedDocumentSequence.

documentPT

PrintTicket

Préférences d’impression par défaut pour le contenu FixedDocument.

Retours

SerializerWriterCollator

SerializerWriterCollator qui écrit des éléments Visual assemblés dans le Stream de sérialisation de sortie de document.

Exemples

L’exemple suivant montre l’utilisation de la CreateVisualsCollator méthode .

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

Remarques

documentSequencePT ou documentPT peut être null s’il n’y a pas de paramètres d’impression préférés.

Cette méthode ne valide ni ne modifie les tickets d’impression donnés pour un particulier PrintQueue. Si nécessaire, utilisez la méthode PrintQueue.MergeAndValidatePrintTicket pour créer un PrintQueue spécifique à la PrintTicket et valide pour l'imprimante donnée.

Notes pour les responsables de l’implémentation

CreateVisualsCollator(PrintTicket, PrintTicket) doit retourner un SerializerWriterCollator qui écrit dans la même sérialisation Stream que le qui le SerializerWriter crée.