SerializerWriter.CreateVisualsCollator Metodo

Definizione

Spazio dei nomi:

System.Windows.Documents.Serialization

Assembly:

PresentationFramework.dll

In caso di override in una classe derivata, restituisce un oggetto SerializerWriterCollator che scrive elementi Visual con regole di confronto nell'oggetto Stream di serializzazione.

Overload

CreateVisualsCollator()	In caso di override in una classe derivata, restituisce un oggetto SerializerWriterCollator che scrive elementi Visual con regole di confronto applicate.
CreateVisualsCollator(PrintTicket, PrintTicket)	In caso di override in una classe derivata, restituisce un oggetto SerializerWriterCollator che scrive elementi Visual con regole di confronto applicate insieme ai ticket di stampa specificati.

Esempio

Nell'esempio CreateVisualsCollator seguente viene illustrato l'uso del metodo .

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

In caso di override in una classe derivata, restituisce un oggetto SerializerWriterCollator che scrive elementi Visual con regole di confronto applicate.

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

Restituisce

SerializerWriterCollator

Oggetto SerializerWriterCollator che scrive elementi Visual con regole di confronto applicate nell'oggetto Stream di serializzazione per l'output dei documenti.

Esempio

Nell'esempio CreateVisualsCollator seguente viene illustrato l'uso del metodo .

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

Note per gli implementatori

CreateVisualsCollator() deve restituire un oggetto SerializerWriterCollator che scrive nella stessa serializzazione Stream dell'oggetto SerializerWriter usato per crearlo.

CreateVisualsCollator(PrintTicket, PrintTicket)

In caso di override in una classe derivata, restituisce un oggetto SerializerWriterCollator che scrive elementi Visual con regole di confronto applicate insieme ai ticket di stampa specificati.

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

Parametri

documentSequencePT

PrintTicket

Preferenze di stampa predefinite per il contenuto di FixedDocumentSequence.

documentPT

PrintTicket

Preferenze di stampa predefinite per il contenuto di FixedDocument.

Restituisce

SerializerWriterCollator

Oggetto SerializerWriterCollator che scrive elementi Visual con regole di confronto applicate nell'oggetto Stream di serializzazione per l'output dei documenti.

Esempio

Nell'esempio CreateVisualsCollator seguente viene illustrato l'uso del metodo .

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

Commenti

documentSequencePT oppure documentPT può essere null se non sono presenti impostazioni di stampa preferite.

Questo metodo non convalida o modifica i ticket di stampa specificati per un determinato PrintQueueoggetto . Se necessario, utilizzare il metodo PrintQueue.MergeAndValidatePrintTicket per creare un PrintQueue specifico della PrintTicket che sia valido per una stampante specificata.

Note per gli implementatori

CreateVisualsCollator(PrintTicket, PrintTicket) deve restituire un oggetto SerializerWriterCollator che scrive nella stessa serializzazione Stream dell'oggetto SerializerWriter che lo crea.