The tree titled with Macro from shows the complete library hierarchy that is available the moment the dialog is opened. See Advanced Library Organization for details about the library organization in OpenOffice.org.
Unlike the library organization API, this dialog does not distinguish between Basic and dialog libraries. Usually the libraries displayed in the tree are both Basic and dialog libraries.
|Although it is possible to create Basic-only or dialog-only libraries using the API this is not the normal case, because the graphical user interface (see OpenOffice.org Basic Macro Organizer Dialog below) only allows the creation of Basic and dialog libraries simultaneously. Nevertheless, the dialog can also deal with Basic-only or dialog-only libraries, but they are not marked in any way.|
The tree titled Macro from represents a structure consisting of three levels:
Library container -> library -> library element
- The top-level nodes represent the application Basic and dialog library container (nodes
OpenOffice.org Macros). For each opened document, the document's Basic and dialog library container (see Advanced Library Organization). In the example two documents are open, a text document called Description.odt and a spreadsheet document named Calculation.ods.
- In the second level, each node represents a library. Initially all libraries, except the default libraries named
Standard, are not loaded and grayed out. To load a library, the user double-clicks the library. In the example above, the
My Macrosroot element contains the
Standardlibrary, already loaded by default.
- The third level in the tree is visible in loaded libraries. Each node represents a library element that can be modules or dialogs. In the OpenOffice.org Basic Macros dialog, only Basic modules are displayed as library elements, whereas dialogs are not shown. By double-clicking a library the user can expand and condense a library to show or hide its modules. In the example, the
My Macros/Standardlibrary is displayed expanded. It contains two modules,
Module2. The document Description.odt contains a
Standardlibrary with one Basic module
Module1. Calculation.ods contains a
Standardlibrary without Basic modules. All libraries, respectively their dialog library part,may also contain dialogs that cannot be seen in this view.
If a library is password-protected and a user double-clicks it to load it, a dialog is displayed requesting a password. The library is only loaded and expanded if the user enters the correct password. If a password-protected library is loaded using the API, for example, through a call to
BasicLibraries.loadLibrary("Library1"), it is displayed as loaded, not grayed out, but it remains condensed until the correct password is entered (see Advanced Library Organization).
The middle column contains information about the macros, that is, the Subs and Functions, in the libraries. In the list box at the bottom, all Subs and Functions belonging to the module selected in the tree are listed. In the edit field titled Macro name, the Sub or Function currently selected in the list box is displayed. If there is no module selected in the tree, the edit field and list are empty. You can type in a desired name in the edit field.
|Content on this page is licensed under the Public Documentation License (PDL).|