SerializerWriter.CreateVisualsCollator Метод

Определение

Пространство имен:

System.Windows.Documents.Serialization

Сборка:

PresentationFramework.dll

При переопределении в производном классе возвращает объект SerializerWriterCollator, который записывает упорядоченные элементы Visual в поток Stream сериализации.

Перегрузки

CreateVisualsCollator()	При переопределении в производном классе возвращает объект SerializerWriterCollator, который записывает упорядоченные элементы Visual.
CreateVisualsCollator(PrintTicket, PrintTicket)	При переопределении в производном классе возвращает объект SerializerWriterCollator, который записывает упорядоченные элементы Visual вместе с данными билетами на печать.

Примеры

В следующем примере показано использование CreateVisualsCollator метода .

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

При переопределении в производном классе возвращает объект SerializerWriterCollator, который записывает упорядоченные элементы 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

Возвращаемое значение

SerializerWriterCollator

Объект SerializerWriterCollator, который записывает упорядоченные элементы Visual в выходной поток Stream сериализации документа.

Примеры

В следующем примере показано использование CreateVisualsCollator метода .

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()должен возвращать SerializerWriterCollator объект , который выполняет запись в ту же сериализацию SerializerWriterStream, что и объект , используемый для ее создания.

CreateVisualsCollator(PrintTicket, PrintTicket)

При переопределении в производном классе возвращает объект SerializerWriterCollator, который записывает упорядоченные элементы Visual вместе с данными билетами на печать.

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

Параметры

documentSequencePT

PrintTicket

Параметры печати по умолчанию для содержимого FixedDocumentSequence.

documentPT

PrintTicket

Параметры печати по умолчанию для содержимого FixedDocument.

Возвращаемое значение

SerializerWriterCollator

Объект SerializerWriterCollator, который записывает упорядоченные элементы Visual в выходной поток Stream сериализации документа.

Примеры

В следующем примере показано использование CreateVisualsCollator метода .

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

Комментарии

documentSequencePT Или documentPT может быть, null если нет предпочтительных параметров печати.

Этот метод не проверяет и не изменяет заданные билеты печати для определенного PrintQueue. При необходимости воспользуйтесь методом PrintQueue.MergeAndValidatePrintTicket, чтобы создать для PrintQueue объект PrintTicket, действительный для заданного принтера.

Примечания для тех, кто реализует этот метод

CreateVisualsCollator(PrintTicket, PrintTicket) должен возвращать объект SerializerWriterCollator , который выполняет запись в ту же сериализацию Stream , что и создаваемый SerializerWriter объект .