Les images
Nous allons cette fois, essayer de rendre nos fenêtres un peu moins austères.
Pour cela, nous allons utiliser des images grâce au widget GtkImage. Nous
allons voir comment afficher une image à partir d'un fichier ou d'un
GtkStockItem.
1. Utilisation du widget GtkImage.
1.1 Création.
Pour ce widget, il y a toute une panoplie de fonction de création. Nous
n'allons en étudier que quelques-unes, car certaines font appel à
des notions par encore vues. Voici donc les fonctions étudiées
:
GtkWidget* gtk_image_new (void);
GtkWidget* gtk_image_new_from_file (const gchar *filename);
GtkWidget* gtk_image_new_from_stock (const gchar *stock_id, GtkIconSize size);
La première crée une image mais complètement vide.
La deuxième crée l'image à partir du fichier filename.
Gtk+ est capable d'utiliser les images qui sont au format PNG, JPEG, TIFF. Le
chemin du fichier filename peut être relatif ou absolu. Si le chemin
spécifié est incorrect ou que le format de l'image est invalide,
l'image de retour sera celle-ci : 
La troisième fonction, récupère l'image qui est associée
à un objet GtkStockItem afin de l'afficher. Le paramètre size
peut prendre sept valeurs différentes pour définir la taille de
l'image à afficher :
| Valeur |
Aperçu |
| GTK_ICON_SIZE_INVALID |
Ne peut être passé en paramètre. Ceci
est uniquement une valeur de retour. |
| GTK_ICON_SIZE_MENU |
 |
| GTK_ICON_SIZE_SMALL_TOOLBAR |
 |
| GTK_ICON_SIZE_LARGE_TOOLBAR |
 |
| GTK_ICON_SIZE_BUTTON |
 |
| GTK_ICON_SIZE_DND |
 |
| GTK_ICON_SIZE_DIALOG |
 |
1.2 Modification de l'image.
Cette étape intervient lorsque vous avez créé une image
vide ou lorsque vous voulez changer d'image. Les deux fonctions étudiées
ici sont :
void gtk_image_set_from_file (GtkImage *image, const gchar
*filename);
void gtk_image_set_from_stock (GtkImage *image, const gchar *stock_id, GtkIconSize
size);
Les paramètres sont les même que lors de la création d'un
widget GtkImage, sauf qu'il faut préciser à quelle widget il faut
appliquer l'image.
1.3 Exemple.
Notre exemple comprendra deux composant. Tout d'abord une zone ou est affichée
l'image, puis un bouton contenant l'image du GtkStockItem GTK_STOCK_QUIT, pour
quitter l'application.
1.4 Programme exemple.
#include <stdlib.h>
#include <gtk/gtk.h> int
main(int argc, char
**argv)
{
GtkWidget *pWindow;
GtkWidget *pVBox;
GtkWidget *pImage;
GtkWidget *pQuitImage;
GtkWidget *pQuitBtn;
gtk_init(&argc, &argv);
pWindow = gtk_window_new(GTK_WINDOW_TOPLEVEL);
gtk_window_set_default_size(GTK_WINDOW(pWindow),
320, 200);
gtk_window_set_title(GTK_WINDOW(pWindow), "GtkImage");
g_signal_connect(G_OBJECT(pWindow), "destroy",
G_CALLBACK(gtk_main_quit), NULL);
pVBox = gtk_vbox_new(FALSE, 0);
gtk_container_add(GTK_CONTAINER(pWindow), pVBox);
/* Chargement d'une image
a partir d'un fichier */
pImage = gtk_image_new_from_file("./gtk.png");
gtk_box_pack_start(GTK_BOX(pVBox), pImage, FALSE,
FALSE, 5);
pQuitBtn = gtk_button_new();
gtk_box_pack_start(GTK_BOX(pVBox), pQuitBtn, TRUE,
FALSE, 5);
g_signal_connect(G_OBJECT(pQuitBtn), "clicked",
G_CALLBACK(gtk_main_quit), NULL);
/* Chargement d'une image
a partir d'un GtkStockItem */
pQuitImage = gtk_image_new_from_stock(GTK_STOCK_QUIT,
GTK_ICON_SIZE_LARGE_TOOLBAR);
gtk_container_add(GTK_CONTAINER(pQuitBtn), pQuitImage);
gtk_widget_show_all(pWindow);
gtk_main();
return EXIT_SUCCESS;
} |
Résultat :
|
2. En savoir plus.
2.1 Fonction non documentées.
void gtk_image_get_icon_set (GtkImage *image, GtkIconSet **icon_set, GtkIconSize
*size);
void gtk_image_get_image (GtkImage *image, GdkImage **gdk_image, GdkBitmap **mask);
GdkPixbuf* gtk_image_get_pixbuf (GtkImage *image);
void gtk_image_get_pixmap (GtkImage *image, GdkPixmap **pixmap, GdkBitmap **mask);
void gtk_image_get_stock (GtkImage *image, gchar **stock_id, GtkIconSize *size);
GdkPixbufAnimation* gtk_image_get_animation (GtkImage *image);
GtkImageType gtk_image_get_storage_type (GtkImage *image);
GtkWidget* gtk_image_new_from_icon_set (GtkIconSet *icon_set, GtkIconSize size);
GtkWidget* gtk_image_new_from_image (GdkImage *image, GdkBitmap *mask);
GtkWidget* gtk_image_new_from_pixbuf (GdkPixbuf *pixbuf);
GtkWidget* gtk_image_new_from_pixmap (GdkPixmap *pixmap, GdkBitmap *mask);
GtkWidget* gtk_image_new_from_animation (GdkPixbufAnimation *animation);
void gtk_image_set_from_icon_set (GtkImage *image, GtkIconSet *icon_set, GtkIconSize
size);
void gtk_image_set_from_image (GtkImage *image, GdkImage *gdk_image, GdkBitmap
*mask);
void gtk_image_set_from_pixbuf (GtkImage *image, GdkPixbuf *pixbuf);
void gtk_image_set_from_pixmap (GtkImage *image, GdkPixmap *pixmap, GdkBitmap
*mask);
void gtk_image_set_from_animation (GtkImage *image, GdkPixbufAnimation *animation);
void gtk_image_set (GtkImage *image, GdkImage *val, GdkBitmap *mask);
void gtk_image_get (GtkImage *image, GdkImage **val, GdkBitmap **mask);
Date de mise à jour : 17 mai 2003
