GtkAccelGroup

typedef struct _GtkAccelGroup GtkAccelGroup;

gtk_accel_group_new ()

GtkAccelGroup* 			gtk_accel_group_new 			(void);

gtk_accel_group_ref

#define gtk_accel_group_ref g_object_ref

gtk_accel_group_unref

#define gtk_accel_group_unref g_object_unref

gtk_accel_group_connect ()

void 			gtk_accel_group_connect 			(GtkAccelGroup *accel_group,
									 guint accel_key,
									 GdkModifierType accel_mods,
									 GtkAccelFlags accel_flags,
									 GClosure *closure);

Installe un accélérateur dan ce groupe. Quand accel_group est activé en réponse à l'appel de  gtk_accel_groups_activate(), closure est appelé si  accel_key et accel_mods de gtk_accel_groups_activate() réalisent ce genre de connexion.

La signature utilise pour la fermeture (closure) est celle de GtkAccelGroupActivate.

Notez que, en raison des détails de l'exécution, une seule fermeture seulement peut être connextée à un groupe accélérateur.

gtk_accel_group_connect_by_path ()

void gtk_accel_group_connect_by_path (GtkAccelGroup *accel_group,
const gchar *accel_path,
GClosure *closure);

Installe un accélérateyr dans ce groupe, en utilisant un chemin d'accès pour rechercher la touche et les modificateurs  (voir gtk_accel_map_add_entry()). Quand accel_group  est activé en réponse à l'appel de  gtk_accel_groups_activate(), closure  (fermeture) est appelé si la accel_key et  accel_mods de gtk_accel_groups_activate() combine la touche et les modificateurs  pour le chemin d'accès.

La signature utilisée pour  closure est celle de  GtkAccelGroupActivate.

GtkAccelGroupActivate ()

gboolean 		(*GtkAccelGroupActivate) 		(GtkAccelGroup *accel_group,
								 GObject *acceleratable,
								 guint keyval,
								 GdkModifierType modifier);

GtkAccelGroupFindFunc ()

gboolean 			(*GtkAccelGroupFindFunc) 			(GtkAccelKey *key,
										 GClosure *closure,
										 gpointer data);

Depuis 2.2

gtk_accel_group_disconnect ()

gboolean 			gtk_accel_group_disconnect 			(GtkAccelGroup *accel_group,
										 GClosure *closure);

Supprime un accélérateur installé avec gtk_accel_group_connect().

gtk_accel_group_disconnect_key ()

gboolean 		gtk_accel_group_disconnect_key 			(GtkAccelGroup *accel_group,
									 guint accel_key,
									 GdkModifierType accel_mods);

Supprimer un accélérateur préalablement installé par gtk_accel_group_connect().

gtk_accel_group_query ()

GtkAccelGroupEntry* 		gtk_accel_group_query 		(GtkAccelGroup *accel_group,
								 guint accel_key,
								 GdkModifierType accel_mods,
								 guint *n_entries);

Cherche un groupe accélérateur pour toutes les entrées combinant accel_key et  accel_mods.

gtk_accel_group_activate ()

gboolean 			gtk_accel_group_activate 		(GtkAccelGroup *accel_group,
									 GQuark accel_quark,
									 GObject *acceleratable,
									 guint accel_key,
									 GdkModifierType accel_mods);

gtk_accel_group_lock ()

void		 gtk_accel_group_lock 			(GtkAccelGroup *accel_group);

Le verrouillage du groupe accélérateur empêche que les accélérateurs qu'il contient soient modifiés pendant le temps d'exécution. référez à gtk_accel_map_change_entry() au sujet des changement d'accélérateur pendant le temps d'exécution.

Si vous appelez plusieurs fois la fonction,  accel_group  reste verrouillé tant que  gtk_accel_group_unlock() soit appelé un nombre équivalent de fois.

gtk_accel_group_unlock ()

void 		gtk_accel_group_unlock 			(GtkAccelGroup *accel_group);

Annule le dernier appel de  gtk_accel_group_lock() sur le groupe accel_group.

gtk_accel_group_from_accel_closure ()

GtkAccelGroup* 		gtk_accel_group_from_accel_closure 		(GClosure *closure);

Trouve le groupe  GtkAccelGroup  avec lequel closure  est connexté ; voir gtk_accel_group_connect().

gtk_accel_groups_activate ()

gboolean 		gtk_accel_groups_activate 		(GObject *object,
								 guint accel_key,
								 GdkModifierType accel_mods);

Trouve le premier accélérateur dans tous les  GtkAccelGroup  attachés à  object  qui combine  accel_key et accel_mods, et  active cet accélérateur. Si un accélérateur a été activé et que  la touche est manipulée,  TRUE est retourné.

gtk_accel_groups_from_object ()

GSList* 		gtk_accel_groups_from_object 		(GObject *object);

Obtient la liste de tous les groupes accélérateurs qui sont attachés à  object.

gtk_accel_group_find ()

GtkAccelKey* 		gtk_accel_group_find 		(GtkAccelGroup *accel_group,
							 GtkAccelGroupFindFunc find_func,
							 gpointer data);

Trouve la première entrée dans le groupe accélérateur pour lequel find_func retourne TRUE et returne ses GtkAccelKey.

GtkAccelKey

typedef struct {
		guint accel_key;
		GdkModifierType accel_mods;
		guint accel_flags			 : 16;
	       } GtkAccelKey;

gtk_accelerator_valid ()

gboolean 		gtk_accelerator_valid 			(guint keyval,
								 GdkModifierType modifiers);

Détermine si une valeur de touche donnée et un masque de modificateur constituent un accélérateur de clavier valide. Par exemple, le valeur de touche  GDK_a  avec GDK_CONTROL_MASK  est valide - c'est un accélérateur  "Ctrl+a". Mais, vous pouvez, à la place, utiliser la valeur de touche  GDK_Control_L  comme un accélérateur.

gtk_accelerator_parse ()

void 			gtk_accelerator_parse 			(const gchar *accelerator,
								 guint *accelerator_key,
								 GdkModifierType *accelerator_mods);

Analyse une chaîne représentant un accélérateur. Le format ressemble à  "<Control>a" ou "<Shift><Alt>F1" ou "<Release>z" (la dernière forme sert aux touches de sortie). L'analyseur est assez libéral et permet les minuscules, les majuscules et aussi les abréviations telles que  "<Ctl>" et "<Ctrl>".

Si l'analyse échoue, accelerator_key et accelerator_mods  seront définis à  0 (zéro).

gtk_accelerator_name ()

gchar*			 gtk_accelerator_name 			(guint accelerator_key,
								 GdkModifierType accelerator_mods);

Convertit un valeur de touche d'un accélérateur et le masque du modificateur en une chaîne analysable par gtk_accelerator_parse(). Par exemple, si vous lui passé GDK_q et GDK_CONTROL_MASK, cette fonction retounera <Control>q".

Si vous avez besoin d'afficher des accélérateur dans l'interface utilisateur, voir  gtk_accelerator_get_label().

gtk_accelerator_get_label ()

gchar* gtk_accelerator_get_label (guint accelerator_key,
GdkModifierType accelerator_mods);

Convertit un valeur de touche d'accélérateur et un masque de modificateur en une chaîne qui peut être utilisée pour représenter l'accélérateur à l'utilisateur.

Depuis 2.6

gtk_accelerator_set_default_mod_mask ()

void 		  gtk_accelerator_set_default_mod_mask         	(GdkModifierType default_mod_mask);

Définit les modificateurs qui seront considérés significatifs pour les accélérateurs de clavier. Le masque de modificateur par défaut est  GDK_CONTROL_MASK | GDK_SHIFT_MASK | GDK_MOD1_MASK | GDK_SUPER_MASK | GDK_HYPER_MASK | GDK_META_MASK, c'est , Control, Shift, Alt, Super, Hyper et Meta. Les autres modificateurs sont ignorés par  GtkAccelGroup. Au final,vous devez inclure les trois modificateurs  Control, Shift et Alt dans n'importe quelle valeur que vous passez à cette fonction.

Le masque de modificateur par défaut doit être modifié au début des appliactions, avant d'utiliser n'importe quel groupe accélérateur.

gtk_accelerator_get_default_mod_mask ()

guint 			gtk_accelerator_get_default_mod_mask 			(void);

Obtient la valeur définit par  gtk_accelerator_set_default_mod_mask().

The "accel-activate" signal

gboolean 		user_function 		(GtkAccelGroup *accel_group,
						 GObject *acceleratable,
						 guint keyval,
						 GdkModifierType modifier,
						 gpointer user_data) : Has Details

Le signal "accel-activate" est un détail d'exécution de  GtkAccelGroup  et n'est pas appelé à être utilisé par les applications.

The "accel-changed" signal

void 			user_function			(GtkAccelGroup *accel_group,
							 guint keyval,
							 GdkModifierType modifier,
							 GClosure *accel_closure,
							 gpointer user_data) 	    : Exécute en premier / a des détails

Le signal "accem-changed" est imité quand un GtkAccelGroupEntry est ajouté ou supprimé d'un groupe accélérateur.

Des Widgets comme GtkAccelLabelqui affichent un accélérateur associé doivent être connectés à ce signal, et reconstruisent leur représentation visuelle si  accel_closure leur appartient.