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

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 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 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 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 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:

Al seleccionar esta opción de la barra de herramientas se muestra un diálogo con más de 2000 códigos ASCII

Al seleccionar esta opción de la barra de herramientas se muestra un diálogo que permite insertar bloques de código predefinidos, incluyendo Function, Sub, condicionales IF y Select, bucles For, Do, While, varios bloques UNO dispatcher, On local error, definición de Type, funciones Array2String y String2Array, y todas las variaciones de MsgBox.

Tras hacer clic sobre el botón de la barra de herramientas se presenta el siguiente diálogo solicitando confirmación para insertar el código necesario:

Al aceptar se incorpora el siguiente bloque de código en la posición actual del cursor:

BIT_Inspector_Explores( oObjeto, False) ' True => Salida hacia Calc

En donde debes sustituir oObjeto por el objeto a examinar, e indicar True en el segundo argumento si deseas obtener la salida en una hoja de Calc.

Ejemplos de uso del inspector

• Muestra la ventana Inspector que examinará la aplicación actual

BIT_Inspector_Explores ThisComponent

• Ejecuta el Inspector y presenta el resultado en una hoja de cálculo Calc

BIT_Inspector_Explores ThisComponent, true

• Muestra la ventana Inspector que examinará el objeto oSheet

dim oSheet as Object
oSheet = ThisComponent.getSheets(0)
BIT_Inspector_Explores oSheet

• Muestra la ventana Inspector que examinará los objetos oDoc, oSelection y oModel

dim oDoc as Object, oSelection as Object, oModel as Object
oDoc = ThisComponent.CurrentController()
oModel = oDoc.Model
oSelection = oDoc.Selection
 
BIT_Inspector_Explores oDoc
BIT_Inspector_Explores oModel
BIT_Inspector_Explores oSelection

El resultado obtenido será un diálogo similar al mostrado a continuación:

• Utiliza el botón >> Calc para obtener una copia en una hoja de Calc
• Utiliza el botón Copiar para pegar la línea seleccionada en el portapapeles.

Tras hacer clic sobre el botón de la barra de herramientas, se presentará el siguiente diálogo, en el que automáticamente se habrá pegado el texto a buscar previamente seleccionado:

Puedes editar el texto a buscar, y seleccionar las webs donde buscará utilizando las opciones disponibles.

Tras pulsar sobre el botón Buscar se abrirá tu explorador de Internet predeterminado con una búsqueda de Google restringida a las webs seleccionadas.

Esta opción no se activa en las versiones 4.1.x y posteriores, dado que ya se ha implementado un popup menú propio del editor IDE.

Este par de botones permiten activar y desactivar un PopUp menú que se muestra al hacer clic secundario en el editor IDE Basic.

Es necesario desactivar esta opción si ejecutas tu código con Debug, pues al detectar las pulsaciones del ratón hace impracticable el seguimiento de tu código

Tras hacer clic sobre el botón Activar de la barra de herramientas se muestra este diálogo, indicando que se ha activado el PopUp.

Si es necesario, selecciona el texto que deseas copiar, formatear, indentar, etc... Tras hacer clic secundario sobre el texto seleccionado, se muestra el siguiente PopUp menú:

Si seleccionaste la llamada a una función o subrutina, al hacer clic sobre la opción Definición intentará localizar en el código la definición de la misma y si la encuentra, la presentará en pantalla. La búsqueda se realiza dentro de la librería que se está editando.

Tras hacer clic sobre el botón Desactivar de la barra de herramientas se muestra este diálogo, indicando que se ha desactivado el PopUp.

Al cerrar el editor IDE Basic se finaliza con la utilidad, por lo que es necesario volver a activarla cada vez que se inicia el editor.

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.