ID2D1Device::CreatePrintControl (IWICImagingFactory*,IPrintDocumentPackageTarget*,constD2D1_PRINT_CONTROL_PROPERTIES&,ID2D1PrintControl**) 方法 (d2d1_1.h)

创建一个 ID2D1PrintControl 对象,该对象将存储在 ID2D1CommandList 中的 Direct2D 基元转换为固定页面表示形式。 然后,打印子系统使用基元。

语法

HRESULT CreatePrintControl(
  [in]                IWICImagingFactory                    *wicFactory,
  [in]                IPrintDocumentPackageTarget           *documentTarget,
  [in, ref, optional] const D2D1_PRINT_CONTROL_PROPERTIES & printControlProperties,
  [out]               ID2D1PrintControl                     **printControl
);

参数

[in] wicFactory

类型: IWICImagingFactory*

WIC 映像工厂。

[in] documentTarget

类型: IPrintDocumentPackageTarget*

此控件的目标打印作业。

[in, ref, 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

另请参阅

ID2D1Device