SerializerWriter.CreateVisualsCollator Método

Definição

Quando sobrescrito numa classe derivada, devolve um SerializerWriterCollator que escreve elementos agrupados Visual na serialização Stream.

Sobrecargas

Name Description
CreateVisualsCollator()

Quando sobrescrito numa classe derivada, retorna um SerializerWriterCollator que escreve elementos coleados Visual .

CreateVisualsCollator(PrintTicket, PrintTicket)

Quando sobrescrito numa classe derivada, devolve um SerializerWriterCollator que escreve elementos coleados Visual juntamente com os bilhetes de impressão fornecidos.

Exemplos

O exemplo seguinte mostra a utilização 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 sobrescrito numa classe derivada, retorna um SerializerWriterCollator que escreve elementos coleados Visual .

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

Devoluções

A SerializerWriterCollator que escreve elementos agrupados Visual na serialização Streamde saída do documento .

Exemplos

O exemplo seguinte mostra a utilização 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 para Implementadores

CreateVisualsCollator() deve devolver a SerializerWriterCollator que escreve na mesma serialização Stream que o SerializerWriter que é usado para a criar.

Aplica-se a

CreateVisualsCollator(PrintTicket, PrintTicket)

Quando sobrescrito numa classe derivada, devolve um SerializerWriterCollator que escreve elementos coleados Visual juntamente com os bilhetes 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 padrão de impressão para FixedDocumentSequence conteúdo.

documentPT
PrintTicket

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

Devoluções

A SerializerWriterCollator que escreve elementos agrupados Visual na serialização Streamde saída do documento .

Exemplos

O exemplo seguinte mostra a utilização 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

Observações

documentSequencePT ou documentPT pode ser null , se não existirem definições de impressão preferidas.

Este método não valida nem modifica os bilhetes impressos dados para um determinado PrintQueue. Se necessário, use o PrintQueue.MergeAndValidatePrintTicket método para criar um PrintQueue-específico PrintTicket que seja válido para uma determinada impressora.

Notas para Implementadores

CreateVisualsCollator(PrintTicket, PrintTicket) deve devolver a SerializerWriterCollator que escreve na mesma serialização Stream que o SerializerWriter que o cria.

Aplica-se a