创建 ID2D1PrintControl 对象,该对象将存储在 ID2D1CommandList 中的 Direct2D 基元转换为固定页面表示形式。 然后,打印子系统使用基元。
语法
HRESULT CreatePrintControl(
[in] IWICImagingFactory *wicFactory,
[in] IPrintDocumentPackageTarget *documentTarget,
[in, optional] const D2D1_PRINT_CONTROL_PROPERTIES *printControlProperties,
[out] ID2D1PrintControl **printControl
);
参数
[in] wicFactory
类型: IWICImagingFactory*
WIC 映像工厂。
[in] documentTarget
类型: IPrintDocumentPackageTarget*
此控件的目标打印作业。
[in, optional] printControlProperties
类型: const D2D1_PRINT_CONTROL_PROPERTIES*
要应用于打印控件的选项。
[out] printControl
类型: ID2D1PrintControl**
此方法返回时,包含指向 ID2D1PrintControl 对象的指针的地址。
返回值
类型: HRESULT
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
| HRESULT | 说明 |
|---|---|
| S_OK | 未发生错误。 |
| E_OUTOFMEMORY | Direct2D 无法分配足够的内存来完成调用。 |
| E_FAIL | 泛型故障代码。 |
| D2DERR_PRINT_FORMAT_NOT_SUPPORTED | 文档目标不支持打印格式。 |
注解
注意 这是一个阻塞或同步函数,可能不会立即返回。 此函数返回的速度取决于运行时因素(例如网络状态、打印服务器配置和打印机驱动程序实现),这些因素在编写应用程序时难以预测。 从管理与用户界面交互的线程调用此函数可能会使应用程序看起来无响应。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 适用于 Windows 7 的Windows 8和平台更新 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | 适用于 Windows Server 2008 R2 的Windows Server 2012和平台更新 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | d2d1_1.h |
| Library | D2d1.lib |
| DLL | D2d1.dll |