LIST WIDGET

 

Per creare una nuova lista possiamo usare:

GtkWidget *gtk_list_new( void );

Una volta creata la lista con la seguente funzione possiamo settare il modo di selezione:

void gtk_list_set_selection_mode( GtkList *list,
GtkSelectionMode mode );

I valori accettati sono: GTK_SELECTION_SINGLE, GTK_SELECTION_BROWSE,
GTK_SELECTION_MULTIPLE oppure GTK_SELECTION_EXTENDED.

Inseriamo un nuovo item nella lista usando una delle seguenti funzioni a seconda che lo vogliamo inserire all'inizio alla fine o in una posizione specifica:

void gtk_list_insert_items( GtkList *list,
GList *items,
gint position );

void gtk_list_append_items( GtkList *list,
GList *items);

void gtk_list_prepend_items( GtkList *list,
GList *items);

L'item è una Glist. Confrontare la sezione su Glib per ulteriori chiarimenti.

Per rimuovere un item possiamo invece usare:

void gtk_list_remove_items( GtkList *list,
GList *items);

Con quest'altra funzione possiamo poi rimuovere e distruggere una serie di item dalla lista che vanno da start a end (intesi come indice della posizione degli item nella lista):

void gtk_list_clear_items( GtkList *list,
gint start,
gint end );

Se invece vogliamo selezionare/deselezionare un item o un child:

void gtk_list_select_item( GtkList *list,
gint item );

void gtk_list_unselect_item( GtkList *list,
gint item);

void gtk_list_select_child( GtkList *list,
GtkWidget *child);

void gtk_list_unselect_child( GtkList *list,
GtkWidget *child);

Per ricavare la posizione di un child:

gint gtk_list_child_position( GtkList *list,
GtkWidget *child);

Ed ecco i segnali.

Questo è il segnale emesso quando cambia la selezione:

void selection_changed( GtkList *list );

Questo quando viene selezionato un child:

void select_child( GtkList *list,
GtkWidget *child);

E questo quando viene deselezionato:

void unselect_child( GtkList *list,
GtkWidget *child );

 

 

ESEMPIO

#include <gtk/gtk.h>
#include <stdio.h>

const gchar *list_item_data_key="list_item_data";

/* prototipi dei segnali che connetteremo alla list */

static void sigh_print_selection( GtkWidget *gtklist,
gpointer func_data);

static void sigh_button_event( GtkWidget *gtklist,
GdkEventButton *event,
GtkWidget *frame );

/* Funzione Main */

gint main (int argc,
gchar *argv[])
{
GtkWidget *separator;
GtkWidget *window;
GtkWidget *vbox;
GtkWidget *scrolled_window;
GtkWidget *frame;
GtkWidget *gtklist;
GtkWidget *button;
GtkWidget *list_item;
GList *dlist;
guint i;
gchar buffer[64];

/* Inizializziamo gtk+ */

gtk_init(&argc, &argv);

/* Creiamo una finestra e connettiamo gtk_main_quit() */

window=gtk_window_new(GTK_WINDOW_TOPLEVEL);
gtk_window_set_title(GTK_WINDOW(window), "GtkList Example");
gtk_signal_connect(GTK_OBJECT(window),
"destroy",
GTK_SIGNAL_FUNC(gtk_main_quit),
NULL);

vbox=gtk_vbox_new(FALSE, 5);
gtk_container_set_border_width(GTK_CONTAINER(vbox), 5);
gtk_container_add(GTK_CONTAINER(window), vbox);
gtk_widget_show(vbox);

/* La scrolled window per la GtkList widget */
scrolled_window=gtk_scrolled_window_new(NULL, NULL);
gtk_widget_set_usize(scrolled_window, 250, 150);
gtk_container_add(GTK_CONTAINER(vbox), scrolled_window);
gtk_widget_show(scrolled_window);

/* Crea la GtkList widget.
* Connettiamo la funzione sigh_print_selection()
* al segnale "selection_changed" */
gtklist=gtk_list_new();
gtk_scrolled_window_add_with_viewport( GTK_SCROLLED_WINDOW(scrolled_window),
gtklist);
gtk_widget_show(gtklist);
gtk_signal_connect(GTK_OBJECT(gtklist),
"selection_changed",
GTK_SIGNAL_FUNC(sigh_print_selection),
NULL);

frame=gtk_frame_new("Prison");
gtk_widget_set_usize(frame, 200, 50);
gtk_container_set_border_width(GTK_CONTAINER(frame), 5);
gtk_frame_set_shadow_type(GTK_FRAME(frame), GTK_SHADOW_OUT);
gtk_container_add(GTK_CONTAINER(vbox), frame);
gtk_widget_show(frame);

gtk_signal_connect(GTK_OBJECT(gtklist),
"button_release_event",
GTK_SIGNAL_FUNC(sigh_button_event),
frame);

/* Crea un separatore */
separator=gtk_hseparator_new();
gtk_container_add(GTK_CONTAINER(vbox), separator);
gtk_widget_show(separator);

/* Infine creiamo un bottone e connettiamo
* il segnale clicked alla distruzione della finestra */
button=gtk_button_new_with_label("Close");
gtk_container_add(GTK_CONTAINER(vbox), button);
gtk_widget_show(button);
gtk_signal_connect_object(GTK_OBJECT(button),
"clicked",
GTK_SIGNAL_FUNC(gtk_widget_destroy),
GTK_OBJECT(window));

/* Creiamo 5 list items*/
for (i=0; i<5; i++) {
GtkWidget *label;
gchar *string;

sprintf(buffer, "ListItemContainer with Label #%d", i);
label=gtk_label_new(buffer);
list_item=gtk_list_item_new();
gtk_container_add(GTK_CONTAINER(list_item), label);
gtk_widget_show(label);
gtk_container_add(GTK_CONTAINER(gtklist), list_item);
gtk_widget_show(list_item);
gtk_label_get(GTK_LABEL(label), &string);
gtk_object_set_data(GTK_OBJECT(list_item),
list_item_data_key,
string);
}
/* Creiamo altre 5 label.*/
dlist=NULL;
for (; i<10; i++) {
sprintf(buffer, "List Item with Label %d", i);
list_item=gtk_list_item_new_with_label(buffer);
dlist=g_list_prepend(dlist, list_item);
gtk_widget_show(list_item);
gtk_object_set_data(GTK_OBJECT(list_item),
list_item_data_key,
"ListItem with integrated Label");
}
gtk_list_append_items(GTK_LIST(gtklist), dlist);

/* Rendiamo la window visibile */
gtk_widget_show(window);

/* Entriamo nel ciclo principale*/
gtk_main();

return(0);
}

void sigh_button_event( GtkWidget *gtklist,
GdkEventButton *event,
GtkWidget *frame )
{

if (event->type==GDK_BUTTON_RELEASE &&
event->button==3) {
GList *dlist, *free_list;
GtkWidget *new_prisoner;

dlist=GTK_LIST(gtklist)->selection;
if (dlist)
new_prisoner=GTK_WIDGET(dlist->data);
else
new_prisoner=NULL;

dlist=gtk_container_children(GTK_CONTAINER(frame));
free_list=dlist;
while (dlist) {
GtkWidget *list_item;

list_item=dlist->data;

gtk_widget_reparent(list_item, gtklist);

dlist=dlist->next;
}
g_list_free(free_list);

if (new_prisoner) {
GList static_dlist;

static_dlist.data=new_prisoner;
static_dlist.next=NULL;
static_dlist.prev=NULL;

gtk_list_unselect_child(GTK_LIST(gtklist),
new_prisoner);
gtk_widget_reparent(new_prisoner, frame);
}
}
}

void sigh_print_selection( GtkWidget *gtklist,
gpointer func_data)
{
GList *dlist;

dlist=GTK_LIST(gtklist)->selection;

if (!dlist) {
g_print("Selection cleared\n");
return;
}
/* Stampa a consolle la selezione*/

g_print("The selection is a ");

while (dlist) {
GtkObject *list_item;
gchar *item_data_string;

list_item=GTK_OBJECT(dlist->data);
item_data_string=gtk_object_get_data(list_item,
list_item_data_key);
g_print("%s ", item_data_string);

dlist=dlist->next;
}
g_print("\n");
}