NavigationEventCallback

open fun onEventCancelled(): Unit

Callback for handling NavigationEventDispatcher.dispatchOnCancelled.

open fun onEventCompleted(): Unit

Callback for handling NavigationEventDispatcher.dispatchOnCompleted.

open fun onEventProgressed(event: NavigationEvent): Unit

Callback for handling NavigationEventDispatcher.dispatchOnProgressed.

open fun onEventStarted(event: NavigationEvent): Unit

Callback for handling NavigationEventDispatcher.dispatchOnStarted.

fun remove(): Unit

Removes this callback from the NavigationEventDispatcher it is registered with. If the callback is not registered, this call does nothing.

fun setInfo(currentInfo: T, previousInfo: T?): Unit

Updates the current and previous navigation information for this callback.

This method updates the callback's local info and then notifies the central NavigationEventProcessor. The processor is responsible for deciding whether to update the global navigation state, ensuring that only the highest-priority callback can influence the state.

var isEnabled: Boolean

Controls whether this callback is active and should be considered for event dispatching.

A callback's effective enabled state is hierarchical; it is directly influenced by the NavigationEventDispatcher it is registered with.

Getting the value:

• This will return false if the associated dispatcher exists and its isEnabled state is false, regardless of the callback's own local setting. This provides a powerful mechanism to disable a whole group of callbacks at once by simply disabling their dispatcher.

• Otherwise, it returns the callback's own locally stored state.

Setting the value:

• This updates the local enabled state of the callback itself.

• More importantly, it immediately notifies the dispatcher (if one is attached) that its list of enabled callbacks might have changed, prompting a re-evaluation. This ensures the system's state remains consistent and responsive to changes.

For a callback to be truly active, both its local isEnabled property and its dispatcher's isEnabled property must evaluate to true.