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.