Focusable.delegatesFocus

Description

Whether the element should delegate the focus to its children.

If the element delegates its focus, when it would become focused, one of its child or recursive child elements is selected to receive focus in its place. The element that receives the focus cannot be chosen manually. Instead, it is determined automatically using a set of internal rules.

The chosen element will be the first child or recursive child that

• can be focused (see Focusable.canGrabFocus,
• does not delegate its own focus,
• is not the child or recursive child of a content container or of another element that delegates focus, and
• is part of the focus ring navigation sequence (see IFocusRing).

Additional resources: Focusable.canGrabFocus, VisualElement.contentContainer, IFocusRing