34.4.2 Form Objects

##
34.4.2 Form Objects

Form objects (returned by `make_form()` above) have the following methods. Each method corresponds to a C function whose name is prefixed with "`fl_`"; and whose first argument is a form pointer; please refer to the official FORMS documentation for descriptions.

All the `add_*()` methods return a Python object representing the FORMS object. Methods of FORMS objects are described below. Most kinds of FORMS object also have some methods specific to that kind; these methods are listed here.

`show_form`( | placement, bordertype, name)

  Show the form.

`hide_form`( | )

  Hide the form.

`redraw_form`( | )

  Redraw the form.

`set_form_position`( | x, y)

  Set the form's position.

`freeze_form`( | )

  Freeze the form.

`unfreeze_form`( | )

  Unfreeze the form.

`activate_form`( | )

  Activate the form.

`deactivate_form`( | )

  Deactivate the form.

`bgn_group`( | )

  Begin a new group of objects; return a group object.

`end_group`( | )

  End the current group of objects.

`find_first`( | )

  Find the first object in the form.

`find_last`( | )

  Find the last object in the form.

`add_box`( | type, x, y, w, h, name)

  Add a box object to the form. No extra methods.

`add_text`( | type, x, y, w, h, name)

  Add a text object to the form. No extra methods.

`add_clock`( | type, x, y, w, h, name)

  Add a clock object to the form.
  Method: `get_clock()`.

`add_button`( | type, x, y, w, h, name)

  Add a button object to the form.
  Methods: `get_button()`, `set_button()`.

`add_lightbutton`( | type, x, y, w, h, name)

  Add a lightbutton object to the form.
  Methods: `get_button()`, `set_button()`.

`add_roundbutton`( | type, x, y, w, h, name)

  Add a roundbutton object to the form.
  Methods: `get_button()`, `set_button()`.

`add_slider`( | type, x, y, w, h, name)

  Add a slider object to the form.
  Methods: `set_slider_value()`, `get_slider_value()`, `set_slider_bounds()`, `get_slider_bounds()`, `set_slider_return()`, `set_slider_size()`, `set_slider_precision()`, `set_slider_step()`.

`add_valslider`( | type, x, y, w, h, name)

  Add a valslider object to the form.
  Methods: `set_slider_value()`, `get_slider_value()`, `set_slider_bounds()`, `get_slider_bounds()`, `set_slider_return()`, `set_slider_size()`, `set_slider_precision()`, `set_slider_step()`.

`add_dial`( | type, x, y, w, h, name)

  Add a dial object to the form.
  Methods: `set_dial_value()`, `get_dial_value()`, `set_dial_bounds()`, `get_dial_bounds()`.

`add_positioner`( | type, x, y, w, h, name)

  Add a positioner object to the form.
  Methods: `set_positioner_xvalue()`, `set_positioner_yvalue()`, `set_positioner_xbounds()`, `set_positioner_ybounds()`, `get_positioner_xvalue()`, `get_positioner_yvalue()`, `get_positioner_xbounds()`, `get_positioner_ybounds()`.

`add_counter`( | type, x, y, w, h, name)

  Add a counter object to the form.
  Methods: `set_counter_value()`, `get_counter_value()`, `set_counter_bounds()`, `set_counter_step()`, `set_counter_precision()`, `set_counter_return()`.

`add_input`( | type, x, y, w, h, name)

  Add a input object to the form.
  Methods: `set_input()`, `get_input()`, `set_input_color()`, `set_input_return()`.

`add_menu`( | type, x, y, w, h, name)

  Add a menu object to the form.
  Methods: `set_menu()`, `get_menu()`, `addto_menu()`.

`add_choice`( | type, x, y, w, h, name)

  Add a choice object to the form.
  Methods: `set_choice()`, `get_choice()`, `clear_choice()`, `addto_choice()`, `replace_choice()`, `delete_choice()`, `get_choice_text()`, `set_choice_fontsize()`, `set_choice_fontstyle()`.

`add_browser`( | type, x, y, w, h, name)

  Add a browser object to the form.
  Methods: `set_browser_topline()`, `clear_browser()`, `add_browser_line()`, `addto_browser()`, `insert_browser_line()`, `delete_browser_line()`, `replace_browser_line()`, `get_browser_line()`, `load_browser()`, `get_browser_maxline()`, `select_browser_line()`, `deselect_browser_line()`, `deselect_browser()`, `isselected_browser_line()`, `get_browser()`, `set_browser_fontsize()`, `set_browser_fontstyle()`, `set_browser_specialkey()`.

`add_timer`( | type, x, y, w, h, name)

  Add a timer object to the form.
  Methods: `set_timer()`, `get_timer()`.

Form objects have the following data attributes; see the FORMS documentation:

Name | C Type | Meaning
--- | --- | ---
`window` | int (read-only) | GL window id
`w` | float | form width
`h` | float | form height
`x` | float | form x origin
`y` | float | form y origin
`deactivated` | int | nonzero if form is deactivated
`visible` | int | nonzero if form is visible
`frozen` | int | nonzero if form is frozen
`doublebuf` | int | nonzero if double buffering on