Nombres de iconos, menus y acciones en gvSIG 2.0 III: convenios de nombrado.

En el articulo anterior, “Nombres de iconos, menus y acciones en gvSIG 2.0 II: aplicándolo en gvSIG.“, hemos visto como definir una acción y como usarla en menús y botones en la aplicación. Le hemos dado nombre a la acción, a su icono, hemos elegido un “action-command” y le hemos dado una posición. Ahora bien, a la hora de elegir estas cosas no lo he hecho de forma aleatoria, he seguido algunas pequeñas reglas que deberíamos seguir a la hora de hacerlo. Lo primero que tendríamos que pensar es que toda acción debe tener una entrada en los menús principales de gvSIG. Nunca debería haber una acción en un botón o menú contextual que no este representada en los menús. En nuestro ejemplo, hemos situado la acción en la entrada de menú:

  • Tools
    • Symbology
      • Import point symbols

La regla general para nombrar una acción seria la ruta completa en los menús, en inglés, separando las entradas de menús por ““, reemplazando espacios por “” y eliminando otros símbolos de puntuación que puedan haber. Así el nombre de la acción sera “tools-symbology-import-point-symbols“. Podría suceder que el nombre la acción entrase en conflicto con otra acción, por ejemplo, la entrada de menú:

  • Selection
    • Select all

Se usaría para seleccionar todas las filas de una tabla, o todos los elementos del mapa o las geometrías de la capa activa en la vista. Tendríamos tres acciones distintas, y lo que haríamos seria añadir un sufijo al final del nombre de la acción indicando sobre que objeto se aplica la acción. Así tendríamos:

  • selection-select-all-table
  • selection-select-all-layout
  • selection-select-all-layer

Siguiendo estas pequeñas consideraciones nombraremos a nuestra acción, y una vez tengamos el nombre de nuestra acción, pasaremos a nombrar el resto de elementos de la acción.

Deberemos elegir ahora el nombre usado para el “action-command“. Como regla general, usaremos el mismo nombre de la acción.

Lo siguiente que tendremos que seleccionar seria el nombre del icono. Seguiremos tres pequeñas reglas:

  • Si la acción esta contemplada entre las acciones recogidas por el proyecto Tango Desktop Project, de freedesktop.org se usara el nombre de icono que esta propone.
  • Si no se ha añadido a la acción un sufijo, se usara el nombre de la acción.
  • Si se ha añadido un sufijo a la acción, se usara el nombre de la acción eliminando el sufijo.

Por ultimo, deberemos asignar una posición a nuestra acción. En la versión 2 de gvSIG se ha establecido el siguiente convenio para establecer las posición de la acción:

AAABBBCCCD

Donde:

  • AAA, representa al menú de primer nivel dentro del menú de gvSIG. Se han establecido los siguientes valores:
    • 10 para el menú Archivo
    • 20 para el menú Edición
    • 30 para el menú Selección
    • 40 para el menú Mostrar
    • 50 para el menú Tabla
    • 60 para el menú Capa
    • 65 para el menú Vista
    • 70 para el menú Mapa
    • 90 para el menú Herramientas
    • 96 para el menú Ventana
    • 99 para el menú Ayuda
  • BBB, tres dígitos rellenos a ceros por la izquierda representando la posición dentro del menú AAA. En el caso en que no proceda indicaríamos “000”.
  • CCC, en caso de que la entrada en BBB sea un submenú, esta indica la posición dentro de este submenú. También va relleno a ceros por la izquierda, y en el caso de que no proceda indicaremos “000”.
  • D, en caso de que la entrada en CCC sea un submenú, esta indica la posición dentro de este submenú. En el caso de que no proceda indicaremos “0”.

Con estos valores compondríamos el valor de la posición, que sera usada para situar una acción respecto a otras siempre que se vayan a presentar al usuario.

En el caso del ejemplo la posición indicada es “900400200”:

  • 90, menú “Tools
    • 040, submenu “Symbology
      • 020, posición dentro del menú symbology de la entrada “Import point symbols
        • 0, no procedería así que se deja un cero.

En gvSIG se han incluido una serie de herramientas que nos permiten ver la lista de acciones o las entradas de menús que están instaladas en un momento dado. Podemos ir a la opción de menú:

  • Tools
    • Devel
      • Show menú information

Para obtener un listado de las entradas de menú, en donde podemos ver su posición para hacernos una idea de donde debemos colocar la nuestra y que numero de posición tendríamos que asignarle.

En el mismo menú Devel, tenemos una opción “Show action information” que nos mostrara un listado de todas las acciones registradas en la aplicación ordenadas por plugin que las aporta.

Se puede obtener un listado de las acciones y entradas de menús de la aplicacion accediendo a el menu “Herremientas->development->Show actions information”

About Joaquin del Cerro

Development and software arquitecture manager at gvSIG Team. gvSIG Association
This entry was posted in development, gvSIG Desktop, gvSIG development, spanish. Bookmark the permalink.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s