Basic IDE Tools 1.0.1: Herramientas y utilidades para el IDE Basic

  Ayuda en línea Vers. 1.2, 1.3 - Español  
  Online Help Vers. 1.2, 1.3 - English Translation  

  Ayuda en línea Vers. 1.0.1 - Español  
  Online Help Vers. 1.0.1 - English Translation  

Incluye varios botones que agregan nuevas características y opciones que facilitan el trabajo al programador de macros y aplicaciones a la hora de escribir código Basic.

La extensión se entrega bajo la licencia GNU GPLv3. Antes de utilizar la extensión, por favor, lea los términos de la licencia. Los usuarios hispanohablantes que no entienden el idioma inglés pueden leer una traducción NO OFICIAL de la licencia sólo como orientación de sus condiciones, ya que esta traducción en ningún caso sustituye al texto original en inglés.

La extensión puede ser descargada de la web oficial de extensiones para Apache OpenOffice: Basic IDE Tools Vers. 1.0.1

Tras solicitar permiso para instalarse, y aceptar las condiciones de licencia, la extensión se integrará en su OpenOffice.

Como para cualquier extensión, tendrá que cerrar todas las aplicaciones OpenOffice abiertas, incluido el Inicio Rápido para que, tras arrancar de nuevo OpenOffice, ésta se active correctamente.

Esta extensión utiliza el texto del portapapeles (clipboard) del sistema operativo para leer el texto seleccionado, y tras procesarlo, sustituir el texto seleccionado por el texto procesado. Por tanto no realice operaciones de copiar, cortar o pegar en ninguna aplicación mientras la extensión esté realizando cualquier proceso. El contenido de texto del portapapeles existente antes de utilizar cualquiera de sus opciones es almacenado para ser restaurado tras realizar la opción seleccionada.

Las funcionalidades de los botones se detallan a continuación:

Para aplicar cualquiera de estas opciones:

• Seleccione la o las líneas a las que quiera añadir, eliminar o alternar comentarios, y...
• Haga clic sobre el botón correspondiente, o...
• Utilice uno de estos atajos de teclado:

- Ctrl + Mayúsculas + C Añade comentarios

- Ctrl + Mayúsculas + X Quita comentarios

- Ctrl + Mayúsculas + W Alterna comentarios

Alternar comentarios añade comentarios a las líneas que no los tienen, y quita comentarios a las líneas que sí los tienen.

El siguiente vídeo muestra el funcionamiento de estas tres opciones:

Para aplicar estas opciones:

• Seleccione la o las líneas que quiera indentar, deindentar o reindentar, o...
• Seleccione toda la función o subrutina, o...
• Seleccione todo el código del módulo, y...
• Haga clic sobre el botón correspondiente

La opción Reindentar aplica indentación de forma automática a todo el código seleccionado examinando el código.

El siguiente vídeo muestra el funcionamiento de estos botones:

Reglas que sigue la opción Reindentar

Al aplicar la opción Reindentar se siguen las siguientes reglas:

• Todas las líneas que comiencen por una de las palabras clave Private, Global, Public, Option, Sub, Function se sitúan a nivel cero (sin indentación), al igual que las líneas que contengan las palabras clave End Sub o End Function.

• Todas las líneas que comiencen por una de las palabras clave ', Rem, Dim se indentarán al nivel utilizado por la línea anterior.

• La línea siguiente a una línea que comience por la palabra clave if, que contengan la palabra clave Then y que tras esa palabra contengan código, se indentarán al mismo nivel, por considerar que es una sentencia if then else endif en una sóla línea.

• Se considerarán como líneas decorativas separadoras de código, y se indentarán a nivel cero, todas las que comiencen por los siguientes textos:

'_____

'-----

'*****

' ****

' ++++

rem --

• Las líneas vacías no se indentan. El carácter utilizado para la indentación es el tabulador ( Chr(9) )

• Si la línea termina por la palabra clave : (etiqueta) se indentará a nivel cero.

• Se eliminarán todos los espacios y tabuladores situados al final de las líneas procesadas

Para aplicar esta opción:

• Seleccione la o las líneas que quiere formatear, o...
• Seleccione toda la función o subrutina que desea formatear, o...
• Seleccione todo el código del módulo que desea formatear, y...
• Haga clic sobre el botón Formatear código Basic, o...
• Pulse el atajo de teclado Ctrl + Mayúsculas + F.

Acciones que realiza el formateador de código Basic

Al ejecutar esta opción, se aplican las siguientes acciones sobre el código seleccionado:

• Se leen los nombres de las funciones y subrutinas con el formato mayúsculas/minúsculas tal y como se han escrito en la línea de declaración de la función o subrutina.
• Se leen los nombres de las variables con el formato mayúsculas/minúsculas tal y como se han escrito en la línea de declaración de la función o subrutina al declararlas como argumentos, o en las sentencias Dim, Private, Public, Static o Global.
• Se leen los nombres de las constantes con el formato mayúsculas/minúsculas tal y como se han escrito al declararlas con la sentencia Const.
• Se reemplazan todas las palabras reservadas de Basic por la misma palabra formateada. Por ejemplo, if se sustituye por If, select case por Select Case, msgbox por MsgBox, etc.
• Se reemplazan todas las variables encontradas en el código a partir del punto en que han sido declaradas, así como las asignaciones al nombre de la función a partir del punto de su declaración, por la misma palabra formateada tal y como fué declarada. Por ejemplo, si se declaró la función como Function HolaQueTal, a partir de esa línea, todas las llamadas a la función, como por ejemplo holaquetal u HolaqueTal se reemplazan por el texto HolaQueTal.
• Las líneas comentadas (con ' o con rem) no son modificadas.
• Las cadenas (todo lo que se ha escrito entre comillas ") no son modificadas.
• Durante el proceso se muestra una barra de progreso.

El formateo toma un tiempo, en función del número de líneas seleccionadas y la longitud de éstas. No realice ninguna acción mientras se aplique el formateo del código, como hacer clic en el código, o seleccionar otro módulo, o cualquiera otra acción en el IDE, ni tampoco copiar, cortar y/o pegar en otras aplicaciones; espere a que finalice el proceso.

El siguiente vídeo muestra el funcionamiento de este botón:

Palabras clave reconocidas por el formateador

Ver al final de esta página Palabras clave reconocidas por el formateador.

No formatea algunas variables, constantes o llamadas a funciones o subrutinas

Es posible que observe que en el código no se han sustituido los nombres de variables, constantes, funciones o subrutinas con el formato con que han sido declaradas. Las causas son las siguientes:

• Para que se aplique formato a las variables y constantes en las líneas de código seleccionado, deben estar seleccionadas también las líneas en las que se declaran; en caso contrario, no serán detectadas. Por ello es aconsejable seleccionar todas las líneas entre Sub y End Sub o entre Function y End Function, o mejor, seleccionar todo el código del módulo.

• Para que se aplique formato a las variables y constantes en las líneas de código seleccionado que han sido declaradas a nivel de módulo, deben estar seleccionadas también las líneas en las que se declaran; en caso contrario, no serán detectadas. Por ello es aconsejable seleccionar el módulo completo.

• Si una función o subrutina es llamada en el código antes de su declaración, no podrá ser identificado el formato de su declaración, y por lo tanto, no será reemplazado con el formato declarado. Es conveniente por tanto que las funciones y subrutinas sean declaradas antes de su uso, si bien, sabemos que esto no siempre es posible.

En futuras versiones esperamos solucionar estos tres inconvenientes.

Para buscar el texto seleccionado:

• Seleccione la palabra o el texto que quiere buscar, y...
• Haga clic sobre el botón correspondiente, o...
• Pulse el atajo de teclado:

• F3 para buscar el siguiente (hacia adelante o abajo)
• Mayúsculas + F3 para buscar el anterior (hacia atrás o arriba)

En ordenadores con el sistema MacOs, las teclas de función F3 y Mayúsculas F3 son utilizadas por el sistema, por lo que no estarán activas. Puede personalizar la asignación de atajos de teclado a su gusto. Consulte Personalizar atajos de teclado si no sabe como hacerlo

El siguiente vídeo muestra el funcionamiento de estos botones:

Buscar y reemplazar

Para realizar el proceso Buscar y reemplazar siga el siguiente procedimiento:

1. Seleccione el texto a pegar, y cópielo al portapapeles (por ejemplo, con la combinación de teclas Ctrl + C)
2. Seleccione el primer texto a buscar
3. Pulse el botón de búsqueda deseado o el atajo de teclado equivalente
4. Pegue el contenido del portapapeles (por ejemplo, con la combinación de teclas Ctrl + V)
5. Para seguir buscando y reemplazando, repita desde el paso 3

Para aplicar estas opciones:

• Seleccione el código que quiere convertir
• Haga clic sobre el botón correspondiente

El siguiente vídeo muestra el funcionamiento de estos botones:

Tras pulsar el botón se presenta el siguiente diálogo:

Hemos observado que el botón deshacer del IDE suele presentar errores cuando se intentan deshacer varios pasos. Este error no es debido a Basic IDE Tools. En nuestras pruebas el primer paso de deshacer siempre se ha realizado sin error alguno, y consideramos que no es seguro deshacer más pasos.