Advance the keyboard-focus to the next graphical
object of this device for which the test graphical->_wants_keyboard_focus
succeeds. Used by text_item to implement text_item->advance.
This method cycles through the device<-graphicals
chain. If the argument is a graphical and there is no graphical that
requests the keyboard focus further down the device<-graphicals
chain and the device is not the window itself, and propagate
not is @off,
it will invoke device->advance
on its graphical<-device,
passing itself as argument. This behaviour allows for handling the
keyboard focus in dialog-windows built from nested devices.
Otherwise, If no graphical wants to have the keyboard focus, the
keyboard focus of the graphical<-window
is set to @nil.
Defaults: If graphical is @default,
the first graphical accepting
device->_wants_keyboard_focus is given the
focus.
- See also
- - text_item
->_wants_keyboard_focus
- text_item-advance
- window->keyboard_focus
