通过

PrintTaskSourceRequestedHandler 委托

  • 参考

定义

命名空间:
Windows.Graphics.Printing
编辑

当打印任务请求打印文档时发生。 提供的打印文档必须实现 IPrintDocumentSource 接口。

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)

参数

args
PrintTaskSourceRequestedArgs

指向 PrintTaskSourceRequestedArgs 对象的指针。

属性
ContractVersionAttribute GuidAttribute

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

调用 PrintTaskSourceRequestedHandler 以完成 PrintTask 对象的初始化。 此两阶段初始化模型旨在使应用通过创建 PrintTask 对象来快速响应 PrintTaskRequested 事件。 然后，当实际调用打印时， PrintTaskSourceRequestedHandler 执行准备要预览并最终打印的内容所需的工作。 在 PrintTaskSourceRequestedHandler 中完成工作的截止时间远远大于 在 PrintTaskRequested 处理程序中完成工作的截止时间。

例如，假设某个应用需要从云下载信息，以完成打印操作以获取登机牌的详细信息。 应用应通过创建 PrintTask 对象和打印操作的名称（例如“Fabrikam 登机牌”）来快速响应 PrintTaskRequested 事件。然后，应用为 PrintTaskSourceRequestedHandler 提供一个指针 ，即 PrintTask 对象。 调用此处理程序时，应用会启动调用以检索登机牌的实际内容，以便可以执行打印预览和打印。

应用有两个选项用于创建打印文档源对象：

  • 使用框架提供的打印文档源。 HTML5/JavaScript 和 XAML 框架都提供实现 IPrintDocumentSource 接口的 对象的实现。 有关 HTML5/JavaScript 应用，请参阅 MSApp.getHtmlPrintDocumentSource。 有关使用可扩展应用程序标记语言 (XAML) 开发支持打印的应用的信息，请参阅 Windows.UI.Xaml.Printing.PrintDocument。
  • 提供自定义打印文档源。 应用可以选择提供自己的 IPrintDocumentSource 对象的自定义实现。 这样做需要充分了解 Direct2D 和/或 XPS API。 有关应用如何提供其自己的自定义打印文档源的示例，请参阅 D2D 打印示例。

适用于

另请参阅