FormBrowser Interaction (XForms (Forms Library) - Version 1.2 (Rev. 4) A Graphical User Interface Toolkit for X)

Next: Other FormBrowser Routines, Previous: FormBrowser Types, Up: FormBrowser Object [Contents][Index]

#### 20.2.3 FormBrowser Interaction

Once a formbrowser is populated with forms, you can scroll the forms with the scrollbars and interact with any of the forms. All objects on the forms act, for the most part, the same way as they would if they were on separate forms, i.e., if there are callback functions bound to the objects, they will be invoked by the main loop when the states of the objects change. However, objects on the form that do not have callbacks bound to them will not be returned by `fl_do_forms()` or `fl_check_forms()`.

Your application can be notified about changes of the scrollbars of the formbrowser. To set up under which conditions the application is notified or the formbrowsers callback is invoked (if installed) use

    void fl_set_object_return(FL_OBJECT *obj, unsigned int when);

where the `when` argument can be one of

`FL_RETURN_NONE`

  Never report or invoke callback (this is the default for the formbrowser object)

`FL_RETURN_CHANGED`

  Result in a notification whenever the position of one of the scrollbars has changed.

`FL_RETURN_END_CHANGED`

  Notification is sent if the position of a scrollbar has changed and the mouse button has been released.

`FL_RETURN_END`

  Notification on release of the mouse button.

`FL_RETURN_ALWAYS`

  Notify if the position of a scrollbar has changed or the mouse button has been released.