BUTTON BOX E TOOLBAR

 

Button boxes.

Le button boxes rappresentano un modo conveniente per gestire un gruppo di bottoni.
Possono assumere la forma orizzontale e verticale.
Per creare una nuova button box useremo:

GtkWidget *gtk_hbutton_box_new( void );

per una b.b. orizzontale e:

GtkWidget *gtk_vbutton_box_new( void );

per una b.b. verticale

Possiamo cambiare lo spazio tra i bottoni con la funzione:

void gtk_hbutton_box_set_spacing_default( gint spacing );

void gtk_vbutton_box_set_spacing_default( gint spacing );

Mentre possiamo ricavare la distanza corrente con:

gint gtk_hbutton_box_get_spacing_default( void );

gint gtk_vbutton_box_get_spacing_default( void );

Possiamo inoltre cambiare il layout con:

void gtk_hbutton_box_set_layout_default( GtkButtonBoxStyle layout );

void gtk_vbutton_box_set_layout_default( GtkButtonBoxStyle layout );

L'argomento layout può assumere una delle seguenti forme:

GTK_BUTTONBOX_DEFAULT_STYLE
GTK_BUTTONBOX_SPREAD
GTK_BUTTONBOX_EDGE
GTK_BUTTONBOX_START
GTK_BUTTONBOX_END

Il layout corrente può essere invece ricavato con:

GtkButtonBoxStyle gtk_hbutton_box_get_layout_default( void );

GtkButtonBoxStyle gtk_vbutton_box_get_layout_default( void );

I Bottoni saranno aggiunti alla b.b. con la solita funzione:

gtk_container_add( GTK_CONTAINER(button_box), child_widget );

 

 

TOOLBAR

Toolbar (barra degli strumenti è usata per raggruppare un certo numero di oggetti (tipicamente bottoni con icone, ma anche etichette combo etc...).

Si può creare una nuova toolbar con la funzione:

GtkWidget *gtk_toolbar_new( GtkOrientation orientation,
GtkToolbarStyle style );

Dove l'where orientation può essere::

GTK_ORIENTATION_HORIZONTAL
GTK_ORIENTATION_VERTICAL

e lo style:

GTK_TOOLBAR_TEXT
GTK_TOOLBAR_ICONS
GTK_TOOLBAR_BOTH

Lo stile viene applicato ai bottoni creati con la funzione item.

Dopo aver creato la toolbar vi si possono inserire item (bottoni) o altri widget.

Ecco le funzioni che inseriscono l'item all'inizio o alla fine:

GtkWidget *gtk_toolbar_append_item( GtkToolbar *toolbar,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
GtkWidget *icon,
GtkSignalFunc callback,
gpointer user_data );

GtkWidget *gtk_toolbar_prepend_item( GtkToolbar *toolbar,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
GtkWidget *icon,
GtkSignalFunc callback,
gpointer user_data );

Questa invece lo inserisce alla posizione specificata:

GtkWidget *gtk_toolbar_insert_item( GtkToolbar *toolbar,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
GtkWidget *icon,
GtkSignalFunc callback,
gpointer user_data,
gint position );

Per inserire spazi tra gli item useremo invece:

void gtk_toolbar_append_space( GtkToolbar *toolbar );

void gtk_toolbar_prepend_space( GtkToolbar *toolbar );

void gtk_toolbar_insert_space( GtkToolbar *toolbar,
gint position );

La misura degli spazi può essere cambiata globalmente con la funzione:

void gtk_toolbar_set_space_size( GtkToolbar *toolbar,
gint space_size) ;

Inoltre l'orientamento e lo style della toolbar può essere cambiato `on the fly' con la funzione:

void gtk_toolbar_set_orientation( GtkToolbar *toolbar,
GtkOrientation orientation );

void gtk_toolbar_set_style( GtkToolbar *toolbar,
GtkToolbarStyle style );

void gtk_toolbar_set_tooltips( GtkToolbar *toolbar,
gint enable );

Dove l'orientation può essere: GTK_ORIENTATION_HORIZONTAL or GTK_ORIENTATION_VERTICAL. Lo stile: GTK_TOOLBAR_ICONS, GTK_TOOLBAR_TEXT oppure GTK_TOOLBAR_BOTH.