API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

IFOCUSCONTROLLER_MOVEFOCUS()

Brew Release
Brew MP 1.0.2
See Also
None
Description
Attempts to move focus to the target widget. When a focus move is attempted the appropriate focus handlers are notified. It is possible that one of the focus handlers denies the focus movement (example a viewport may not want to pass focus to a widget that is not currently visible). If a focus move is carried out the current focus node is sent a EVT_TRIGML_INVFOCUS event then widget focus is moved to the target and then an EVT_TRIGML_FOCUS event is sent to the target.
Params
po
[]:
Pointer to the IFocusController interface object
commonParent
[]:
The common parent of the currentFocusLeaf node and the target node. Can be NULL.
target
[]:
Widget to receive trigml focus
force
[]:
If TRUE means that the focus handler is not allowed to handle or deny the focus movement.
Interface
  • IFOCUSCONTROLLER
Prototype
  •    boolean IFOCUSCONTROLLER_MoveFocus(IFocusController * po, 
                                     IContainer * commonParent, 
                                     IWidget * target, 
                                     boolean force)
    
Return
  •    TRUE if the focus move was handled, false otherwise. When a focus move is 
       handled it does not necessarily mean that the focus was moved to the target. 
       It means that either the focus was moved or the focus movement was handled 
       by one of the focus handlers. 
    
Side Effect
  • None
Comments
None