GtkAccelMap

typedef struct _GtkAccelMap GtkAccelMap;

GtkAccelMapForeach ()

void 			(*GtkAccelMapForeach) 			(gpointer data, 
								 const gchar *accel_path,
								 guint accel_key,
								 GdkModifierType accel_mods,
								 gboolean changed);

gtk_accel_map_add_entry ()

void 			gtk_accel_map_add_entry 		(const gchar *accel_path,
								 guint accel_key,
								 GdkModifierType accel_mods);

Déclare un nouvel accélérateur avec la carte d'accélérateur global. Cette fonction doit être appelée uniquementune fois par accel_path avec strictement  les accel_key et accel_mods pour ce chemin. Pour changer l'accélérateur pendant le temps d'exécution du programme, utilisez  gtk_accel_map_change_entry(). Le chemin de l'accélérateur doit se présenter ainsi "<WINDOWTYPE>/Category1/Category2/.../Action", où <WINDOWTYPE> doit être un unique identifiant spécifique )à l'application lequel correspond à une sorte de fenêtre dans laquelle l'accélérateur est utilisé, par exemple  "Gimp-Image", "Abiword-Document" ou "Gnumeric-Settings". La portion  Category1/.../Action est  choisie en fonction de  l'action déclenchée par l'accélérateur, c'est à dire, pour les accélérateurs des items de menu, chosissez le chemin du m enu de l'item, par exemple "Fichier/Enregistrer sous", "Image/Vue/Zoom" ou "Edition/Tout sélectionner". Ainsi un chemin d'accélérateur valide ressemblera à : "<Gimp-Toolbox>/Fichier/Dialogue/Options...".

gtk_accel_map_lookup_entry ()

gboolean 		gtk_accel_map_lookup_entry 		(const gchar *accel_path,
								 GtkAccelKey *key);

Recherche l'entrée d'accélérateur pour  accel_path et complète  key.

gtk_accel_map_change_entry ()

gboolean 		gtk_accel_map_change_entry 		(const gchar *accel_path,
								 guint accel_key,
								 GdkModifierType accel_mods,
								 gboolean replace);

Change  accel_key et accel_mods associés avec accel_path à ce moment. En raison des conflits possibles avec d'autres accélérateurs, un changement ne peut pas toujours être possible,  replaceindique si d'autres accélérateurs peuvent être supprimés pour résoudre de tels conflits. Un changement sera effectué uniquement si tous les conflits peuvent être résolus (ce qui peut ne pas être le cas si les accélérateurs en conflits sont bloqués). La réussite d'un changement est indiquée par la valeur  TRUE  qui est retournée.

gtk_accel_map_load ()

void 		gtk_accel_map_load 		(const gchar *file_name);

Analyse un fichier sauvegardé préalablement avec gtk_accel_map_save() pour les caractéristiques d'accélérateurs et les propage en conséquence. 

gtk_accel_map_save ()

void 		gtk_accel_map_save 		(const gchar *file_name);

 file_name. Le fichier est écrit au format  approprié pour être relu par  gtk_accel_map_load().

gtk_accel_map_foreach ()

void 		gtk_accel_map_foreach 		(gpointer data, 
						GtkAccelMapForeach foreach_func);

gtk_accel_map_load_fd ()

void 		gtk_accel_map_load_fd 		(gint fd);

Notez que le descripteur de fichier ne sera pas fermé par la fonction.

gtk_accel_map_save_fd ()

void 		gtk_accel_map_save_fd 			(gint fd);

Notez que le descripteur de fichier ne sera pas fermé par la fonction.

gtk_accel_map_load_scanner ()

void 		gtk_accel_map_load_scanner 		(GScanner *scanner);

GScanner variante de gtk_accel_map_load().

gtk_accel_map_add_filter ()

void 		gtk_accel_map_add_filter 		(const gchar *filter_pattern);

Cette fonction est prévue pour les modules de GTK+ qui créent leurs propres menus, but don't want them to be saved into the applications accelerator map dump.

gtk_accel_map_foreach_unfiltered ()

void 		gtk_accel_map_foreach_unfiltered 		(gpointer data,
								 GtkAccelMapForeach foreach_func);

Boucle sur toutes les entrées dans la carte d'accélérateur, et exécute  foreach_func sur chacune. La signature de foreach_func est celle de GtkAccelMapForeach, le paramètre changed indique si cet accélérateur a été chnagé pendant le temps d'exécution (thus, would need saving during an accelerator map dump).

gtk_accel_map_get ()

GtkAccelMap* 		gtk_accel_map_get 		(void);

Depuis 2.4

gtk_accel_map_lock_path ()

void 		gtk_accel_map_lock_path 		(const gchar *accel_path);

Le verrouillage d'un chemin d'accélérateur prévient cet accélérateur d'être modifié pendant le temps d'exécution. Un verrouillage d'un chemin d'accémérateur peut être déverrouillé avec gtk_accel_map_unlock_path().  Référez-vous à gtk_accel_map_change_entry() pour avoir des informations au sujet des changement des accélérateurs pendant le temps d'exécution.

Si elle est appelér plus d'un fois, accel_path le chemin restera verrouillé jusqu'à ce que  gtk_accel_map_unlock_path() ait été appelée un nombre équivalent de fois.

Notez que le verrouillage de chemin d'accélérateur individuellement est indépendant du verrouillage des  GtkAccelGroup qui les contiennent. Pour que des changements d'accélérateur pendant le temps d'exécution soient possibles le chemin d'accélérateur et son  GtkAccelGroup doivent être déverrouillés.

Depuis 2.4

gtk_accel_map_unlock_path ()

void 		gtk_accel_map_unlock_path 		(const gchar *accel_path);

Annule le dernier appel de  gtk_accel_map_lock_path() sur cet accel_path. Référez vous à  gtk_accel_map_lock_path() pour avoir plus d' informations au sujet du verrouillage de chemin d'accélérateur.

Dépuis 2.4

Le signam "changed" 

void 		user_function 		(GtkAccelMap *object,
					 gchar *accel_path,
					 guint accel_key, GdkModifierType accel_mods, 
					 gpointer user_data) : Exécution Dernier / A des Détails

Notifie d'un changement dans la carte d'accélérateur global. Le chemin est aussi utilisé comme détail pour le signal, aussi il est possible de connecter à "changed" ::accel_path.

Depuis 2.4