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 в ту же сериализацию Stream , что и для SerializerWriter создания.

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 и создается.