Compartilhar via

Considerações sobre tratamento de erros para a API StylusInput

  • Artigo

Exceções sem tratamento geradas por um plug-in são capturadas pelo objetoRealTimeStylus. Quando um plug-in gera uma exceção, o fluxo normal de dados é interrompido. O objeto RealTimeStylus:

  1. Cria um objeto ErrorData (no código gerenciado).
  2. Chama o método Error (no código gerenciado, o Microsoft.StylusInput.IStylusSyncPlugin.Error ou Microsoft.StylusInput.IStylusAsyncPlugin.Error método) do plug-in que gerou a exceção.
  3. Chama o método Error dos plug-ins restantes nessa coleção.
  4. Se o plug-in que gerou a exceção for um plug-in síncrono, o objeto ErrorData (no código gerenciado) será adicionado à fila de saída.
  5. O objeto RealTimeStylus retoma o processamento normal dos dados originais.

Se um plug-in gerar uma exceção de seu método Error, o objeto RealTimeStylus captura a exceção, mas não gera um novo objeto ErrorData. Para obter mais informações sobre como ErrorData é adicionado à fila, consulte dados de plug-in e a classe RealTimeStylus.

O objeto RealTimeStylus não para de processar dados do fluxo de dados da caneta tablet quando um de seus plug-ins gera uma exceção. Dependendo do seu design, alguns de seus plug-ins podem precisar assinar o ErrorData notificação e modificar seu comportamento quando ocorrer uma exceção.