Package com.iizix.gyro
Interface IFocusVetoListener
- Functional Interface:
- This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
The veto focus listener interface that is called when the focus engine changes focus component.
Focus processing is done in the following order:
- Focus is changed in the focus engine without notification, i.e. the call to
IFocusEngine.getCurrentFocus()
will reflect the new focus component,
- If the receiving focus component is non-null: focus veto processing using the focus listeners registered in the
IFocusEngine
using theIFocusVetoListener
interface. If theFocusVetoException
is thrown, the original focus is restored in the focus engine without notification.
- Focus lost sent to the component losing focus using method
IFocusComp.onFocusLost(IFocusComp, IGProp, boolean)
in the eventFocusEvent
.
- Focus lost is notified in a bubbling event
PropFocusEvent
to the component losing focus and its parents. withPropFocusEvent.isFocusLost()
true
.
- Focus lost is notified in a sinking event
PropCnrFocusEvent
to the component losing focus and its descendants withPropCnrFocusEvent.isFocusLost()
true
.
- Focus change sent to the focus listeners registered in the
IFocusEngine
usingIFocusListener.onFocusChanged(FocusEvent)
.
- Focus gained sent to the component gaining focus using method
IFocusComp.onFocusGained(IFocusComp, IGProp, boolean)
in the eventFocusEvent
.
- Focus gained is notified in a bubbling event
PropFocusEvent
to the component gaining focus and its parents. withPropFocusEvent.isFocusGained()
true
.
- Focus gained is notified in a sinking event
PropCnrFocusEvent
to the component gaining focus and its descendants withPropCnrFocusEvent.isFocusGained()
true
.
- Author:
- Christopher Mindus
Method Summary
Modifier and TypeMethodDescriptionvoid
onFocusVetoChanged
(FocusEvent event) Called when the focus is changed.
Method Details
onFocusVetoChanged
Called when the focus is changed.- Parameters:
event
- The focus event.- Throws:
FocusVetoException
- If focus change is vetoed.