IStrokeBuilder-Schnittstelle (rtscom.h)

Artikel
03/04/2024

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

Weitere Informationen

DynamicRenderer-Klasse

IStrokeBuilder-Schnittstelle

RealTimeStylus-Klasse

RealTimeStylus-Klassen und -Schnittstellen

Freigeben über