Metodo IStrokeBuilder::AppendPackets (rtscom.h)

Articolo
03/05/2024

Aggiunge un pacchetto alla fine dell'elenco di pacchetti di input del digitalizzatore.

Sintassi

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

Parametri

[in] tcid

Identificatore di contesto per il dispositivo tablet a cui appartiene lo stilo.

[in] sid

Identificatore dell'oggetto stilo.

[in] cPktBuffLength

Numero di LONGs nella matrice pPackets non le dimensioni in byte. I valori validi sono compresi tra 0 e 0x7FFF, inclusi.

[in] pPackets

Inizio dei dati del pacchetto. È di sola lettura.

Valore restituito

Per una descrizione dei valori restituiti, vedere Classi e interfacce RealTimeStylus.

Commenti

Questo metodo deve essere chiamato quando i pacchetti di dati vengono inviati come risultato dello spostamento dello stilo mentre tocca o nell'intervallo del digitalizzatore.

Nota I dati dei pacchetti in ingresso sono in formato Himetric e devono essere convertiti in pixel.

Esempio

Nell'esempio C++ seguente viene illustrata l'implementazione di un metodo IStylusPlugin::P ackets in un oggetto IStylusPlugin Interface . Il plug-in usa un oggetto StrokeBuilder per creare un nuovo tratto penna. Il metodo IStrokeBuilder::AppendPackets viene chiamato dal metodo IStylusPlugin::P ackets per aggiungere nuovi dati di pacchetto a un tratto in corso quando l'utente trascina lo stilo nel digitalizzatore.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	rtscom.h
DLL	RTSCom.dll