summaryrefslogtreecommitdiff
path: root/doc/fr
diff options
context:
space:
mode:
Diffstat (limited to 'doc/fr')
-rw-r--r--doc/fr/autogen/plugin_api/hdata.txt3
-rw-r--r--doc/fr/autogen/user/weechat_commands.txt1
-rw-r--r--doc/fr/weechat_plugin_api.fr.txt124
-rw-r--r--doc/fr/weechat_scripting.fr.txt2
4 files changed, 130 insertions, 0 deletions
diff --git a/doc/fr/autogen/plugin_api/hdata.txt b/doc/fr/autogen/plugin_api/hdata.txt
index a5c0e0608..a73749fc5 100644
--- a/doc/fr/autogen/plugin_api/hdata.txt
+++ b/doc/fr/autogen/plugin_api/hdata.txt
@@ -405,6 +405,9 @@
| weechat | key | une touche (un raccourci clavier) |
'key' (string) +
+ 'area_type' (pointer) +
+ 'area_name' (pointer) +
+ 'area_key' (string) +
'command' (string) +
'prev_key' (pointer, hdata: 'key') +
'next_key' (pointer, hdata: 'key') |
diff --git a/doc/fr/autogen/user/weechat_commands.txt b/doc/fr/autogen/user/weechat_commands.txt
index 9db6ae628..3e0a3774a 100644
--- a/doc/fr/autogen/user/weechat_commands.txt
+++ b/doc/fr/autogen/user/weechat_commands.txt
@@ -366,6 +366,7 @@ Pour le contexte "mouse" (possible aussi pour le contexte "cursor"), la touche a
item(xxx): l'objet de barre "xxx"
La touche peut commencer ou se terminer par '*' pour plusieurs évènements de la souris.
Une valeur spéciale pour la commande avec le format "hsignal:nom" peut être utilisée dans le contexte "mouse", cela enverra le signal "nom" avec la hashtable du focus comme paramètre.
+Une autre valeur spéciale "-" peut être utilisée pour désactiver la touche (elle sera ignorée lors de la recherche de touches).
Exemples:
touche alt-x pour activer/désactiver la liste des pseudos:
diff --git a/doc/fr/weechat_plugin_api.fr.txt b/doc/fr/weechat_plugin_api.fr.txt
index 9b57d487b..98e967ec6 100644
--- a/doc/fr/weechat_plugin_api.fr.txt
+++ b/doc/fr/weechat_plugin_api.fr.txt
@@ -5739,6 +5739,130 @@ elif rc == weechat.WEECHAT_CONFIG_OPTION_UNSET_ERROR:
# ...
----------------------------------------
+[[key_bindings]]
+Associations de touches
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Fonctions pour les associations de touches.
+
+weechat_key_bind
+^^^^^^^^^^^^^^^^
+
+Ajouter de nouvelles associations de touches.
+
+[NOTE]
+Contrairement à la commande `/key bind`, cette fonction ne changera jamais
+une association de touche existante, seulement des nouvelles touches seront
+créées. Pour supprimer une association de touche, utilisez
+<<_weechat_key_unbind,weechat_key_unbind>>.
+
+Prototype :
+
+[source,C]
+----------------------------------------
+int weechat_key_bind (const char *context, struct t_hashtable *keys);
+----------------------------------------
+
+Paramètres :
+
+* 'context' : contexte pour les touches :
+** 'default' : contexte par défaut (actions courantes)
+** 'search' : contexte de recherche (lors de la recherche de texte dans le
+ tampon)
+** 'cursor' : mouvement libre du curseur à l'écran
+** 'mouse' : touches pour les évènements de souris
+* 'keys' : hashtable avec les associations de touches
+
+Valeur de retour :
+
+* nombre d'associations de touches ajoutées
+
+Exemple en C :
+
+[source,C]
+----------------------------------------
+struct t_hashtable *keys = weechat_hashtable_new (8,
+ WEECHAT_HASHTABLE_STRING,
+ WEECHAT_HASHTABLE_STRING,
+ NULL,
+ NULL);
+if (keys)
+{
+ weechat_hashtable_set (keys, "@chat(plugin.buffer):button1", "hsignal:test_mouse");
+ weechat_hashtable_set (keys, "@chat(plugin.buffer):wheelup", "/mycommand up");
+ weechat_hashtable_set (keys, "@chat(plugin.buffer):wheeldown", "/mycommand down");
+ weechat_key_bind ("mouse", keys);
+ weechat_hashtable_free (keys);
+}
+----------------------------------------
+
+Script (Python) :
+
+[source,python]
+----------------------------------------
+# prototype
+num_keys = weechat.key_bind(context, keys)
+
+# exemple
+keys = { "@chat(python.test):button1": "hsignal:test_mouse",
+ "@chat(python.test):wheelup": "/mycommand up",
+ "@chat(python.test):wheeldown": "/mycommand down" }
+weechat.key_bind("mouse", keys)
+----------------------------------------
+
+weechat_key_unbind
+^^^^^^^^^^^^^^^^^^
+
+Supprimer une/des association(s) de touche(s).
+
+[WARNING]
+When calling this function, ensure that you will not remove a user key binding.
+
+Prototype :
+
+[source,C]
+----------------------------------------
+int weechat_key_unbind (const char *context, const char *key);
+----------------------------------------
+
+Paramètres :
+
+* 'context' : contexte pour les touches (voir
+ <<_weechat_key_bind,weechat_key_bind>>)
+* 'key' : touche à supprimer ou la valeur spéciale "area:XXX" pour supprimer
+ toutes les touches ayant 'XXX' comme première ou deuxième zone
+
+Valeur de retour :
+
+* nombre d'associations de touches supprimées
+
+Exemples en C :
+
+[source,C]
+----------------------------------------
+/* supprimer une seule touche */
+weechat_key_unbind ("mouse", "@chat(plugin.buffer):button1");
+
+/* supprimer toutes les touches avec la zone "chat(plugin.buffer)" */
+weechat_key_unbind ("mouse", "area:chat(plugin.buffer)");
+----------------------------------------
+
+Script (Python) :
+
+[source,python]
+----------------------------------------
+# prototype
+num_keys = weechat.key_unbind(context, key)
+
+# exemples
+
+# supprimer une seule touche
+weechat.key_unbind("mouse", "@chat(plugin.buffer):button1")
+
+# supprimer toutes les touches avec la zone "chat(python.test)"
+weechat.key_unbind("mouse", "area:chat(python.test)")
+----------------------------------------
+
[[display]]
Affichage
~~~~~~~~~
diff --git a/doc/fr/weechat_scripting.fr.txt b/doc/fr/weechat_scripting.fr.txt
index 30196097b..3b3b88436 100644
--- a/doc/fr/weechat_scripting.fr.txt
+++ b/doc/fr/weechat_scripting.fr.txt
@@ -275,6 +275,8 @@ Liste des fonctions de l'API script :
config_free, +
config_get, config_get_plugin, config_is_set_plugin, config_set_plugin,
config_set_desc_plugin, config_unset_plugin
+| associations de touches |
+ key_bind, key_unbind
| affichage |
prefix, color, print (for python: prnt), print_date_tags (for python:
prnt_date_tags), print_y (for python: prnt_y), log_print