NOTEBOOK

 

Il NoteBook Widget è una collezione di pagine sovrapposte. Ogni pagina contiene differenti widget.

La funzione per creare un nuovo notebook widget è:

GtkWidget *gtk_notebook_new( void );

La prima cosa che possiamo impostare una volta creato il notebook è l'indicatore delle pagine (tabs) che può essere posizionato in alto, basso, destra o sinistra.

void gtk_notebook_set_tab_pos( GtkNotebook *notebook,
GtkPositionType pos );

GtkPostionType assumerà quindi uno dei seguenti valori:

GTK_POS_LEFT
GTK_POS_RIGHT
GTK_POS_TOP
GTK_POS_BOTTOM

il default è GTK_POS_TOP

Per aggiungere pagine al notebook:

void gtk_notebook_append_page( GtkNotebook *notebook,
GtkWidget *child,
GtkWidget *tab_label );

void gtk_notebook_prepend_page( GtkNotebook *notebook,
GtkWidget *child,
GtkWidget *tab_label );

void gtk_notebook_insert_page( GtkNotebook *notebook,
GtkWidget *child,
GtkWidget *tab_label,
gint position );

Useremo una delle tre funzioni a seconda che vogliamo aggiungere la pagina all'inizio, alla fine o alla posizione specificata.

Per rimuovere una pagina:

void gtk_notebook_remove_page( GtkNotebook *notebook,
gint page_num );

Per sapere quale pagina è visualizzata correntemente:

gint gtk_notebook_get_current_page( GtkNotebook *notebook );

Per andare avanti o indietro nelle visualizzazione delle pagine:

void gtk_notebook_next_page( GtkNoteBook *notebook );

void gtk_notebook_prev_page( GtkNoteBook *notebook );

Questa funzione ci permette invece di settare la pagina attiva.

void gtk_notebook_set_page( GtkNotebook *notebook,
gint page_num );

Le seguenti due funzioni ci permettono di nascondere i tabs delle pagine e il border del notebook:

void gtk_notebook_set_show_tabs( GtkNotebook *notebook,
gboolean show_tabs);

void gtk_notebook_set_show_border( GtkNotebook *notebook,
gboolean show_border );

La funzione successiva ci serve quando abbiamo un largo numero di pagine i cui tabs non entrano nella wiindows fornendoci due bottoncini mnuniti di freccia per lo scorrimento.

void gtk_notebook_set_scrollable( GtkNotebook *notebook,
gboolean scrollable );

Naturalmente i valori accettati dalle funzioni show_tabs, show_border e scrollable possono essere TRUE o FALSE.

 

 

ESEMPIO

#include <gtk/gtk.h>

/* Ruota la posizione dei tabs */
void rotate_book (GtkButton *button, GtkNotebook *notebook)
{
gtk_notebook_set_tab_pos (notebook, (notebook->tab_pos +1) %4);
}

/* Aggiunge rimuove tabs e borders */
void tabsborder_book (GtkButton *button, GtkNotebook *notebook)
{
gint tval = FALSE;
gint bval = FALSE;
if (notebook->show_tabs == 0)
tval = TRUE;
if (notebook->show_border == 0)
bval = TRUE;

gtk_notebook_set_show_tabs (notebook, tval);
gtk_notebook_set_show_border (notebook, bval);
}

/* Rimuove una pagina dal notebook */
void remove_book (GtkButton *button, GtkNotebook *notebook)
{
gint page;

page = gtk_notebook_get_current_page(notebook);
gtk_notebook_remove_page (notebook, page);
/* Forza il redraw del widget */
gtk_widget_draw(GTK_WIDGET(notebook), NULL);
}

void delete (GtkWidget *widget, GtkWidget *event, gpointer data)
{
gtk_main_quit ();
}

int main (int argc, char *argv[])
{
GtkWidget *window;
GtkWidget *button;
GtkWidget *table;
GtkWidget *notebook;
GtkWidget *frame;
GtkWidget *label;
GtkWidget *checkbutton;
int i;
char bufferf[32];
char bufferl[32];

gtk_init (&argc, &argv);

window = gtk_window_new (GTK_WINDOW_TOPLEVEL);

gtk_signal_connect (GTK_OBJECT (window), "delete_event",
GTK_SIGNAL_FUNC (delete), NULL);

gtk_container_set_border_width (GTK_CONTAINER (window), 10);

table = gtk_table_new(3,6,FALSE);
gtk_container_add (GTK_CONTAINER (window), table);

/* Crea un nuovo notebook, e posiziona i tabs */
notebook = gtk_notebook_new ();
gtk_notebook_set_tab_pos (GTK_NOTEBOOK (notebook), GTK_POS_TOP);
gtk_table_attach_defaults(GTK_TABLE(table), notebook, 0,6,0,1);
gtk_widget_show(notebook);

/* Aggiunge pagine al notebook */
for (i=0; i < 5; i++) {
sprintf(bufferf, "Append Frame %d", i+1);
sprintf(bufferl, "Page %d", i+1);

frame = gtk_frame_new (bufferf);
gtk_container_set_border_width (GTK_CONTAINER (frame), 10);
gtk_widget_set_usize (frame, 100, 75);
gtk_widget_show (frame);

label = gtk_label_new (bufferf);
gtk_container_add (GTK_CONTAINER (frame), label);
gtk_widget_show (label);

label = gtk_label_new (bufferl);
gtk_notebook_append_page (GTK_NOTEBOOK (notebook), frame, label);
}

checkbutton = gtk_check_button_new_with_label ("Check me please!");
gtk_widget_set_usize(checkbutton, 100, 75);
gtk_widget_show (checkbutton);

label = gtk_label_new ("Add page");
gtk_notebook_insert_page (GTK_NOTEBOOK (notebook), checkbutton, label, 2);

for (i=0; i < 5; i++) {
sprintf(bufferf, "Prepend Frame %d", i+1);
sprintf(bufferl, "PPage %d", i+1);

frame = gtk_frame_new (bufferf);
gtk_container_set_border_width (GTK_CONTAINER (frame), 10);
gtk_widget_set_usize (frame, 100, 75);
gtk_widget_show (frame);

label = gtk_label_new (bufferf);
gtk_container_add (GTK_CONTAINER (frame), label);
gtk_widget_show (label);

label = gtk_label_new (bufferl);
gtk_notebook_prepend_page (GTK_NOTEBOOK(notebook), frame, label);
}

/* Setta la pagina iniziale (4) */
gtk_notebook_set_page (GTK_NOTEBOOK(notebook), 3);

/* Crea i bottoni */
button = gtk_button_new_with_label ("close");
gtk_signal_connect_object (GTK_OBJECT (button), "clicked",
GTK_SIGNAL_FUNC (delete), NULL);
gtk_table_attach_defaults(GTK_TABLE(table), button, 0,1,1,2);
gtk_widget_show(button);

button = gtk_button_new_with_label ("next page");
gtk_signal_connect_object (GTK_OBJECT (button), "clicked",
(GtkSignalFunc) gtk_notebook_next_page,
GTK_OBJECT (notebook));
gtk_table_attach_defaults(GTK_TABLE(table), button, 1,2,1,2);
gtk_widget_show(button);

button = gtk_button_new_with_label ("prev page");
gtk_signal_connect_object (GTK_OBJECT (button), "clicked",
(GtkSignalFunc) gtk_notebook_prev_page,
GTK_OBJECT (notebook));
gtk_table_attach_defaults(GTK_TABLE(table), button, 2,3,1,2);
gtk_widget_show(button);

button = gtk_button_new_with_label ("tab position");
gtk_signal_connect (GTK_OBJECT (button), "clicked",
(GtkSignalFunc) rotate_book,
GTK_OBJECT(notebook));
gtk_table_attach_defaults(GTK_TABLE(table), button, 3,4,1,2);
gtk_widget_show(button);

button = gtk_button_new_with_label ("tabs/border on/off");
gtk_signal_connect (GTK_OBJECT (button), "clicked",
(GtkSignalFunc) tabsborder_book,
GTK_OBJECT (notebook));
gtk_table_attach_defaults(GTK_TABLE(table), button, 4,5,1,2);
gtk_widget_show(button);

button = gtk_button_new_with_label ("remove page");
gtk_signal_connect (GTK_OBJECT (button), "clicked",
(GtkSignalFunc) remove_book,
GTK_OBJECT(notebook));
gtk_table_attach_defaults(GTK_TABLE(table), button, 5,6,1,2);
gtk_widget_show(button);

gtk_widget_show(table);
gtk_widget_show(window);

gtk_main ();

return(0);
}