Considerações de Encadeamento para a API "StylusInput"

O objeto RealTimeStylus foi projetado para fornecer acesso em tempo real ao fluxo de dados da caneta eletrônica. Plug-ins, objetos que implementam a interface IStylusSyncPlugin ou a interface IStylusAsyncPlugin podem ser adicionados a um objeto RealTimeStylus . Os plug-ins síncronos geralmente são chamados diretamente pelo objeto RealTimeStylus em um thread de alta prioridade, enquanto os plug-ins assíncronos geralmente são chamados no thread da interface do usuário (UI) do aplicativo. Crie ou use plug-ins síncronos para tarefas que exigem acesso em tempo real ao fluxo de dados e são computacionalmente pouco exigentes, como filtragem de pacotes. Crie ou use plug-ins assíncronos para tarefas que não exigem acesso em tempo real ao fluxo de dados, como coleta de tinta.

Como os dados de plug-in para a coleção de plug-ins assíncronos do objeto RealTimeStylus estão enfileirados, os plug-ins assíncronos podem receber dados antes de receber uma chamada para seu método RealTimeStylusDisabled, mas depois que o objeto RealTimeStylus estiver desabilitado. Observe que alguns dos métodos e propriedades do objeto RealTimeStylus lançam uma exceção se o objeto RealTimeStylus estiver desabilitado.

Os seguintes IStylusSyncPlugin métodos de interface podem chamar um thread diferente do thread de dados da caneta tablet.

• Os métodos RealTimeStylusEnabled e RealTimeStylusDisabled são chamados no thread que atualiza a propriedade Enabled do objeto RealTimeStylus ou que adiciona ou remove o plug-in enquanto o objeto RealTimeStylus está habilitado.
• O método CustomStylusDataAdded é chamado na thread que aciona o método AddCustomStylusDataToQueue do objeto RealTimeStylus.
• O método Error é chamado no thread no qual o plug-in síncrono está sendo executado quando ele lança uma exceção.

Para interagir com seu aplicativo a partir de um plug-in síncrono, use o método AddCustomStylusDataToQueue do objeto RealTimeStylus e manipule os dados da caneta personalizada em um de seus plug-ins assíncronos. Se você fizer uma chamada síncrona para outro thread a partir de um plug-in síncrono, poderá bloquear o objeto RealTimeStylus e, assim, bloquear a coleta de tinta.

Certas tarefas podem ser computacionalmente exigentes, mas ainda exigem acesso em tempo real ao fluxo de dados da caneta do tablet, como para reconhecimento de gestos multi-traço. As APIs StylusInput fornecem um modelo RealTimeStylus em cascata que permite usar dois objetos RealTimeStylus, cada um chamando os seus plug-ins síncronos a partir de diferentes threads. Para obter mais informações sobre o modelo em cascata de RealTimeStylus, consulte O Modelo em Cascata de RealTimeStylus.

Para obter mais informações sobre considerações de threads para o Tablet PC em geral, consulte Considerações sobre threads do Tablet PC