3.5. Describiendo interacción con la aplicación

En el siguiente ejemplo describiremos la manera como interactúa el usuario con una aplicación a través de los menús o mediante combinaciones de teclado

<sect1>
  <title>Escribiendo y guardando un archivo</title>
      
    <para>Dentro del editor escriba la frase <userinput>Hola
    Mundo</userinput> y posteriormente guarde dicho archivo usando
    <menuchoice>
      <shortcut>
        <keycombo action="seq">
	  <keysym>C-x</keysym><keysym>C-s</keysym>
	</keycombo>
      </shortcut>
      <guimenu>Files</guimenu> <guimenuitem>Save Buffer
      as</guimenuitem> 
    </menuchoice>, a continuación <application>emacs</application> 
    responderá con el mensaje <computeroutput>File to save
    in:~/20013/doc-tut/e2</computeroutput>, restando que usted
    escriba solamente el nombre del archivo
   (<filename>hola.txt</filename>).</para>
</sect1>

y la manera como se ve dicho código es

Dentro del editor escriba la frase Hola Mundo y posteriormente guarde dicho archivo usando Files->Save Buffer as (C-x C-s), a continuación emacs responderá con el mensaje File to save in:~/20013/doc-tut/e2, restando que usted escriba solamente el nombre del archivo (hola.txt).

Dentro de este ejemplo hemos usado la marquilla menuchoice que indica la interacción con la aplicación através de menús. Para seleccionar cada interacción con el menú lo hacemos a través de guimenu y guimenuitem.

Sugerencia

Existen marquillas como guibutton y guiicon que permiten describir la interacción con botones o iconos dentro de una aplicación.

Otro punto importante de este ejemplo consiste en la utilización de shortcut que indica un atajo de interacción a través del teclado. Dentro de este usamos keycombo, que nos permite describir una combinación de teclas. Tal marquilla tiene el atributo action, el cual sirve para describir como se efectúa la combinación de teclas, que puede ser secuencial (seq) o simultánea (simul). La marquilla keysym se usa cuando se quiere indicar un símbolo que significa una tecla (o combinación de teclas) especial.

La última observación consiste en que cuando se haga referencia a un nombre de un archivo es conveniente usar filename. En caso de que uno hable de un directorio debe usar el atributo de dicha marquilla class igual a directory