IStrokeBuilder-Schnittstelle (rtscom.h)
Verwenden Sie die Schnittstelle, um programmgesteuert Striche aus Paketdaten zu erstellen.
Vererbung
Die IStrokeBuilder-Schnittstelle erbt von der IUnknown-Schnittstelle . IStrokeBuilder verfügt auch über folgende Membertypen:
Methoden
Die IStrokeBuilder-Schnittstelle verfügt über diese Methoden.
| IStrokeBuilder::AppendPackets Fügt am Ende der Eingabepaketliste des Digitizers ein Paket hinzu. |
| IStrokeBuilder::BeginStroke Beginnt einen Strich für ein Freihandobjekt mithilfe von Paketdaten aus einem RealTimeStylus Class-Objekt. |
| IStrokeBuilder::CreateStroke Erstellt Striche für ein Freihandobjekt mithilfe von Paketdaten, die aus einem RealTimeStylus Class-Objekt stammen. |
| IStrokeBuilder::EndStroke Beendet einen Strich und gibt das Strichobjekt zurück. |
| IStrokeBuilder::get_Ink Ruft das Freihandobjekt ab, das dem IStrokeBuilder-Objekt zugeordnet ist, oder legt es fest. |
Hinweise
Diese Schnittstelle wird von der StrokeBuilder-Klasse implementiert.
Die StrokeBuilder-Klasse bietet eine alternative Methode zum Erstellen eines Strichs für Anwendungen, die die Daten verwalten. Es verfügt über Methoden, die über StylusDown-, Packets- und StylusUp-Benachrichtigungen aufgerufen werden können.
Die folgenden beiden Modelle werden unterstützt.
- Konvertieren von benutzerdefinierten Strichinformationen in einen Strich auf atomare Weise mithilfe der IStrokeBuilder::CreateStroke-Methode .
- Erstellen des Strichs mithilfe der Methoden IStrokeBuilder::BeginStroke Method, IStrokeBuilder::AppendPackets Method und IStrokeBuilder::EndStroke Method, die die StylusDown-, Packets- und StylusUp-Benachrichtigungen Spiegel.
Beispiele
Das folgende C++-Beispiel zeigt eine partielle Implementierung einer IStylusPlugin Interface-Klasse . Das Plug-In verwendet ein StrokeBuilder-Objekt , um einen neuen Freihandstrich zu erstellen.
// 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
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | rtscom.h |