Contents

# Organizing Libraries and Modules

## Basic Libraries Containers

LibreOffice Basic libraries can be stored in 3 different containers:

- Application Macros: libraries stored in this container are available for all users of the computer and are managed by the computer administrator. The container is located in the LibreOffice installation directory.

- My Macros: libraries stored in this container are available to all documents of your user. The container is located in the user profile area and is not accessible by another user.

- Document: libraries stored in the document container are only available for the document and are accessible only when the document is open. You cannot access macros of a document from another document.

To access macros stored in libraries of Application 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 - Basic and click Organizer or click the Select Module icon in the Basic IDE to open the Macro Organizer dialog.

2. Click the Libraries tab.

3. Select to where you want to attach the library in the Location list. If you select Application 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 New and insert a name to create a new library.

### Import a Library

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

2. Click the Libraries tab.

3. Select to where you want to import the library in the Location list. If you select Application 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 imported to this document and only available from there.

4. Click Import... and select an external library to import.

5. Select all libraries to be imported in the Import Libraries 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 Insert as reference (read-only) box. Read-only libraries are fully functional but cannot be modified in the Basic IDE.

7. Check the Replace existing libraries box if you want existing libraries of the same name to be overwritten.

8. Click OK to import the library.

### Export a Library

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

2. Click the Libraries 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 OK.

7. Select where you want your library exported.

8. Click Save to export the library.

### Deleting a Library

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

2. Click the Libraries tab.

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

4. Click Delete.

- Deleting a library permanently deletes all existing modules and corresponding procedures and functions.

- You cannot delete the default library named "Standard".

- If you delete a library that was inserted as reference only the reference is deleted but not the library itself.

## Organizing Modules and Dialogs

### Creating a New Module or Dialog

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

2. Click the Modules tab or the Dialogs tab.

3. Select the library where the module will be inserted and click New.

4. Enter a name for the module or the dialog and click OK.

### Renaming a Module or Dialog

1. Choose Tools - Macros - Organize Macros - 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 Rename and type in the new name.

3. Press Enter to confirm your changes.

### Deleting a Module or Dialog

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

2. Click the Modules tab or the Dialogs 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 Delete.

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 - 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 CommandCtrl key while dragging to copy the object instead of moving it.

Please support us!