Partilhar via

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

  • Artigo

As exceções não tratadas lançadas por um plug-in são capturadas pelo objetoRealTimeStylus. Quando um plug-in lança uma exceção, o fluxo normal de dados é interrompido. O RealTimeStylus objeto:

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

Se um plug-in lançar 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 Plug-in Data e a classe RealTimeStylus.

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