hds619.net » Blog

Come promesso, dopo la fine degli esami, una nuova guida alle Gtk+. In questa puntata affronteremo due argomenti differenti il primo riguardante la visualizzazione di un’immagine all’interno di un’applicazione in gtk+, il secondo come creare una barra di stato ( quella barra piccola che si vede nella maggior parte delle applicazioni, con a sinistra un messaggio e a destra il triangolino per ridimensionare la finestra.

GtkImage – Immagini in Gtk+

Le funzioni per il caricamento di un’immagine in un programma con le gtk+, uniscono ( o richiedono ) operazioni con la libreria Gdk e GdkPixbuf.

Come per tutte le altre cose, io mi concentro unicamente sulle funzioni principali, tralasciando quelle specifiche per casi particolari, quindi iniziamo a vedere come caricare un’immagine da file e da stock. Per il primo c’è una funzione che fa tutto: gtk_image_new_from_file () che riceve come argomento il nome del file\immagine e ritorna, in tipo GtkWidget *, la nostra immagine se il caricamento è avvenuto con successo, altrimenti questa stock. Proprio per il fatto che questa funzione non ritorni mai NULL e non dia informazioni sul tipo di errore quando non è possibile caricare il file\immagine specificato si può ricorrere ad un altra funzione che esegue esattamente la stessa cosa ma che allunga, anche se di poco, il giro da fare per visualizzare l’immagine finale.

La funzione è gdk_pixbuf_new_from_file () che riceve come primo argomento sempre il nome del file\immagine da caricare, e come secondo  argomento l’indirizzo di una variabile GError *, che verrà impostata nel caso la funzione ritorni NULL ( ovvero nel caso sia occorso un qualche tipo di errore ). Questa funzione però ritorna un GdkPixbuf * che noi possiamo tranquillamente convertire nel nostro GtkWidget * da visualizzare tramite la funzione gtk_image_new_from_pixbuf (). Se non vi è chiaro ancora questo metodo un pochino più articolato faccio un codice di esempio:

1
2
3
4
5
6
7
8

GtkWidget *image;
GdkPixbuf *pixbuf;
GError *error = NULL;
 
pixbuf = gdk_pixbuf_new_from_file ("miofile.jpeg", &error);
if ( !pixbuf )
     g_critical ("(%d) %s\n", error->code, error->message);
image = gtk_image_new_from_pixbuf (pixbuf);

Per quanto riguarda il caricamento di un’immagine da stock il procedimento è semplicissimo, basta passare il nome della stock a gtk_image_new_from_stock ()  e poi specificare la grandezza della stock dipendentemente dal contesto in cui la si vuole utilizzare. Ritorna il GtkWidget * con l’immagine STOCK pronta ad essere visualizzata.

GtkStatusbar – Barra di stato

Per chi non avesse ancora capito quale è in un applicazione gtk+ la barra di stato posto un immagine molto autoesplicativa:

 La creazione è molto semplice, il widget è ottenibile richiamando unicamente la funzione gtk_statusbar_new ()  che non riceve argomenti. Di questo tipo però ci sarebbe da parlare più teoricamente che praticamente. Il suo funzionamento nella visualizzazione dei messaggi avviene tramite stack LIFO su canali sperati. Ovvero per i messaggi son presenti azioni di push e pop, e possono essere inviati su “context id” ( canali ) differenti. Se si vuole utilizzare in modo semplicissimo questa barra di stato è bene utilizzare il canale 0 ed eseguire ( dopo il primo push ) sempre un pop prima di nuovo push così da non lasciare in memoria vecchi messaggi che non servono più.

Codice di esempio:

1
2
3
4
5
6
7
8

GtkWidget *statusbar;
 
statusbar = gtk_statusbar_new ();
gtk_statusbar_push (GTK_STATUSBAR (statusbar), 0, "Starting GtkStatusbar :)");
 
/* successivamente per non lasciare in buffer nulla */
gtk_statusbar_pop (GTK_STATUSBAR (statusbar), 0);
gtk_statusbar_push (GTK_STATUSBAR (statusbar), 0, "Pop & Push!");

Per finire con la status bar, il triangolino per ridimensionare si può “eliminare” tramite la funzione gtk_statusbar_set_has_resize_grip () che riceve come primo argomento la statusbar e come secondo un valore booleano impostato a TRUE se si vuole mantenere il triangolino per il ridimensionamento altrimenti FALSE.

Fine Quattordicesima Puntata
Ok, abbiamo parlato un po’ e ci voleva dopo tanti giorni di silenzio. Spero che sia tutto chiaro, sono stato molto di più sulla teoria questa volta, alla fin fine star lì a descrivere ogni singola funzione non ha molto senso se non si conosce prima su cosa si sta operando.

Ciauz