IStrokeBuilder ::BeginStroke, méthode (rtscom.h)

Article
03/13/2024

Commence un trait sur un objet ink à l’aide des données de paquets d’un objet Classe RealTimeStylus .

Syntaxe

HRESULT BeginStroke(
  [in]      TABLET_CONTEXT_ID tcid,
  [in]      STYLUS_ID         sid,
  [in]      const LONG        *pPacket,
  [in]      ULONG             cPacketProperties,
  [in]      PACKET_PROPERTY   *pPacketProperties,
  [in]      FLOAT             fInkToDeviceScaleX,
  [in]      FLOAT             fInkToDeviceScaleY,
  [in, out] IInkStrokeDisp    **ppIInkStroke
);

Paramètres

[in] tcid

Identificateur de contexte de la tablette.

[in] sid

Identificateur du stylet.

[in] pPacket

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

[in] cPacketProperties

Nombre de LONG, qui correspond au nombre de paquets multiplié par le nombre de propriétés, dans la mémoire tampon pPacketProperties .

[in] pPacketProperties

Mémoire tampon contenant les propriétés du paquet.

[in] fInkToDeviceScaleX

Facteur de conversion horizontal, ou axe x, pour l’axe horizontal, de l’espace d’entrée manuscrite aux coordonnées du numériseur.

[in] fInkToDeviceScaleY

Facteur de conversion vertical, ou axe y, pour l’axe vertical, de l’espace d’entrée manuscrite aux coordonnées du numériseur.

[in, out] ppIInkStroke

Pointeur vers le nouveau trait. Cette valeur peut être NULL.

Valeur retournée

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

Remarques

Utilisé conjointement avec les méthodes IStrokeBuilder ::AppendPackets, méthode et IStrokeBuilder ::EndStroke, méthode . La méthode IStrokeBuilder ::BeginStroke commence à générer le trait. À mesure que le mouvement continue et que des paquets supplémentaires sont reçus, la méthode IStrokeBuilder ::AppendPackets Method ajoute ces données de trait supplémentaires. Lorsque le stylet de la tablette est levé à partir de la surface et qu’il n’y a plus de paquets entrants, la méthode IStrokeBuilder ::EndStroke Method est appelée.

Exemples

L’exemple C++ suivant montre l’implémentation d’une méthode IStylusPlugin ::StylusDown 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 ::BeginStroke Method est appelée à partir de la méthode IStylusPlugin ::StylusDown pour lancer la construction d’un trait.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablette 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