IXpsOMObjectFactory：：CreateGeometryFigure 方法 (xpsobjectmodel.h)

项目
03/05/2024

创建 IXpsOMGeometryFigure 接口，该接口指定由 IXpsOMGeometry 接口定义的对象的一部分。

语法

HRESULT CreateGeometryFigure(
  [in]          const XPS_POINT      *startPoint,
  [out, retval] IXpsOMGeometryFigure **figure
);

参数

[in] startPoint

几何图形起点的坐标。

[out, retval] figure

指向新的 IXpsOMGeometryFigure 接口的指针。

返回值

该方法返回 HRESULT。可能的值包括但不限于下表中的值。有关此表中未列出的 XPS 文档 API 返回值的信息，请参阅 XPS 文档错误。

返回代码	说明
S_OK	方法成功。
E_POINTER	startPoint 或 figure 为 NULL。
XPS_E_INVALID_FLOAT	在 startPoint 中传递的 XPS_POINT 结构中的一个字段包含无效的值。

注解

下面的代码示例演示了如何使用此方法创建新接口。


IXpsOMGeometryFigure    *newInterface;
// startPoint contains the starting point
// of the geometry figure being created
XPS_POINT                startPoint = {0,0};

// Note the implicit requirement that CoInitializeEx 
//  has previously been called from this thread.

hr = CoCreateInstance(
    __uuidof(XpsOMObjectFactory),
    NULL,
    CLSCTX_INPROC_SERVER,
    _uuidof(IXpsOMObjectFactory),
    reinterpret_cast<LPVOID*>(&xpsFactory)
    );

if (SUCCEEDED(hr))
{
    hr = xpsFactory->CreateGeometryFigure (&startPoint, &newInterface);
    if (SUCCEEDED(hr))
    {
        // use newInterface

        newInterface->Release();
    }
    xpsFactory->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

要求

要求	值
最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 \|UWP 应用]
目标平台	Windows
标头	xpsobjectmodel.h