Fichas de referencia LO Basic

Ficha nº 1.
El EDI

Entorno de desarrollo integrado - Nivel: Principiante

Acceso al EDI

El  EDI (Entorno de desarrollo integrado)  es un conjunto de herramientas para escribir y depurar código de macros, para acceder a la interfaz , vaya al menú Herramientas > Macros > Editar macros o bien a Herramientas > Macros > Organizar macros > LibreOffice Basic (Alt+F11), seleccione el módulo que se desee y pulse el botón Editar.

La ventana del EDI se compone de 10 zonas:

➊	Barra de Título	Nombre del contenedor y librería seleccionada.
➋	Menú	Menú dedicado a la gestión de macros.
➌	Barra de herramientas Estándar	Barra de herramientas Estándar, (solo muestra herramientas para la edición y depuración de código).
➍	Barra de Macros	Herramientas para la edición y depuración de código.
➎	Catálogo de objetos	Vista en árbol de los contenedores, muestra librerías, módulos y procedimientos.
➏	Editor de código	Área principal para edición de código, con resaltado de sintaxis, gestión de puntos de interrupción y control de ejecución.
➐	Panel Observador	Control de los contenidos de variables (observador).
➑	Panel Llamadas	Muestra las llamadas a procedimientos y sus parámetros.
➒	Barra Pestañas	Lista y gestiona los módulos de la librería en uso.
➓	Barra de Estado	Estado en tiempo de ejecución.

• Los paneles principales (Catálogo ➎, Editor ➏, Observador ➐ y Llamadas ➑) se pueden desanclar.

• F6 permite pasar de una zona otra.

Barras de herramientas

Si alguna barra no está visible: vaya al menú Ver > Barras de herramientas.

• Los iconos pueden variar en función del sistema operativo y tema de iconos.

Estándar

Dos botones destacables:

	Seleccionar macro	Abre el diálogo Macros de Basic.
	Módulos	Abre el diálogo Organizador de macros BASIC.

Macros

	Biblioteca actual	Selección de la biblioteca que se usará.
	Compilar	Verifica la sintaxis.
	Ejecutar F5	Ejecuta desde el principio el procedimiento en el que está el cursor.
	Detener Shift+F5	Detiene la ejecución en curso.
	Pasar al siguiente Shift+F8	Ejecución paso a paso (La marca de ejecución no sale del procedimiento aunque haya llamadas a otro procedimiento)
	Entrar en el proceso F8	Ejecución paso a paso (La marca de ejecución sale del procedimiento cuando hay llamadas a otro procedimiento)
	Salir del proceso Ctrl+Shift+F8	Ejecución paso a paso (la marca de ejecución vuelve al procedimiento que inició la llamada).
	Act./Desac. punto de interrupción F9	Activa/Desactiva el punto de interrupción de la linea bajo el cursor.
	Gestionar puntos de interrupción	Abre el diálogo Gestión de puntos de Interrupción.
	Act./Des. inspección F7	Activa/Desactiva la inspección de variables.
	Buscar paréntesis
	Importar Basic	Importa código fuente de un archivo *.bas
	Exportar Basic	Exporta el código basic a un archivo *.bas
	Importar diálogo	Importa el código de diálogo de un archivo *.xdl.

Cuadro de diálogo

Esta barra remplaza la barra anterior cuando se edita un diálogo.

	Insertar controles	Muestra el Cuadro de herramientas para insertar controles
	Importar diálogo	Importa el código de diálogo de un archivo *.xdl (XML).
	Exportrar diálogo	Exporta el código de diálogo a un archivo *.xdl (XML).

Cuadro de herramientas

Esta barra aparece al crear o editar un diálogo, muestra el conjunto de controles que puede utilizar en sus diálogos. Sólo se mencionan tres botones destacables.

	Seleccionar elemento	Se entra en modo de selección.
	Gestionar idiomas	Permite crear diálogos multilíngues.
	Previsualizar el diálogo	Para comprobar el diálogo (Esc para salir).

Catálogo de objetos

Muestra los tres contenedores básicos y su contenido: bibliotecas, módulos y macros.

Contenedores 

• Mis macros y diálogos: Específico del usuario, para todos los documentos. Solo accesible por el usuario de la sesión abierta.

• Macros y diálogos de la aplicación (macros globales): Macros almacenadas dentro del contenedor global de LibreOffice. Como tal, pueden ser visualizadas y utilizadas por cualquiera, forman parte de la instalación de LibreOffice.

• Sin título 1 (en el ejemplo): Pertenecen al documento abierto.

Bibliotecas

Cargadas (en color)  o sin cargar (gris).

• La biblioteca Standard: A excepción de Macros y diálogos de la aplicación, todo contenedor tiene una biblioteca Standard.

• La biblioteca Standard se carga siempre, al abrir el programa o el documento: No se puede eliminar, no se puede sobreescribir mediante la importación de código y no se pude cifrar.

Módulos 

Agrupan las subrutinas o procedimientos.

Subrutinas o procedimientos 

Editor de código

Se utiliza en el desarrollo del código (con resaltado de sintaxis) y su depuración.

Elementos del panel de edición

➊	Canal	Margen lateral en el que se colocan las marcas de punto de interrupción ➍ y se muestra el punto de ejecución ➎.
➋	Numeros de línea	Permiten una navegación más fácil.
➌	Éditor	Para escribir el código Basic (con resaltado de sintaxis).

Sangría de líneas

Utilice Tab o Shift+Tab para aumentar/disminuír la sangría de líneas.

• Estos atajos sirven para aplicar sangria a varias lineas seleccionadas.

Coloreado de sintaxis

Los colores se pueden cambiar por unos preestablecidos en Ver > Combinación de colores o por otros más personalizados en Herramientas > Opciones > LibreOffice > Apariencia  Sección Personalizaciones, Editor de Basic.

Mostrar/ocultar los números de línea

Muestre u oculte los números de línea mediante el menú Ver > Números de renglón.

• Para la gestión de puntos de interrupción y retomar la ejecución vea Depuración.

Ir al renglón

El atajo Ctrl+L abre un diálogo que permite desplazarse a la linea especificada.

Panel de Observador

Permite visualizar el contenido de variables durante la ejecución (vea Depuración).

Tiene tres columnas (ajustables en anchura) :

• Nombre de la variable, Valor y Tipo

Añadir un observador

1. En el código seleccione la variable o constante para inspeccionar (puede ingresar su nombre en el campo Observador del panel)

2. haga clic en el botón Activar observador  o F7

Eliminar un observador

Seleccione el observador que desea retirar y haga clic en el botón Eliminar observador .

Panel Llamadas

Durante la ejecución paso a paso crea un historial de llamadas a  los procedimientos, Estas van apareciendo según su ejecución (la más antigua abajo), y muestra los parámetros de ejecución. el procedimiento en curso se numera con 0 y el resto de manera consecutiva.

Barra de pestañas

Muestra la lista de los módulos y diálogos de la biblioteca en uso.

Los módulos se muestran en orden alfabético de izquierda a derecha. Haga clic derecho en la barra de pestañas para gestionar los módulos

Insertar > Módulo de Basic	Crea un nuevo módulo (ModuleN).
Insertar > Diálogo de Basic	Crea un nuevo diálogo Basic (DialogN).
Eliminar	Elimina el módulo o diálogo seleccionado.
Cambiar nombre	Renombra el módulo o diálogo seleccionado.
Ocultar	Oculta temporalmente el módulo o diálogo seleccionado.
Módulos	Abre el diálogo Organizador de macros.

Barra de Estado

De izquierda a derecha indica:

• Nombre completo del procedimiento en la que se encuentra el cursor.

• El Número de linea (Rn) y columna (Col) donde se encuentra el cursor.

• Modo de edición del código (se cambia al modo de Sobrescritura al pulsar Ins).

• Deslizador y porcentaje de zum.

Depuración

Depuración es la comprobación de la ejecución de una macro

• Esta operación se efectúa mediante la ejecución de la parte elegida en modo paso a paso, mientras se observa el contexto de ejecución (Valores de variables) .

La depuración se apoya simultáneamente en los tres paneles: El Editor de código ➏, el panel Llamadas ➐ y el panel Observador ➑. Se realiza mediante el control de los botones paso a paso (barra de herramientas Macros ➍) y los puntos de interrupción.

Modos de ejecución

Cinco botones controlan la manera en que se ejecuta el código. La marca de ejecución  permite conocer su avance en el editor.

• Si ha iniciado la ejecución (en cualquier modo) cuando el cursor se encuentra en un procedimiento que necesita que se le pasen parámetros (no opcionales), recibirá el mensaje de error: El argumento no es opcional.

	Ejecutar Shift+ F5	Ejecuta el procedimiento donde se encuentra el cursor. La ejecución se detiene al encontrar un punto de interrupción.
	Detener F5	Detiene la ejecución.
	Pasar al siguiente Shift+F8	Ejecución paso a paso (línea tras línea) sin entrar en otros procedimientos.
	Entrar en proceso F8	Ejecución paso a paso (saliendo a otros procedimientos cuando hay llamadas).
	Salir del proceso Ctrl+Shift+F8	Ejecución paso a paso volviendo al procedimiento que inició la llamada.

Gestionar puntos de interrupción

Punto de Interrupción: Marca donde se detiene la ejecución del código. Permite examinar el contexto de ejecución en ese momento (valores de los testigos).

• Durante la depuración se pueden realizar las siguientes acciones:

Añadir punto de interrupción

Doble clic en el canal al lado de la linea en que quiera insertar el punto o F9 (en la línea con el cursor).

Eliminar punto de interrupción

Doble clic en el canal  sobre el punto de interrupción o (F9 en la línea).

Desactivar/Activar punto de interrupción

Haga clic derecho en el canal sobre el punto de interrupción y seleccione Activo. El icono del punto de interrupción cambia entre activo  e inactivo .

Diálogo Gestionar puntos de interrupción

Haga clic derecho sobre el cusor de ejecución o punto de interrupción existente y seleccione Gestionar puntos de interrupción o botón  de la barra de herramientas

(Campo de inserción y lista)	Números de linea en la que se encuentran los puntos de interrupción. Seleccione el que le interese o cree uno nuevo.
Activo	Marque o desmarque para activar/desactivar el punto seleccionado.
Recuento de pasadas	Permite desactivar el punto de interrupción después del número de pasadas definido.
Nuevo	Escriba un número de linea en el campo superior y luego pulse este botón para un nuevo punto de interrupción.
Eliminar	Elimina el punto de interrupción seleccionado.

Personalizar el EDI

LibreOffice permite personalizar el EDI, mediante el menú: Herramientas > Opciones > LibreOffice > EDI de Basic

Activar compleción de código	El IDE completa automáticamente los métodos de objeto Basic. No se aplica a objetos personalizados y la opción Usar tipos extendidos debe estar activada.
Corrección automática	Corrige la sintaxis de las palabras clave y nombres de variables
Cerrar comillas automáticamente	Al escribir comillas dobles de apertura el IDE agrega las de cierre.
Cerrar paréntesis automáticamente	Al escribir paréntesis de apertura, el IDE agrega los de cierre.
Cerrar procedimientos atomáticamente	Al declarar un procedimiento Sub Xxx o Function Xxx, se agrega automáticamente  End Sub o End Function.
Usar tipos extendidos	(Necesario para la compleción de código). Permite utilizar tipos de objetos UNO como tipos Basic válidos.

Trucos y consejos

Copiar una biblioteca de un contenedor a otro

1. Abra el documento/contenedor origen.

2. Abra el Organizador de macros , pestaña Bibliotecas.

3. Exportar > Exportar como biblioteca Basic.

4. Abra el documento/contenedor destino y pulse Importar.

Mover / copiar módulos de una biblioteca a otra

(En el mismo documento o entre documentos/contenedores)

1. Abra los dos documentos/contenedores origen y destino.

2. Abra el Organizador de macros .

3. Arrastre y suelte desde el origen al destino.

• De manera predeterminada, los módulos se mueven. Para copiarlos mantenga pulsada la tecla Ctrl mientras los arrastra.

Ocultar los módulos

Permite simplificar la lista de pestañas ocultando los módulos temporalmente: Haga clic derecho en la pestaña y elija Ocultar. Para visualizar de nuevo la pestaña oculta de un módulo haga clic derecho, elija Módulos y seleccione el módulo oculto.

Cifrar bibliotecas

El cifrado de bibliotecas permite proteger el código.

1. Abra el Organizador de macros , pestaña Bibliotecas.

2. Seleccione la ubicación y la biblioteca.

3. Pulse el botón Contraseña.

4. Introduzca la contraseña, confirme la contraseña y valide.

• Se puede cifrar cualquier biblioteca excepto la biblioteca Standard.

• Advertencia !
  El cifrado es muy sólido (AES) : ¡Si olvida la contraseña es irremediable!

• Conserve siempre una versión no cifrada.

Limpiar una importación de MSOffice

• ¡Trabaje siempre con una copia del archivo!

1. Elimine las bibliotecas y módulos innecesarios procedentes de la importación.

2. Guarde el archivo como «texto sin formato» (ej : .fods).

3. Abra el archivo con un editor de texto que admita XML.

4. Busque la etiqueta <office:scripts> y elimine toda la sección entre <ooo:library-embedded ooo:name="Standard"> y </ooo:library-embedded>.

5. Guarde el archivo, abra el archivo con LibreOffice y recree el árbol de bibliotecas/módulos (copie/pegue el código deseado desde el documento original al nuevo).

Atajos de teclado

Diálogo de acceso a macros	Alt+F11	Detener ejecución	Shift+F5
Ir a una linea	Ctrl+L	Entrar en proceso	F8
Punto de interrupción	F9	Pasar al siguiente	Shift+F8
Activar inspección	F7	Salir de proceso	Ctrl+Shift+F8
Ejecutar	F5	Moverse entre zonas	F6

Contenido

• Acceso al EDI

• Barras de herramientas

• Catálogo de objetos

• Editor de código

• Panel de Observador

• Panel Llamadas

• Barra de pestañas

• Barra de Estado

• Depuración

• Personalizar el EDI

• Trucos y consejos

• Atajos de teclado