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

See About this document... for information on suggesting changes.