Developer

API Reference

IFOCUSCONTROLLER_MoveFocus()

deprecated
Items marked as deprecated have been replaced by a more powerful, alternative feature. Deprecated interfaces include a reference to the replacement interface, which should be used for all new application development. Deprecated features are still supported for backward compatibility, but should be avoided when developing new applications.
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.
Parameters
  • 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
Comment
None
  • Follow