Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:ajouter_une_touche [2016/06/11 23:49] – Addition de la description de la procédure Sit Melai
+++ fr:ajouter_une_touche [2021/12/03 19:19] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 1: / Ligne 1: @@
-====== Ajouter une touche ======
+====== Ajouter une touche dans le Client de jeu ======
-====== Fichiers concérnés ======
+===== Fichiers concernés =====
-actions.xml
+  * ''actions.xml''
-hierarchy.xml
+  * ''hierarchy.xml''
-macros.xml
+  * ''macros.xml''
+  * un fichier de Action Handler, par exemple pour les touches de chat: ''client_chat_manager.cpp''
-et un fichier de Action Handler, par exemple pour les touches de chat: client_chat_manager.cpp
+===== Procédure =====
-====== Procédure ======
+Ajoutez dans un fichier C++ (par exemple ''client_chat_manager.cpp'') un //Action Handler// qui utilise //IActionHandler//. Exemple avec une touche de chat:
-. Ajouter dans un fichier c++ (par exemple client_chat_manager.cpp) un Action Handler qui utilise IActionHandler. Exemple avec une touche de chat:
+<code>
-```C++
 class CHandlerChatAction : public IActionHandler
 {
-	void execute (CCtrlBase * /* pCaller */, const std::string &sParams)
+  void execute (CCtrlBase * /* pCaller */, const std::string &sParams)
-	{
+  {
-		//Code à éxécuter pour la touche ChatAction
+    //Code à exécuter pour la touche ChatAction
-	}
+  }
 };
-```
+</code>
-Une fois le code écrit, il faut enregistrer la classe dans le Action Handler:
+Une fois le code écrit, il faut enregistrer la classe dans le //Action Handler// :
-```C++
+<code>
 REGISTER_ACTION_HANDLER( CHandlerChatAction, "chat_action");
+</code>
+<WRAP center round important 90%>
+Choisissez un nom facile à se souvenir, car il va être réutilisé plus tard (ici //chat_action//).
-```
+Utilisez un nom descriptif, en anglais, afin de faciliter la relecture du code par d'autres ensuite.
+</WRAP>
-Faire attention de choisir un nom facile à s'en souvenir, car il va être reutiliser plus tard (ici chat_action).
-. Ajouter dans actions.xml une ligne qui appèle le Action Handler par le nom défini:
+Ajoutez ensuite dans ''actions.xml'' une ligne qui appelle le //Action Handler// pour le nom défini :
-```xml
+<code>
-	<action name="chat_action"				hardtext="uiChatAction">
+  <action name="chat_action" hardtext="uiChatAction">
-```
+</code>
-Le name c'est le nom sous quel l'Action Handler a été enregistrée et le hardtext spécifie l'entré pour quel identifiant dans les fichiers de traduction doit être affiché a l'utilisateur. Il commencera normalement par ui et puis le nom de l'action en CamelCase (attention que l'identifiant n'est pas encore pris!)
+  * Le //name// est le nom sous lequel l'//Action Handler// a été enregistré
+  * Le //hardtext// spécifie l'entrée pour l'identifiant dans les fichiers de traduction, qui sera affiché aux utilisateurs. Il commencera normalement par //ui// suivi du nom de l'action en CamelCase. Attention que l'identifiant ne soit pas déjà pris !
-{{tag>Tag_a_ajouter}}
+{{tag>Client Gameplay Tutoriel client_rc_obsolete}}