iStrokeBuilder 接口 (rtscom.h)
使用 接口以编程方式从数据包数据创建笔划。
继承
IStrokeBuilder 接口继承自 IUnknown 接口。 IStrokeBuilder 还具有以下类型的成员：
方法
IStrokeBuilder 接口包含以下方法。
| IStrokeBuilder：：AppendPackets 将数据包添加到数字化器输入数据包列表的末尾。 |
| IStrokeBuilder：：BeginStroke 通过使用 RealTimeStylus 类对象中的数据包数据在墨迹对象上开始笔划。 |
| IStrokeBuilder：：CreateStroke 使用来自 RealTimeStylus 类对象的数据包数据在墨迹对象上创建笔划。 |
| IStrokeBuilder：：EndStroke 结束笔划并返回笔划对象。 |
| IStrokeBuilder：：get_Ink 获取或设置与 IStrokeBuilder 对象关联的墨迹对象。 |
注解
此接口由 StrokeBuilder 类实现。
StrokeBuilder 类为管理数据的应用程序提供了创建笔划的替代方法。 它具有可从 StylusDown、 Packets 和 StylusUp 通知调用的方法。
支持以下两种模型。
- 使用 IStrokeBuilder：：CreateStroke 方法 方法以原子方式将自定义笔划信息转换为笔划。
- 使用 IStrokeBuilder：：BeginStroke 方法、IStrokeBuilder：：AppendPackets 方法和IStrokeBuilder：：EndStroke 方法生成笔划，这些方法镜像 StylusDown、Packets 和 StylusUp 通知。
示例
下面的 C++ 示例演示 了 IStylusPlugin 接口 类的部分实现。 插件使用 StrokeBuilder 对象创建新的墨迹笔划。
// CStrokeBuilderPlugin
// Helper functions
HRESULT CStrokeBuilderPlugin::GetInk(IInkDisp** pInk)
{
return m_pStrokeBuilder->get_Ink(pInk);
}
// IStylusAsyncPlugin Interface implementation
STDMETHODIMP CStrokeBuilderPlugin::RealTimeStylusEnabled(
/* [in] */ IRealTimeStylus *piRtsSrc,
/* [in] */ ULONG cTcidCount,
/* [size_is][in] */ const TABLET_CONTEXT_ID *pTcids)
{
// Create an IStrokeBuilder object
return CoCreateInstance(CLSID_StrokeBuilder, NULL, CLSCTX_INPROC, IID_IStrokeBuilder, (VOID **)&m_pStrokeBuilder);
}
STDMETHODIMP CStrokeBuilderPlugin::DataInterest(
/* [retval][out] */ RealTimeStylusDataInterest *pDataInterest)
{
// Set up the messages we want to receive
*pDataInterest = (RealTimeStylusDataInterest)(RTSDI_StylusDown | RTSDI_Packets |
RTSDI_StylusUp | RTSDI_Error);
return S_OK;
}
STDMETHODIMP CStrokeBuilderPlugin::StylusDown(
/* [in] */ IRealTimeStylus *piRtsSrc,
/* [in] */ const StylusInfo *pStylusInfo,
/* [in] */ ULONG cPropCountPerPkt,
/* [size_is][in] */ LONG *pPacket,
/* [out][in] */ LONG **ppInOutPkt)
{
FLOAT fInkToDeviceScaleX;
FLOAT fInkToDeviceScaleY;
ULONG cPacketProperties;
PACKET_PROPERTY* pPacketProperties;
// Get the info we need to call BeginStroke
HRESULT hr = piRtsSrc->GetPacketDescriptionData(pStylusInfo->tcid, &fInkToDeviceScaleX, &fInkToDeviceScaleY,
&cPacketProperties, &pPacketProperties);
if (SUCCEEDED(hr))
{
// Start creating the stroke
hr = m_pStrokeBuilder->BeginStroke(pStylusInfo->tcid, pStylusInfo->cid, pPacket, cPropCountPerPkt,
pPacketProperties, fInkToDeviceScaleX, fInkToDeviceScaleY, &m_piStroke);
}
return hr;
}
STDMETHODIMP CStrokeBuilderPlugin::Packets(
/* [in] */ IRealTimeStylus *piRtsSrc,
/* [in] */ const StylusInfo *pStylusInfo,
/* [in] */ ULONG cPktCount,
/* [in] */ ULONG cPktBuffLength,
/* [size_is][in] */ LONG *pPackets,
/* [out][in] */ ULONG *pcInOutPkts,
/* [out][in] */ LONG **ppInOutPkts)
{
// Add packet to the stroke
return m_pStrokeBuilder->AppendPackets(pStylusInfo->tcid, pStylusInfo->cid, cPktBuffLength, pPackets);
}
STDMETHODIMP CStrokeBuilderPlugin::StylusUp(
/* [in] */ IRealTimeStylus *piRtsSrc,
/* [in] */ const StylusInfo *pStylusInfo,
/* [in] */ ULONG cPropCountPerPkt,
/* [size_is][in] */ LONG *pPacket,
/* [out][in] */ LONG **ppInOutPkt)
{
// Finish the stroke. This adds the stroke to the StrokeBuilder's Ink object.
return m_pStrokeBuilder->EndStroke(pStylusInfo->tcid, pStylusInfo->cid, &m_piStroke, NULL);
}
STDMETHODIMP CStrokeBuilderPlugin::Error(
/* [in] */ IRealTimeStylus *piRtsSrc,
/* [in] */ IStylusPlugin *piPlugin,
/* [in] */ RealTimeStylusDataInterest dataInterest,
/* [in] */ HRESULT hrErrorCode,
/* [out][in] */ LONG_PTR *lptrKey)
{
CString strError;
strError.Format(L"An error occurred. Error code: %d", hrErrorCode);
TRACE(strError);
return S_OK;
}
// The remaining interface methods are not used
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP Tablet PC Edition [仅限桌面应用] |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | rtscom.h |