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

Artículo
03/09/2024

Agrega un paquete al final de la lista de paquetes de entrada del digitalizador.

Sintaxis

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

Parámetros

[in] tcid

Identificador de contexto del dispositivo de tableta al que pertenece el lápiz óptico.

[in] sid

Identificador del objeto de lápiz óptico.

[in] cPktBuffLength

El número de LONG de la matriz pPackets no es el tamaño en bytes. Los valores válidos están comprendidos entre 0 y 0x7FFF, ambos incluidos.

[in] pPackets

Inicio de los datos del paquete. Es de solo lectura.

Valor devuelto

Para obtener una descripción de los valores devueltos, vea RealTimeStylus Classes and Interfaces (Clases e interfaces de RealTimeStylus).

Comentarios

Se debe llamar a este método cuando se envían paquetes de datos como resultado del movimiento del lápiz óptico mientras está tocando o en el intervalo del digitalizador.

Nota Los datos de paquete entrantes están en formato Himetric y deben convertirse en píxeles.

Ejemplos

En el siguiente ejemplo de C++ se muestra la implementación de un método IStylusPlugin::P ackets en un objeto IStylusPlugin Interface . El complemento usa un objeto StrokeBuilder para crear un nuevo trazo de lápiz. Se llama al método IStrokeBuilder::AppendPackets Method desde IStylusPlugin::P ackets Method para agregar nuevos datos de paquetes a un trazo en curso a medida que el usuario arrastra el lápiz óptico a través del digitalizador.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	rtscom.h
Archivo DLL	RTSCom.dll