20.4.2 Oggetti Form

Gli oggetti form (restituiti dalla funzione make_form() descritta in precedenza) hanno i metodi descritti di seguito. Ciascun metodo corrisponde ad una funzione della libreria C il cui nome cominci con "fl_" e che prenda come primo parametro un puntatore ad una form; fare riferimento alla documentazione ufficiale della libreria FORMS per una completa descrizione di queste funzioni.

Tutti i metodi add_*() restituiscono un oggetto Python rappresentante l'oggetto FORMS. I metodi degli oggetti FORMS vengono descritti in seguito. Molti tipi di oggetti FORMS hanno inoltre qualche metodo specifico di quel tipo; tali metodi sono elencati in questa sezione.

show_form( placement, bordertype, name)
Fa apparire il form.

hide_form( )
Nasconde il form.

redraw_form( )
Ridisegna il form.

set_form_position( x, y)
Cambia la posizione del form.

freeze_form( )
Blocca il form.

unfreeze_form( )
Sblocca il form.

activate_form( )
Attiva il form.

deactivate_form( )
Disattiva il form.

bgn_group( )
Inizializza un nuovo gruppo di oggetti; restituisce un oggetto che rappresenta il gruppo.

end_group( )
Pone termine al gruppo di oggetti correntemente utilizzato.

find_first( )
Cerca il primo oggetto nella form.

find_last( )
Cerca l'ultimo oggetto nella form.

add_box( type, x, y, w, h, name)
Aggiunge un oggetto box (NdT: rettangolo) alla form. Non c'è nessun'altro metodo.

add_text( type, x, y, w, h, name)
Aggiunge un oggetto text (NdT:testo) alla form. Non c'è nessun'altro metodo.

add_clock( type, x, y, w, h, name)
Aggiunge un oggetto clock (NdT:orologio) alla form.
Metodo: get_clock().

add_button( type, x, y, w, h, name)
Aggiunge un oggetto button (NdT:bottone) alla form.
Metodi: get_button(), set_button().

add_lightbutton( type, x, y, w, h, name)
Aggiunge un oggetto lightbutton (NdT: bottone leggero) alla form.
Metodi: get_button(), set_button().

add_roundbutton( type, x, y, w, h, name)
Aggiunge un roundbutton (NdT:bottone rotondo) alla form.
Metodi: get_button(), set_button().

add_slider( type, x, y, w, h, name)
Aggiunge un oggetto slider (NdT:cursore a scorrimento) alla form.
Metodi: 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)
Aggiunge un oggetto valslider (NdT:cursore a scorrimento con valore) alla form.
Metodi: 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)
Aggiunge un oggetto dial (NdT:indicatore analogico) alla form.
Metodi: set_dial_value(), get_dial_value(), set_dial_bounds(), get_dial_bounds().

add_positioner( type, x, y, w, h, name)
Aggiunge un oggetto positioner (NdT:posizionatore) alla form.
Metodi: 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)
Aggiunge un oggetto counter (NdT:contatore) alla form.
Metodi: 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)
Aggiunge un oggetto input alla form.
Metodi: set_input(), get_input(), set_input_color(), set_input_return().

add_menu( type, x, y, w, h, name)
Aggiunge un oggetto menu alla form.
Metodi: set_menu(), get_menu(), addto_menu().

add_choice( type, x, y, w, h, name)
Aggiunge un oggetto choice (NdT:selezione) alla form.
Metodi: 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)
Aggiunge un oggetto browser (NdT: selettore) alla form.
Metodi: 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)
Aggiunge un oggetto timer alla form.
Metodi: set_timer(), get_timer().

Gli oggetti form hanno gli attributi elencati di seguito; vedere la documentazione della libreria FORMS per una descrizione più dettagliata.

Nome  Tipo C  Significato 
window int (in sola lettura) Identificativo della finestra GL
w float larghezza della form
h float altezza della form
x float ascissa dall'origine della form
y float ordinata dall'origine della form
deactivated int è diversa da zero se la form è disattivata
visible int è diverso da zero se la form è visible
frozen int è diverso da zero se la form è bloccata
doublebuf int è diverso da zero se il doppio buffering è attivo

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.