Tutorial associé :
LesFenetresAvecBarresDeDefilement
1. Les signaux
"move-focus-out" : void user_function(
GtkScrolledWindow *scrolledwindow,
GtkDirectionType? arg1, gpointer user_data);
"scroll-child" : void user_function(
GtkScrolledWindow *scrolledwindow,
GtkScrollType? arg1, gboolean arg2, gpointer user_data);
2. Les fonctions
2.1 Les fonctions documentées
GtkWidget* gtk_scrolled_window_new(GtkAdjustment? *hadjustment, GtkAdjustment? *vadjustment);
Permet de créer une fenêtre avec barre de défilement.
Paramètres :
- hadjustment : les paramètres de la barre de défilement horizontale
- vadjustment : les paramètres de la barre de défilement verticale
Retour : le nouveau widget
GtkAdjustment?* gtk_scrolled_window_get_hadjustment(GtkScrolledWindow *scrolled_window);
Permet d'obtenir les paramètres de la barre de défilement horizontale.
Paramètre :
- scrolled_window : la fenêtre
Retour : les paramètres de la barre de défilement horizontale.
GtkAdjustment?* gtk_scrolled_window_get_vadjustment(GtkScrolledWindow *scrolled_window);
Permet d'obtenir les paramètres de la barre de défilement verticale.
Paramètre :
- scrolled_window : la fenêtre
Retour : les paramètres de la barre de défilement verticale.
void gtk_scrolled_window_set_hadjustment(GtkScrolledWindow *scrolled_window, GtkAdjustment? *hadjustment);
Permet de définir les paramètres de la barre de défilement horizontale.
Paramètres :
- scrolled_window : la fenêtre
- hadjustment : les paramètres de la barre de défilement horizontale.
void gtk_scrolled_window_set_vadjustment(GtkScrolledWindow *scrolled_window, GtkAdjustment? *vadjustment);
Permet de définir les paramètres de la barre de défilement verticale.
Paramètres :
- scrolled_window : la fenêtre
- vadjustment : les paramètres de la barre de défilement verticale.
GtkWidget* gtk_scrolled_window_get_hscrollbar(GtkScrolledWindow *scrolled_window);
Permet d'obtenir la widget de défilement horizontal.
Paramètre :
- scrolled_window : la fenêtre
Retour : le widget
GtkWidget* gtk_scrolled_window_get_vscrollbar(GtkScrolledWindow *scrolled_window);
Permet d'obtenir la widget de défilement vertical.
Paramètre :
- scrolled_window : la fenêtre
Retour : le widget
void gtk_scrolled_window_add_with_viewport(GtkScrolledWindow *scrolled_window, GtkWidget *child);
Cette fonction permet d'ajouter un widget à l'intérieur de la fenêtre.
Paramètres :
- scrolled_window : la fenêtre
- child : le widget enfant
void gtk_scrolled_window_set_policy(GtkScrolledWindow *scrolled_window, GtkPolicyType? hscrollbar_policy, GtkPolicyType? vscrollbar_policy);
Permet de définir si l'on affiche ou pas les barres de défilement.
Paramètres :
- scrolled_window : la fenêtre
- hscrollbar_policy : affichage ou non de la barre de défilement horizontale
- vscrollbar_policy : affichage ou non de la barre de défilement verticale
Les paramètres
hscrollbar_policy et
vscrollbar_policy peuvent prendre les valeurs suivantes :
- GTK_POLICY_ALWAYS : toujours affichée
- GTK_POLICY_AUTOMATIC : affichée si besoin est
- GTK_POLICY_NEVER : jamais affichée
void gtk_scrolled_window_get_policy(GtkScrolledWindow *scrolled_window, GtkPolicyType? *hscrollbar_policy, GtkPolicyType? *vscrollbar_policy);
Permet de savoir si les barres de défilement sont affichées.
Paramètres :
- scrolled_window : la fenêtre
- hscrollbar_policy : affichage ou non de la barre de défilement horizontale. VALEUR DE RETOUR
- vscrollbar_policy : affichage ou non de la barre de défilement verticale. VALEUR DE RETOUR
void gtk_scrolled_window_set_placement(GtkScrolledWindow *scrolled_window, GtkCornerType? window_placement);
Définit la position du widget enfant par rapport aux barres de défilement.
Paramètres :
- scrolled_window : la fenêtre.
- window_placement : la position du widget
Le paramètre
window_placement peut prendre les valeurs suivantes :
- 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.
GtkCornerType? gtk_scrolled_window_get_placement(GtkScrolledWindow *scrolled_window);
Permet d'obtenir la position du widget enfant par rapport aux barres de défilement.
Paramètre :
- scrolled_window : la fenêtre.
Retour : la position du widget.
void gtk_scrolled_window_set_shadow_type(GtkScrolledWindow *scrolled_window, GtkShadowType type);
Permet de modifier l'aspect du bord du widget enfant à la
GtkScrolledWindow.
Paramètres :
- scrolled_window : la fenêtre.
- type : l'aspect du bord du widget.
Le paramètre
type peut prendre les valeurs suivantes :
- GTK_SHADOW_NONE,
- GTK_SHADOW_IN,
- GTK_SHADOW_OUT,
- GTK_SHADOW_ETCHED_IN,
- GTK_SHADOW_ETCHED_OUT.
Permet de connaître l'aspect du bord du widget enfant.
Paramètre :
- scrolled_window : la fenêtre.
Retour : la valeur de l'aspect.