Organizing Libraries and Modules

Basic Libraries Containers

LibreOffice Basic libraries can be stored in 3 different containers:

To access macros stored in libraries of LibreOffice Macros or My Macros from another container, including the document container, use the GlobalScope specifier.

Organizing Libraries

Creating a New Library

  1. Choose Tools - Macros - Organize Macros - LibreOffice Basic and click Organizer or click the Select Module icon in the Basic IDE to open the Macro Organizer dialog.

  2. Click the \<emph\>Libraries\</emph\> tab.

  3. Select to where you want to attach the library in the \<emph\>Location\</emph\> list. If you select LibreOffice Macros & Dialogs, the library will belong to the LibreOffice application and will be available for all documents. If you select a document the library will be attached to this document and only available from there.

  4. Click \<emph\>New\</emph\> and insert a name to create a new library.

Import a Library

  1. Choose Tools - Macros - Organize Macros - LibreOffice Basic and click Organizer or click the Select Module icon in the Basic IDE to open the Macro Organizer dialog.

  2. Click the \<emph\>Libraries\</emph\> tab.

  3. Select to where you want to append the library in the \<emph\>Location\</emph\> list. If you select LibreOffice Macros & Dialogs, the library will belong to the LibreOffice application and will be available for all documents. If you select a document the library will be appended to this document and only available from there.

  4. Click \<emph\>Append\</emph\> and select an external library to append.

  5. Select all libraries to be appended in the \<emph\>Append Libraries\</emph\> dialog. The dialog displays all libraries that are contained in the selected file.

  6. If you want to insert the library as a reference only check the \<emph\>Insert as reference (read-only)\</emph\> box. Read-only libraries are fully functional but cannot be modified in the Basic IDE.

  7. Check the \<emph\>Replace existing libraries\</emph\> box if you want existing libraries of the same name to be overwritten.

  8. Click \<emph\>OK\</emph\> to append the library.

Export a Library

  1. Choose Tools - Macros - Organize Macros - LibreOffice Basic and click Organizer or click the Select Module icon in the Basic IDE to open the Macro Organizer dialog.

  2. Click the \<emph\>Libraries\</emph\> tab.

  3. In the Location list you specify where your library is stored. Select the library that you want to export. Note that you cannot export the Standard library.

  4. Click Export...

  5. Choose whether you want to export the library as an extension or as a basic library.

  6. Click \<emph\>Remove\</emph\>.

  7. Select where you want your library exported.

  8. Click \<emph\>OK\</emph\> to append the library.

Deleting a Library

  1. Choose Tools - Macros - Organize Macros - LibreOffice Basic and click Organizer or click the Select Module icon in the Basic IDE to open the Macro Organizer dialog.

  2. Click the \<emph\>Libraries\</emph\> tab.

  3. Select the library to be deleted from the list.

  4. Click \<emph\>Delete\</emph\>.

Organizing Modules and Dialogs

Creating a New Module or Dialog

  1. Choose Tools - Macros - Organize Macros - LibreOffice Basic and click Organizer or click the Select Module icon in the Basic IDE to open the Macro Organizer dialog.

  2. Click the \<emph\>Modules\</emph\> tab or the \<emph\>Dialogs\</emph\> tab.

  3. Select the library where the module will be inserted and click \<emph\>New\</emph\>.

  4. Enter a name for the module or the dialog and click \<emph\>OK\</emph\>.

Renaming a Module or Dialog

  1. Choose Tools - Macros - Organize Macros - LibreOffice Basic and click Organizer or click the Select Module icon in the Basic IDE to open the Macro Organizer dialog.

  2. Click the module to be renamed twice, with a pause between the clicks. Enter the new name.

    In the Basic IDE, right-click the name of the module or dialog in the tabs at the bottom of the screen, choose \<emph\>Rename\</emph\> and type in the new name.

  3. Press Enter to confirm your changes.

Deleting a Module or Dialog

  1. Choose Tools - Macros - Organize Macros - LibreOffice Basic and click Organizer or click the Select Module icon in the Basic IDE to open the Macro Organizer dialog.

  2. Click the \<emph\>Modules\</emph\> tab or the \<emph\>Dialogs\</emph\> tab.

  3. Select the module or dialog to be deleted from the list. Double-click an entry to reveal sub-entries, if required.

  4. Click \<emph\>Delete\</emph\>.

warning

Deleting a module permanently deletes all existing procedures and functions in that module.


Organizing Projects among Documents or Templates

Moving or copying modules between documents, templates and the application.

  1. Open all documents or templates among which you want to move or copy the modules or dialogs.

  2. Choose Tools - Macros - Organize Macros - LibreOffice Basic and click Organizer or click the Select Module icon in the Basic IDE to open the Macro Organizer dialog.

  3. To move a module or dialog to another document, click the corresponding object in the list and drag it to the desired position. A horizontal line indicates the target position of the current object while dragging. Hold the key while dragging to copy the object instead of moving it.

Please support us!