12525
Commento:
|
10230
ready for #70
|
Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
Linea 4: | Linea 4: |
= Testo inglese = LibreOffice Part 23: Base Form Enhancements with Macros by Elmer Perry For the previous four parts of this series, we have slowly built a database document using LibreOffice's Base module. We have a database with forms to enter our data, and queries and reports for extracting the data. We now have a usable document for recording our book library. However, our current design has one flaw we need to overcome. If we need to enter a new author or media type while we are in the books form, we have to close the book form and open one of the others. If we could enter new authors and media types directly from the books form, it would behave more like an application and make data entry even easier. We can accomplish this through a few short macros. The LibreOffice Basic language is very similar to other Basic languages, such as Visual Basic for Applications. To manipulate the underlying LibreOffice document, we access the Uno framework controlling the document. The Uno framework is quite complex, but I will explain, as best I can, the properties and objects we will use. The goal is not to teach you how to write LibreOffice macros, but how you can use them. Macro Security and Options While macros allow us to do cool things in our documents, they can also cause problems. Some people use macros to compromise other people's systems, therefore, we need to take a few minutes to talk about macro security. Whether you are running LibreOffice on Linux, Mac, or Windows, malicious code in a macro can compromise your data and possibly your entire system. Macro security in LibreOffice is simple. Tools > Options opens the Options dialog for LibreOffice. Under LibreOffice, select Security. Click on the Macro Security button to pop up the macro security options. You have four options. Never use the Low security option – it will run macros without asking you. I recommend the Medium security level. With this level, you are prompted whether to run the macros when you open a document containing macros. The High and Very High options require a certificate or folder you designate as trusted. While this is great, I believe nothing trumps the instincts of the user. You usually know whether you were expecting a document to contain macros. When in doubt, click No. Click OK to save your choice and OK to close the options dialog. Now, on to the fun stuff. The Macros We will write four macros for our database document. Three will deal with opening forms, and the last will update the list boxes for authors and media types. The general idea behind macros is to accomplish tasks that are not built into the program, or to simplify complex tasks. Our macros really accomplish both, as we will simplify the tasks of adding authors and media types and provide functionality not built into the program. Before we can begin to write our macros, we need a container to hold them. Macros are contained in a module. Modules can live in the program itself or within a document. Since our macros are specific to our database file, we will embed them in the document. Macros embedded in a document are available only when the document is loaded. Macros contained in the program are available as long as the program is running. Tools > Macros > Organize Macros > LibreOffice Basic. The LibreOffice Basic Macros dialog pops up. Select book.odb from the Macro from-list. Click the New button. A dialog pops up asking you for a name for the module. Name it FormCalls. Click OK. This brings up the LibreOffice macro editor. The macro comes with a default main subroutine. We will not use this subroutine. Highlight Sub main and End Sub and press the backspace key to delete them. Our first macro is a generalized subroutine for opening a form. A generalized subroutine is written for reuse. We will call this routine twice from other routines we write. Type this subroutine into the editor: {{{ Sub OpenAForm (FormName as String) Dim GetForm as Object GetForm = ThisDatabaseDocument.FormDocuments.GetByName(FormName) GetForm.Open End Sub }}} The first line of the subroutine is called the signature. The signature determines how the subroutine is called. A signature starts with the keyword Sub, which defines this call as a subroutine. Next, the name of the subroutine. In our case, OpenAForm is the name of the subroutine. Finally in the parenthesis, we have the arguments used when calling this subroutine. In our case, we have a variable named FormName which is a type String. In the second line of the subroutine, Dim is another keyword. Dim initializes a variable as a type, and, optionally, a value. We define a variable named GetForm as a type Object. The third line assigns a value to the variable GetForm through a chain of commands in the Uno framework. ThisDatabaseDocument refers to the currently open database document. In our case, book.odb. FormDocuments is a collection of all the forms in the document. Finally, GetByName retrieves a specific form object from the collection. Notice, we pass the variable FormName from the signature to this method. Once the call is complete, the variable GetForm is the object of the form name passed to the subroutine. The fourth line calls the Open method of the form. On the fifth line, we tell Basic this is the end of the subroutine with the command End Sub. We will call the OpenAform subroutine twice. Once to open the authors form, and once to open the media form. Add these two subroutines to your editor: {{{ Sub OpenAuthorsForm(oEv As Object) OpenAForm("Authors") End Sub Sub OpenMediaForm(oEv As Object) OpenAForm("Media") End Sub }}} The signature on these two subroutines are a little different. Since we will call them from a control within a form, we need to pass the object making the call as an argument, even though we do not use it. The argument oEv is a reference to the object making the call. We will use this to our advantage later, in the last subroutine, but here we do it because it is required. These two subroutines are pretty simple. We just make a call to OpenAForm passing the name of the form we want to open, Authors or Media. The final subroutine deals with our problem of refreshing the data in the list boxes for authors and media when we add authors or media using the two subroutines above: {{{ Sub ListRefresh(oEv as Object) oEv.source.model.Refresh End Sub }}} Once again, since we will call this subroutine from a control, we need a reference to the control making the call. However, this time we will actually use the object. This subroutine makes a method call to the underlying model of the list box and refreshes the data in the list, thus updating our list of authors or media types. Save your module and close the Basic editor. Making Connections to Macros At this point, our macros do nothing. We need to connect them to objects in our form to activate them when needed. First, we will connect the open form subroutines to buttons in our form, and then we will connect the ListRefresh to the list boxes. In the database pane, click on Forms. Right-click the Books form and select edit. Add two push buttons to the form, one under the Authors table and another under the Media table. Right-click the button under the Authors table and select Control to bring up the buttons properties dialog. On the General tab, change the name to AddAuthors and the Label to Add Authors. On the Events tab, click the ellipses (…) button next to Execute Action – which brings up the Assign Action dialog. Click the Macro button to bring up the Macro Selector dialog. In the tree list under Library, select book.odb > Standard > FormCalls. Select OpenAuthorsForm from the Macro Name list and click OK. Click OK to close the Assign Action dialog. Close the buttons properties dialog. Do the same with the button under the Media table, only name it AddMedia, make the label Add Media Type, and assign the macro OpenMediaForm to the Execute Action event. Finally, we need to add the refresh subroutine to our list boxes. Right-click the Authors column in the authors table and select Column. On the Events tab, click the ellipse (…) button beside “When receiving focus”. In the Assign Action button, use the Macro button to assign the ListRefresh macro to the action. This will cause the list to update data from the Authors table when you click on a list box in the column. Do the same for the Media column in the media table. Save your changes to the Books form and close it. Testing Your Changes Any time we make changes to our forms, we will want to test them and make sure we got everything right, especially in cases where we have used macros. One simple typo could cause things to not work. Double-click the Books form to open it. Add a new book with an author and media type you have not added already. Click the Add Authors button to make sure it opens the form. Add some authors. Close the Authors form. Click on the authors dropdown list box and verify that the authors you added are there. Do the same test with the Add Media Type button and listbox. Final Thoughts and References Again, I would like to emphasize that writing macros in LibreOffice Basic is complex. Documentation is pretty sparse, but it is out there. If you are interested in taking up the challenge, here are some references to get you started: LibreOffice Basic Guide: http://wiki.documentfoundation.org/images/d/dd/BasicGuide_OOo3.2.0.odt Andrew Pitonyak's OpenOffice Macro Information: http://www.pitonyak.org/oo.php You can find the macros used in this How-To on pastebin.com at http://pastebin.com/MU2Ztizi Next time, we will move on to another part of the LibreOffice suite and explore the Math module. |
|
Linea 6: | Linea 73: |
Scritto da Elmer Perry Recentemente ho ricevuto una richiesta per un tutorial su Macro; così facciamo una breve pausa dal nostro lavoro e ne parliamo brevemente. Le macro vi permettono di automatizzare azioni ripetute, come la scrittura dell'intestazione. Questo vi libera dal dover digitare o ripetere ogni volta alcune azioni. In questo tutorial HOW-TO, andremo a vedere come registrare delle macro e come usarle. LibreOffice Basic ha un suo linguaggio di scripting, che va oltre lo scopo di questo tutorial; forse successivamente riprenderemo le macro per parlare del linguaggio di scripting. NOTA: Potete trovare informazioni su LibreOffice Basic nell'Aiuto, oppure potete scaricare la documentazione all'indirizzo: http://wiki.documentfoundation.org/images/d/dd/BasicGuide_OOo3.2.0.odt. Abilitare la registrazione Macro Di default la registrazione delle macro è disabilitata; a quanto pare queste sono considerate come "funzionalità in sperimentazione (instabili)". Per abilitare tale funzione, andate su Strumenti > Opzioni, selezionare Generali sotto la sezione LibreOffice e spuntate "attiva funzionalità in sperimentazione (instabili)". Ciò renderà disponibile l'opzione "Registra macro" sotto a Strumenti > Macro. Registrazione di una macro Quando siete in modalità di registrazione macro, essa terrà traccia di ogni azione che fate e di ogni cosa che scrivete, registrandola in una macro. Ricordate come abbiamo abilitato le funzionalità sperimentali per avere l'opzione "Registra macro"? Bene il motivo di questa domanda è perché a volte la registrazione macro fallisce. Non l'ho sperimentato io personalmente, ma ho pensato di doverlo dire. Per dimostrare una registrazione macro, creeremo una macro di nome "Chiusura". Ogni volta che scrivete una lettera, dovete terminarla con una frase di chiusura; quindi perché non metterla in una macro? Iniziate con un nuovo documento di testo. Per iniziare la registrazione della macro, andate su Strumenti > Macro > Registra macro. Ciò farà apparire la relativa barra degli strumenti. Qui c'è solo una opzione: Ferma registrazione. Premete il tasto Tab sulla vostra tastiera per tre o quattro volte (in questo modo il cursore dovrebbe essere pressoché al centro della pagina). Scrivete 'Tanti auguri' o 'con amore', oppure la vostra frase di chiusura preferita. Andate a capo due volte in modo da lasciare lo spazio per la firma. Premete di nuovo tante volte quanto prima il tasto Tab, cambiate il testo mettendolo in grassetto premendo l'apposito bottone nella barra della formattazione e scrivete il vostro nome. Come ultima cosa, andiamo ad aggiungere un titolo sotto il nome. Premete Invio, poi il tasto Tab lo stesso numero di volte di prima, togliete la formattazione del testo in grassetto, per poi impostare il carattere su corsivo. Scrivete il titolo, premete Invio e fate clic su 'Ferma registrazione'. Vi apparirà la finestra di dialogo Macro Basic. Selezionate la libreria in cui volete salvare la macro, solitamente in 'Mie macro'. Inserite il nome della macro nella casella di testo e poi fate clic sul pulsante Salva. Provare la macro Vorrete provare la vostra macro, per assicurarvi che tutto sia stato registrato correttamente; per fare ciò andate su Strumenti > Macro > Esegui macro. Selezionate la libreria in cui l'avete salvata, per poi selezionare la macro ed eseguirla facendo clic sul bottone Esegui. La macro verrà eseguita, scrivendo l'intero testo che avete registrato e con la stessa formattazione che avete adoperato. Se qualcosa non è andata come volevamo, potete eliminare la macro e crearne una nuova. Per eliminarla, andate su Strumenti > Macro > Organizza macro > LibreOffice Basic. Cercate la macro nella libreria, la selezionate e fate clic sul bottone Elimina. Creare una scorciatoia alla vostra macro Se usate molto spesso la macro, non volete andare su Strumenti > Macro > Esegui macro ogni volta che ne avete bisogno. LibreOffice permette di aggiungere una macro ai menu, alle barre degli strumenti, alle scorciatoie della tastiera e agli eventi di una applicazione. Potete fare tutto ciò andando su Strumenti > Personalizza. Per fare un esempio, andiamo ad aggiungere un menu di none 'Macro' in LibreOffice Writer, per poi aggiungerci la nostra macro 'Chiusura'. Andate su Strumenti > Personalizza, selezionate la scheda Menu, fate clic sul pulsate Nuovo, nominate il nuovo menu, spostatevi sul bottone prima di Aiuto con le frecce direzionali e fate clic su OK. Per adesso il vostro nuovo menu è vuoto. Fate clic sul pulsante Aggiungi, cercate Macro LibreOffice sotto la categoria, navigate lungo l'albero per ricercare la vostra macro, selezionate la macro Chiusura e fate clic sul bottone Aggiungi. Una volta che essa viene aggiunta nel menu, fate clic sul pulsante Chiudi, per poi fare clic su OK nella finestra di dialogo Personalizza. Ora avete un oggetto del menu di nome Macro e sotto di essa la macro Chiusura. Ora potete potete selezionarla quando ne avete bisogno, velocizzando il tutto. Questo è stata solo un'introduzione molto breve sulle macro. Prima di usarle, siate sicuri che non ci sia un'alternativa valida che faccia ciò che state cercando di fare; ma solitamente la macro è la soluzione migliore per compiere una stessa azione ripetutamente. C'è un linguaggio di scripting di LibreOffice Basic, di cui forse ne parleremo successivamente. Inoltre potete scaricare le macro dal web e importarle per usarle in LibreOffice. Il prossimo mese torneremo a trattare di Impress lavorando con le diapositive. <<<<<<<<<<<<<<<<<<<<<< Scheda autore >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> La storia lavorativa, di programmazione e informatica di Elmer Perry include un Apple IIE, con alcuni Amiga, un generoso aiuto di DOS e Windows e una spolverata di Unix, il tutto ben mescolato con Linux e Ubuntu. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> |
|
Linea 54: | Linea 79: |
Scritto da Elmer Perry Recentemente ho ricevuto una richiesta per un tutorial sulle macro di LibreOffice; così facciamo una breve pausa dal nostro lavoro su Impress e ne parliamo brevemente. Le macro vi permettono di automatizzare azioni ripetitive, come la scrittura dell'intestazione. Questo vi libera dal dover digitare o ripetere ogni volta alcune azioni. In questo tutorial HOW-TO, andremo a vedere come registrare delle macro e come usarle. LibreOffice ha un suo Basic, un linguaggio di scripting, che va oltre lo scopo di questo tutorial; forse successivamente riprenderemo le macro per parlare del linguaggio di scripting. NOTA: Potete trovare informazioni su LibreOffice Basic nell'Aiuto, oppure potete scaricare la documentazione all'indirizzo: http://wiki.documentfoundation.org/images/d/dd/BasicGuide_OOo3.2.0.odt. Abilitare la registrazione Macro Di default la registrazione delle macro è disabilitata; a quanto pare le macro sono considerate come una "funzionalità in sperimentazione (instabili)". Per abilitare tale funzione, andate su Strumenti > Opzioni. Selezionare Generali sotto la sezione LibreOffice e spuntate "attiva funzionalità in sperimentazione (instabili)". Ciò renderà disponibile l'opzione "Registra macro" sotto a Strumenti > Macro. Registrazione di una macro Quando siete in modalità di registrazione macro, il registratore di macro terrà traccia di ogni azione che fate e di ogni cosa che digitate, e lo registra in una macro. Ricordate come abbiamo abilitato le funzionalità sperimentali per avere l'opzione "Registra macro"? Bene il motivo di questa domanda è perché a volte la registrazione macro fallisce. Non l'ho sperimentato io personalmente, ma ho pensato di doverlo dire. Per dimostrare una registrazione macro, creeremo una macro di nome "Chiusura". Ogni volta che scrivete una lettera, dovete terminarla con una frase di chiusura; quindi perché non metterla in una macro? Iniziate con un nuovo documento di testo. Per iniziare la registrazione della macro, andate su Strumenti > Macro > Registra macro. Ciò farà apparire la relativa barra degli strumenti. Qui c'è solo una opzione: Ferma registrazione. Premete il tasto Tab sulla vostra tastiera per tre o quattro volte (in questo modo il cursore dovrebbe essere pressoché al centro della pagina). Scrivete 'Tanti auguri' o 'affettuosità', oppure la vostra frase di chiusura preferita. Andate a capo due volte in modo da lasciare lo spazio per la firma. Premete di nuovo tante volte quante prima il tasto Tab, cambiate il testo mettendolo in grassetto premendo l'apposito bottone nella barra della formattazione e scrivete il vostro nome. Come ultima cosa, andiamo ad aggiungere un titolo sotto il nome. Premete Invio, poi il tasto Tab lo stesso numero di volte di prima, togliete la formattazione del testo in grassetto, per poi impostare il carattere su corsivo. Scrivete il titolo, premete Invio e fate clic su 'Ferma registrazione'. Vi apparirà la finestra di dialogo Macro Basic. Selezionate la libreria in cui volete salvare la macro, solitamente in 'Mie macro'. Inserite il nome della macro nella casella di testo e poi fate clic sul pulsante Salva. Provare la macro Vorrete provare la vostra macro, per assicurarvi che tutto sia stato registrato correttamente; per fare ciò andate su Strumenti > Macro > Esegui macro. Selezionate la libreria in cui l'avete salvata, per poi selezionare la macro ed eseguirla facendo clic sul pulsante Esegui. La macro verrà eseguita, scrivendo l'intero testo che avete registrato e con la stessa formattazione che avete adoperato. Se qualcosa non è andata come volevamo, potete eliminare la macro e crearne una nuova. Per eliminarla, andate su Strumenti > Macro > Organizza macro > LibreOffice Basic. Cercate la macro nella libreria, la selezionate e fate clic sul pulsante Elimina. Creare una scorciatoia alla vostra macro Se usate molto spesso la macro, non volete andare su Strumenti > Macro > Esegui macro ogni volta che ne avete bisogno. LibreOffice permette di aggiungere una macro ai menu, alle barre degli strumenti, alle scorciatoie della tastiera e agli eventi di una applicazione. Potete fare tutto ciò andando su Strumenti > Personalizza. Per fare un esempio, andiamo ad aggiungere un menu di nome 'Macro' in LibreOffice Writer, per poi aggiungerci la nostra macro 'Chiusura'. Andate su Strumenti > Personalizza, selezionate la scheda Menu, fate clic sul pulsante Nuovo, nominate il nuovo menu, spostatevi sul bottone prima di Aiuto con le frecce direzionali e fate clic su OK. Per adesso il vostro nuovo menu è vuoto. Fate clic sul pulsante Aggiungi, cercate Macro LibreOffice sotto la categoria, navigate lungo l'albero per ricercare la vostra macro, selezionate la macro Chiusura e fate clic sul pulsante Aggiungi. Una volta che essa viene aggiunta nel menu, fate clic sul pulsante Chiudi, per poi fare clic su OK nella finestra di dialogo Personalizza. Ora avete un oggetto del menu di nome Macro e sotto di essa la macro Chiusura. Ora potete potete selezionarla quando ne avete bisogno, velocizzando il tutto. Questo è stata solo un'introduzione molto breve sulle macro. Prima di usarle, siate sicuri che non ci sia un'alternativa valida che faccia ciò che state cercando di fare; ma solitamente la macro è la soluzione che stavate cercando per azioni ripetitive eseguite spesso. C'è un linguaggio di scripting Basic di LibreOffice , di cui forse parleremo successivamente. Inoltre potete scaricare le macro dal web e importarle per usarle in LibreOffice. Il prossimo mese torneremo a trattare di Impress e a lavorare con le diapositive. <<<<<<<<<<<<<<<<<<<<<< Scheda autore >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> La storia lavorativa, di programmazione e informatica di Elmer Perry include un Apple IIE, con alcuni Amiga, un generoso aiuto di DOS e Windows e una spolverata di Unix, il tutto ben mescolato con Linux e Ubuntu. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> |
|
Linea 97: | Linea 81: |
io personalmente preferirei il termine pulsante rispetto a bottone |
Testo inglese
LibreOffice Part 23: Base Form Enhancements with Macros
by Elmer Perry
For the previous four parts of this series, we have slowly built a database document using LibreOffice's Base module. We have a database with forms to enter our data, and queries and reports for extracting the data. We now have a usable document for recording our book library. However, our current design has one flaw we need to overcome. If we need to enter a new author or media type while we are in the books form, we have to close the book form and open one of the others. If we could enter new authors and media types directly from the books form, it would behave more like an application and make data entry even easier. We can accomplish this through a few short macros. The LibreOffice Basic language is very similar to other Basic languages, such as Visual Basic for Applications. To manipulate the underlying LibreOffice document, we access the Uno framework controlling the document. The Uno framework is quite complex, but I will explain, as best I can, the properties and objects we will use. The goal is not to teach you how to write LibreOffice macros, but how you can use them. Macro Security and Options
While macros allow us to do cool things in our documents, they can also cause problems. Some people use macros to compromise other people's systems, therefore, we need to take a few minutes to talk about macro security. Whether you are running LibreOffice on Linux, Mac, or Windows, malicious code in a macro can compromise your data and possibly your entire system.
Macro security in LibreOffice is simple. Tools > Options opens the Options dialog for LibreOffice. Under LibreOffice, select Security. Click on the Macro Security button to pop up the macro security options. You have four options. Never use the Low security option – it will run macros without asking you. I recommend the Medium security level. With this level, you are prompted whether to run the macros when you open a document containing macros. The High and Very High options require a certificate or folder you designate as trusted. While this is great, I believe nothing trumps the instincts of the user. You usually know whether you were expecting a document to contain macros. When in doubt, click No. Click OK to save your choice and OK to close the options dialog. Now, on to the fun stuff. The Macros
We will write four macros for our database document. Three will deal with opening forms, and the last will update the list boxes for authors and media types. The general idea behind macros is to accomplish tasks that are not built into the program, or to simplify complex tasks. Our macros really accomplish both, as we will simplify the tasks of adding authors and media types and provide functionality not built into the program. Before we can begin to write our macros, we need a container to hold them. Macros are contained in a module. Modules can live in the program itself or within a document. Since our macros are specific to our database file, we will embed them in the document. Macros embedded in a document are available only when the document is loaded. Macros contained in the program are available as long as the program is running. Tools > Macros > Organize Macros > LibreOffice Basic. The LibreOffice Basic Macros dialog pops up. Select book.odb from the Macro from-list. Click the New button. A dialog pops up asking you for a name for the module. Name it FormCalls. Click OK. This brings up the LibreOffice macro editor. The macro comes with a default main subroutine. We will not use this subroutine. Highlight Sub main and End Sub and press the backspace key to delete them. Our first macro is a generalized subroutine for opening a form. A generalized subroutine is written for reuse. We will call this routine twice from other routines we write. Type this subroutine into the editor:
Sub OpenAForm (FormName as String) Dim GetForm as Object GetForm = ThisDatabaseDocument.FormDocuments.GetByName(FormName) GetForm.Open End Sub
The first line of the subroutine is called the signature. The signature determines how the subroutine is called. A signature starts with the keyword Sub, which defines this call as a subroutine. Next, the name of the subroutine. In our case, OpenAForm is the name of the subroutine. Finally in the parenthesis, we have the arguments used when calling this subroutine. In our case, we have a variable named FormName which is a type String. In the second line of the subroutine, Dim is another keyword. Dim initializes a variable as a type, and, optionally, a value. We define a variable named GetForm as a type Object. The third line assigns a value to the variable GetForm through a chain of commands in the Uno framework. ThisDatabaseDocument refers to the currently open database document. In our case, book.odb. FormDocuments is a collection of all the forms in the document. Finally, GetByName retrieves a specific form object from the collection. Notice, we pass the variable FormName from the signature to this method. Once the call is complete, the variable GetForm is the object of the form name passed to the subroutine. The fourth line calls the Open method of the form. On the fifth line, we tell Basic this is the end of the subroutine with the command End Sub. We will call the OpenAform subroutine twice. Once to open the authors form, and once to open the media form. Add these two subroutines to your editor:
Sub OpenAuthorsForm(oEv As Object) OpenAForm("Authors") End Sub Sub OpenMediaForm(oEv As Object) OpenAForm("Media") End Sub
The signature on these two subroutines are a little different. Since we will call them from a control within a form, we need to pass the object making the call as an argument, even though we do not use it. The argument oEv is a reference to the object making the call. We will use this to our advantage later, in the last subroutine, but here we do it because it is required. These two subroutines are pretty simple. We just make a call to OpenAForm passing the name of the form we want to open, Authors or Media. The final subroutine deals with our problem of refreshing the data in the list boxes for authors and media when we add authors or media using the two subroutines above:
Sub ListRefresh(oEv as Object) oEv.source.model.Refresh End Sub
Once again, since we will call this subroutine from a control, we need a reference to the control making the call. However, this time we will actually use the object. This subroutine makes a method call to the underlying model of the list box and refreshes the data in the list, thus updating our list of authors or media types. Save your module and close the Basic editor.
Making Connections to Macros
At this point, our macros do nothing. We need to connect them to objects in our form to activate them when needed. First, we will connect the open form subroutines to buttons in our form, and then we will connect the ListRefresh to the list boxes. In the database pane, click on Forms. Right-click the Books form and select edit. Add two push buttons to the form, one under the Authors table and another under the Media table. Right-click the button under the Authors table and select Control to bring up the buttons properties dialog. On the General tab, change the name to AddAuthors and the Label to Add Authors. On the Events tab, click the ellipses (…) button next to Execute Action – which brings up the Assign Action dialog. Click the Macro button to bring up the Macro Selector dialog. In the tree list under Library, select book.odb > Standard > FormCalls. Select OpenAuthorsForm from the Macro Name list and click OK. Click OK to close the Assign Action dialog. Close the buttons properties dialog. Do the same with the button under the Media table, only name it AddMedia, make the label Add Media Type, and assign the macro OpenMediaForm to the Execute Action event. Finally, we need to add the refresh subroutine to our list boxes. Right-click the Authors column in the authors table and select Column. On the Events tab, click the ellipse (…) button beside “When receiving focus”. In the Assign Action button, use the Macro button to assign the ListRefresh macro to the action. This will cause the list to update data from the Authors table when you click on a list box in the column. Do the same for the Media column in the media table. Save your changes to the Books form and close it.
Testing Your Changes
Any time we make changes to our forms, we will want to test them and make sure we got everything right, especially in cases where we have used macros. One simple typo could cause things to not work. Double-click the Books form to open it. Add a new book with an author and media type you have not added already. Click the Add Authors button to make sure it opens the form. Add some authors. Close the Authors form. Click on the authors dropdown list box and verify that the authors you added are there. Do the same test with the Add Media Type button and listbox. Final Thoughts and References
Again, I would like to emphasize that writing macros in LibreOffice Basic is complex. Documentation is pretty sparse, but it is out there. If you are interested in taking up the challenge, here are some references to get you started: LibreOffice Basic Guide: http://wiki.documentfoundation.org/images/d/dd/BasicGuide_OOo3.2.0.odt Andrew Pitonyak's OpenOffice Macro Information: http://www.pitonyak.org/oo.php You can find the macros used in this How-To on pastebin.com at http://pastebin.com/MU2Ztizi Next time, we will move on to another part of the LibreOffice suite and explore the Math module.
Traduzione italiana
Note alla traduzione
Revisione
Note alla revisione