SerializerWriter.CreateVisualsCollator Método

Definição

Namespace:

System.Windows.Documents.Serialization

Assembly:

PresentationFramework.dll

Quando substituído em uma classe derivada, retorna um SerializerWriterCollator que grava elementos Visual agrupados na serialização Stream.

Sobrecargas

CreateVisualsCollator()	Quando substituído em uma classe derivada, retorna um SerializerWriterCollator que grava elementos Visual agrupados.
CreateVisualsCollator(PrintTicket, PrintTicket)	Quando substituído em uma classe derivada, retorna um SerializerWriterCollator que grava elementos Visual agrupados junto com os tíquetes de impressão fornecidos.

Exemplos

O exemplo a seguir mostra o uso do 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()

Quando substituído em uma classe derivada, retorna um SerializerWriterCollator que grava elementos Visual agrupados.

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

Retornos

SerializerWriterCollator

Um SerializerWriterCollator que grava elementos Visual agrupados na serialização Stream de saída do documento.

Exemplos

O exemplo a seguir mostra o uso do 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 aos Implementadores

CreateVisualsCollator() deve retornar um SerializerWriterCollator que grava na mesma serialização Stream que a SerializerWriter usada para criá-la.

CreateVisualsCollator(PrintTicket, PrintTicket)

Quando substituído em uma classe derivada, retorna um SerializerWriterCollator que grava elementos Visual agrupados junto com os tíquetes de impressão fornecidos.

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

As preferências de impressão padrão para o conteúdo FixedDocumentSequence.

documentPT

PrintTicket

As preferências de impressão padrão para o conteúdo FixedDocument.

Retornos

SerializerWriterCollator

Um SerializerWriterCollator que grava elementos Visual agrupados na serialização Stream de saída do documento.

Exemplos

O exemplo a seguir mostra o uso do 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

Comentários

documentSequencePT ou documentPT pode ser null se não houver configurações de impressão preferenciais.

Esse método não valida nem modifica os tíquetes de impressão determinados para um determinado PrintQueue. Se necessário, use o método PrintQueue.MergeAndValidatePrintTicket para criar um PrintQueue específico PrintTicket que é válido para uma determinada impressora.

Notas aos Implementadores

CreateVisualsCollator(PrintTicket, PrintTicket) deve retornar uma SerializerWriterCollator gravação que grava na mesma serialização Stream que a que a SerializerWriter cria.