VisualsToXpsDocument 類別

定義

命名空間:

System.Windows.Xps

組件:

System.Printing.dll

提供以批次模式將 Visual 物件寫入 XML 文件規格 (XPS) 文件或列印佇列的方法。

public ref class VisualsToXpsDocument : System::Windows::Documents::Serialization::SerializerWriterCollator

public class VisualsToXpsDocument : System.Windows.Documents.Serialization.SerializerWriterCollator

type VisualsToXpsDocument = class
    inherit SerializerWriterCollator

Public Class VisualsToXpsDocument
Inherits SerializerWriterCollator

繼承

Object

SerializerWriterCollator

VisualsToXpsDocument

範例

下列範例示範如何建立視覺效果定序器，並用它來寫入 XML 紙張規格 (XPS) 檔。

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 方法來建立 實例。

寫入 VisualsToXpsDocument 至相同目標 XpsDocument 或 PrintQueue XpsDocumentWriter 建立 的 VisualsToXpsDocument 。

每 Visual 一個都會變成檔中的頁面。

方法

BeginBatchWrite()	表示可以開始寫入作業。
Cancel()	取消同步寫入作業。
CancelAsync()	取消非同步寫入作業。
EndBatchWrite()	表示必須結束寫入作業。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
Write(Visual)	以同步方式將 Visual 寫入 XpsDocument 或 PrintQueue。
Write(Visual, PrintTicket)	以同步方式將 Visual 寫入 XpsDocument 或 PrintQueue 並包含 PrintTicket。
WriteAsync(Visual)	以非同步方式將 Visual 寫入至 XpsDocument 或 PrintQueue。
WriteAsync(Visual, Object)	將 Visual 以非同步方式寫入 XpsDocument 或 PrintQueue，並包含呼叫端要傳遞至事件處理常式的其他資訊。
WriteAsync(Visual, PrintTicket)	以非同步方式將 Visual 寫入 XpsDocument 或 PrintQueue 並包含 PrintTicket。
WriteAsync(Visual, PrintTicket, Object)	將 Visual 以非同步方式寫入 XpsDocument 或 PrintQueue，同時包含 PrintTicket，以及呼叫端要傳遞至事件處理常式的任何其他資訊。