PrintTaskSourceRequestedHandler 代理人

定義

public delegate void PrintTaskSourceRequestedHandler(PrintTaskSourceRequestedArgs ^ args);

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1813028776, 23734, 19258, 134, 99, 243, 156, 176, 45, 201, 180)]
class PrintTaskSourceRequestedHandler : MulticastDelegate

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(1813028776, 23734, 19258, 134, 99, 243, 156, 176, 45, 201, 180)]
public delegate void PrintTaskSourceRequestedHandler(PrintTaskSourceRequestedArgs args);

var printTaskSourceRequestedHandlerHandler = function(args){
/* Your code */
}

Public Delegate Sub PrintTaskSourceRequestedHandler(args As PrintTaskSourceRequestedArgs)

參數

屬性

ContractVersionAttribute GuidAttribute

Windows 需求

備註

呼叫 PrintTaskSourceRequestedHandler 以完成 PrintTask 物件的初始化。 這個雙階段初始化模型的設計目的是要藉由建立PrintTask物件，讓應用程式快速回應PrintTaskRequested事件。 之後，實際叫用列印時， PrintTaskSourceRequestedHandler 會執行準備要預覽及最終列印之內容所需的工作。 在 PrintTaskSourceRequestedHandler 中完成工作的期限遠大於 在 PrintTaskRequested 處理常式中完成工作的期限。

例如，假設應用程式需要從雲端下載資訊，才能完成列印工作，以取得上線卡的詳細資料。 應用程式應該藉由建立PrintTask物件和列印工作的名稱，例如「Fabrikam Boarding Pass」，快速回應PrintTaskRequested事件。然後，應用程式會提供 PrintTaskSourceRequestedHandler 與PrintTask物件的指標。 叫用此處理程式時，應用程式會起始呼叫以擷取上線階段的實際內容，以便執行預覽列印和列印。

應用程式有兩個選項可用來建立列印文檔來源物件：

• 使用提供的架構列印文檔來源。 HTML5/JavaScript 和 XAML 架構都提供實作 IPrintDocumentSource 介面的物件實作。 如需 HTML5/JavaScript 應用程式，請參閱 MSApp.getHtmlPrintDocumentSource。 如需使用可延伸應用程式標記語言開發可延伸應用程式 (XAML) 的相關資訊，請參閱 Windows.UI.Xaml.Printing.PrintDocument。
• 提供自訂列印文檔來源。 應用程式可以選擇提供自己的 IPrintDocumentSource 物件的自訂實作。 這樣做需要充分瞭解 Direct2D 和/或 XPS API。 如需應用程式如何提供自己的自訂列印文檔來源的範例，請參閱 D2D 列印範例。

適用於

另請參閱

• PrintTaskRequested
• PrintTaskSourceRequestedArgs
• PrintTask
• IPrintDocumentSource
• PrintDocument
• MSApp.getHtmlPrintDocumentSource