PrintTaskSourceRequestedHandler 委托
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
当打印任务请求打印文档时发生。 提供的打印文档必须实现 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)参数
指向 PrintTaskSourceRequestedArgs 对象的指针。
- 属性
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 打印示例。