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

Artigo
03/05/2024

Adiciona um pacote ao final da lista de pacotes de entrada do digitalizador.

Sintaxe

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

Parâmetros

[in] tcid

O identificador de contexto para o dispositivo tablet ao qual a caneta pertence.

[in] sid

O identificador do objeto stylus.

[in] cPktBuffLength

O número de LONGs na matriz pPackets não o tamanho em bytes. Os valores válidos estão entre 0 e 0x7FFF, inclusive.

[in] pPackets

O início dos dados do pacote. Ela é somente leitura.

Retornar valor

Para obter uma descrição dos valores retornados, consulte Classes e interfaces RealTimeStylus.

Comentários

Esse método deve ser chamado quando os pacotes de dados são enviados como resultado da movimentação da caneta enquanto ele está tocando ou no intervalo do digitalizador.

Nota Os dados de pacote de entrada estão no formato Himetric e devem ser convertidos em pixels.

Exemplos

O exemplo C++ a seguir mostra a implementação de um método IStylusPlugin::P ackets Method em um objeto IStylusPlugin Interface . O plug-in usa um objeto StrokeBuilder para criar um novo traço de tinta. O método IStrokeBuilder::AppendPackets é chamado do Método IStylusPlugin::P ackets para adicionar novos dados de pacote a um traço em andamento à medida que o usuário arrasta a caneta pelo 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	Valor
Cliente mínimo com suporte	Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	rtscom.h
DLL	RTSCom.dll