IStrokeBuilder::AppendPackets-Methode (rtscom.h)

Artikel
03/01/2024

Fügt am Ende der Eingabepaketliste des Digitizers ein Paket hinzu.

Syntax

HRESULT AppendPackets(
  [in] TABLET_CONTEXT_ID tcid,
  [in] STYLUS_ID         sid,
  [in] ULONG             cPktBuffLength,
  [in] const LONG        *pPackets
);

Parameter

[in] tcid

Der Kontextbezeichner für das Tabletgerät, zu dem der Stift gehört.

[in] sid

Der Bezeichner des Eingabestiftobjekts.

[in] cPktBuffLength

Die Anzahl der LONGs im pPackets-Array , nicht die Größe in Bytes. Gültige Werte liegen zwischen 0 und 0x7FFF einschließlich.

[in] pPackets

Der Start der Paketdaten. Dieses ist schreibgeschützt.

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter RealTimeStylus-Klassen und -Schnittstellen.

Hinweise

Diese Methode sollte aufgerufen werden, wenn Datenpakete gesendet werden, weil sich der Stift bewegt, während er berührt oder sich im Bereich des Digitizers befindet.

Hinweis Die eingehenden Paketdaten haben das Himetric-Format und müssen in Pixel konvertiert werden.

Beispiele

Das folgende C++-Beispiel zeigt die Implementierung einer IStylusPlugin::P ackets Method-Methode für ein IStylusPlugin Interface-Objekt . Das Plug-In verwendet ein StrokeBuilder-Objekt , um einen neuen Freihandstrich zu erstellen. Die IStrokeBuilder::AppendPackets-Methode wird von der IStylusPlugin::P ackets-Methode aufgerufen, um einer gerade ausgeführten Striche neue Paketdaten hinzuzufügen, während der Benutzer den Stift über den Digitizer zieht.

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);
}

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
DLL	RTSCom.dll