Date de publication : 20 Février 2007
Comme vous pouvez vous y attendre, la fonction de création et comme toutes les autres, c'est à dire prévisible.
GtkWidget* gtk_scrolled_window_new(GtkAdjustment *hadjustment, GtkAdjustment *vadjustment);
Les paramètres hadjustment et vadjustment permettent de
définir les propriétés des barres de défilement.
L'objet GtkAdjustment permet dans notre cas, de définir (entre autres)
la valeur minimale que peut prendre la barre de défilement, le pas de
celle-ci.
Mais à moins de connaître exactement tous ces paramètres,
il vaut mieux laisser faire Gtk, et mettre hadjustment et vadjustment à
NULL.
Pour cela, il y a deux cas différents. Si par exemple le widget enfant
a la capacité d'avoir ses propres barres de défilements, il suffit
d'utiliser la fonction gtk_container_add.
Par contre, dans le cas ou le widget ne possède pas cette capacité,
il faudra utiliser cette fonction :
void gtk_scrolled_window_add_with_viewport(GtkScrolledWindow *scrolled_window, GtkWidget *child);
Avec cette fonction, Gtk va créer ce qu'il s'appelle un viewport (qui
peut avec des barres de défilement) et va insérer l'enfant dans
ce viewport.
Seuls les widgets GtkTreeView, GtkTextView, et GtkLayout ont la possibilité
d'avoir des barres défilements. Pour les autres widgets (comme les GtkHBox,
GtkVBox, ...) il faudra utiliser la deuxième fonction.
Les barres de défilement s'affichent automatiquement (que ce soit la barre horizontale ou verticale). Il se peut que, par exemple, vous n'ayez besoin que de la barre verticale. Dans ce cas vous ne voulez sûrement pas avoir de barre de défilement horizontale. La solution à votre problème est cette fonction :
void gtk_scrolled_window_set_policy (GtkScrolledWindow *scrolled_window, GtkPolicyType hscroll_policy, GtkPolicyType vscroll_policy);
Les paramètres hscroll_policy et vscroll_policy peuvent
prendre trois paramètres :
Au contraire, pour savoir si elles sont affichées ou pas, il y a la fonction :
void gtk_scrolled_window_get_policy (GtkScrolledWindow *scrolled_window, GtkPolicyType *hscroll_policy, GtkPolicyType *vscroll_policy);
Et voila le résultat, la fenêtre ne respecte pas la condition TAILLE
= 320x200. Il faut utiliser le widget GtkScrolledWindow.
Après avoir créer notre fenêtre principale, il faut créer
notre widget et l'insérer dans la fenêtre :
scrollbar = gtk_scrolled_window_new(NULL, NULL);
gtk_container_add(GTK_CONTAINER(window),scrollbar);
Ensuite les labels seront contenus dans une GtkVBox qu'il faut insérer ainsi dans notre GtkScrolledWindow :
gtk_scrolled_window_add_with_viewport(GTK_SCROLLED_WINDOW(scrollbar), box);
Puisque nous n'avons pas besoin de la barre de défilement horizontale, on la supprime :
gtk_scrolled_window_set_policy(GTK_SCROLLED_WINDOW(scrollbar), GTK_POLICY_NEVER, GTK_POLICY_ALWAYS);
Et voila notre toute nouvelle fenêtre est crée.
#include <gtk/gtk.h> #include <stdio.h> int main(int argc, char* argv[]) { GtkWidget* window; GtkWidget* box; GtkWidget *scrollbar; int i; gtk_init(&argc, &argv); window = gtk_window_new(GTK_WINDOW_TOPLEVEL); gtk_window_set_default_size(GTK_WINDOW(window), 320, 200); gtk_window_set_title(GTK_WINDOW(window), "GtkScrolledWindow"); g_signal_connect(G_OBJECT(window),"destroy",G_CALLBACK(gtk_main_quit),0); scrollbar = gtk_scrolled_window_new(NULL, NULL); gtk_container_add(GTK_CONTAINER(window),scrollbar); box=gtk_vbox_new(FALSE,5); gtk_scrolled_window_add_with_viewport(GTK_SCROLLED_WINDOW(scrollbar), box); gtk_scrolled_window_set_policy(GTK_SCROLLED_WINDOW(scrollbar), GTK_POLICY_NEVER, GTK_POLICY_ALWAYS); for(i = 1 ; i <= 10 ; ++i) { GtkWidget *label; char texte[10]; sprintf(texte, "Label %d", i); label = gtk_label_new(texte); gtk_box_pack_start(GTK_BOX(box), label, FALSE, FALSE, 5); } gtk_widget_show_all(window); gtk_main(); return 0; } |
Résultat : |
move-focus-out |
Prototype fonction callback : void user_function(GtkScrolledWindow *scrolledwindow, GtkDirectionType arg1, gpointer user_data); |
scroll-child |
Prototype fonction callback : void user_function(GtkScrolledWindow *scrolledwindow, GtkScrollType arg1, gboolean arg2, gpointer user_data); |
GtkAdjustment* gtk_scrolled_window_get_hadjustment(GtkScrolledWindow *scrolled); |
Pour obtenir les paramètres de la barre de défilement
horizontale. Entrée(s) : scrolled : la fenêtre. Sortie : un pointeur sur la structure GtkAdjustment contenant les paramètres. |
GtkAdjustment* gtk_scrolled_window_get_vadjustment(GtkScrolledWindow *scrolled); |
Pour obtenir les paramètres de la barre de défilement
verticale. Entrée(s) : scrolled : la fenêtre. Sortie : un pointeur sur la structure GtkAdjustment contenant les paramètres. |
void gtk_scrolled_window_set_hadjustment(GtkScrolledWindow *scrolled, GtkAdjustment *hadjustment); |
Définit les paramètres de la barre de défilement
horizontale. Entrée(s) : scrolled : la fenêtre. hadjustment : structure contenant les paramètres à appliquer. Sortie : rien. |
void gtk_scrolled_window_set_vadjustment(GtkScrolledWindow *scrolled, GtkAdjustment *vadjustment); |
Définit les paramètres de la barre de défilement
verticale. Entrée(s) : scrolled : la fenêtre. vadjustment : structure contenant les paramètres à appliquer. Sortie : rien. |
void gtk_scrolled_window_set_shadow_type(GtkScrolledWindow *scrolled, GtkShadowType type); |
Modifie l'aspect du bord du widget enfant à la
GtkScrolledWindow. Entrée(s) : scrolled : la fenêtre. type : une valeur parmi *GTK_SHADOW_NONE,
.Sortie : rien. |
GtkShadowType gtk_scrolled_window_get_shadow_type(GtkScrolledWindow *scrolled); |
Pour connaitre l'aspect du bord du widget enfant. Entrée(s) : scrolled : la fenêtre. Sortie : type de l'aspect. |
void gtk_scrolled_window_set_placement(GtkScrolledWindow *scrolled, GtkCornerType window_placement); |
Définit la position du widget enfant par rapport
aux barres de défilement. Entrée(s) : scrolled : la fenêtre. window_placement : la position du widget, peut être *GTK_CORNER_TOP_LEFT
-> en dessus à gauche, *GTK_CORNER_BOTTOM_LEFT
-> en dessous à gauche, *GTK_CORNER_TOP_RIGHT
-> en dessus à droite,*GTK_CORNER_BOTTOM_RIGHT
-> en dessous à droite. Sortie : rien. |
GtkCornerType gtk_scrolled_window_get_placement(GtkScrolledWindow *scrolled); |
Pour obtenir la position du widget enfant par rapport
aux barres de défilement. Entrée(s) : scrolled : la fenêtre. Sortie : la position du widget. |