Méthode IStrokeBuilder ::AppendPackets (rtscom.h)

Article
03/01/2024

Ajoute un paquet à la fin de la liste des paquets d’entrée du numériseur.

Syntaxe

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

Paramètres

[in] tcid

Identificateur de contexte de l’appareil de tablette auquel appartient le stylet.

[in] sid

Identificateur de l’objet stylet.

[in] cPktBuffLength

Nombre de LONGs dans le tableau pPackets et non la taille en octets. Les valeurs valides sont comprises entre 0 et 0x7FFF, inclus.

[in] pPackets

Début des données de paquet. Ce compte est en lecture seule.

Valeur retournée

Pour obtenir une description des valeurs de retour, consultez Classes et interfaces RealTimeStylus.

Remarques

Cette méthode doit être appelée lorsque des paquets de données sont envoyés à la suite du déplacement du stylet pendant qu’il touche ou à portée du numériseur.

Note Les données de paquet entrantes sont au format Himetric et doivent être converties en pixels.

Exemples

L’exemple C++ suivant montre l’implémentation d’une méthode IStylusPlugin ::P ackets Method sur un objet IStylusPlugin Interface . Le plug-in utilise un objet StrokeBuilder pour créer un nouveau trait d’encre. La méthode IStrokeBuilder ::AppendPackets Est appelée à partir de la méthode IStylusPlugin ::P ackets pour ajouter de nouvelles données de paquet à un trait en cours lorsque l’utilisateur fait glisser le stylet sur le numériseur.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablet PC [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	rtscom.h
DLL	RTSCom.dll