TapEventArgs

Client code that is triggered by the event and does not want the event to become handled by other handles should set this property to true to stop propagation of the event.

Note that this property needs to be set before the function synchronously returns. This means that setting the value in an async function after the first await or in an asynchronous callback, it cannot not be seen by the emitter of the event and the sender will consider the event as not being handled.

// wrong:
mode.addTappedListener(async (sender, args) => {
  await something()
  args.handled = true // will be set *after* all other event listeners have been invoked, only
})

// correct:
mode.addTappedListener(async (sender, args) => {
  args.handled = true // will be set immediately and 'mode' will see the change
  await something()
})