Document event-driven macro's
Hier wordt beschreven hoe scripts kunnen worden toegekend aan applicatie, document of schermgebeurtenis.
U kunt automatisch een macro laten uitvoeren wanneer een bepaalde gebeurtenis optreedt door die macro te koppelen aan de gebeurtenis. In de volgende tabel staan de documentgebeurtenissen en staat aangegeven wanneer de gekoppelde macro wordt uitgevoerd.
Gebeurtenis |
Er wordt een toegewezen macro uitgevoerd... |
routine |
|---|---|---|
Toepassing starten |
...nadat een LibreOffice-applicatie is gestart. |
OnStartApp |
Toepassing sluiten |
...voordat een LibreOffice-toepassing beƫindigd wordt. |
OnCloseApp |
Document gemaakt |
...Nieuw document gemaakt met Bestand - Nieuw of met het pictogram Nieuw. Merk op dat deze gebeurtenis ook plaatsvindt als BASIC IDE opent. |
OnCreate |
Nieuw document |
...nadat er een nieuw document is gemaakt via Bestand - Nieuw of via het pictogram Nieuw. |
OnNew |
Document laden is klaar |
...voordat een document is geopend met Bestand - Openen of met het pictogram Openen. |
OnLoadFinished |
Document openen |
...nadat een document geopend is via Bestand - Openen of via het pictogram Openen. |
OnLoad |
Document wordt gesloten |
...voordat een document gesloten wordt. |
OnPrepareUnload |
Document gesloten |
...nadat een document gesloten is. De gebeurtenis Document opslaan kan zich ook voordoen wanneer een document wordt opgeslagen voordat het wordt gesloten. |
OnUnload |
-geen UI- |
OnLayoutFinished |
|
Weergave gemaakt |
Document wordt weergegeven. Merk op dat deze gebeurtenis ook plaatsvindt wanneer een document wordt gedupliceerd. |
OnViewCreated |
Weergave wordt gesloten |
De lay-out van het document wordt verwijderd. |
OnPrepareViewClosing |
Weergave gesloten |
De documentlay-out wordt gewist voordat het document wordt gesloten. |
OnViewClosed |
Document activeren |
...nadat een document naar de voorgrond gebracht is. |
OnFocus |
Document deactiveren |
...nadat een ander document naar de voorgrond gebracht is. |
OnUnfocus |
Document opslaan |
...voordat een document wordt opgeslagen via Bestand - Opslaan of het pictogram Opslaan, mits er al een documentnaam is gespecificeerd. |
OnSaveAs |
Document is opgeslagen |
...nadat een document is opgeslagen via Bestand - Opslaan of het pictogram Opslaan, mits er al een documentnaam is gespecificeerd. |
OnSaveDone |
Opslaan van document is mislukt |
Document kon niet worden opgeslagen. |
OnSaveFailed |
Document opslaan als |
...voordat een document onder een gespecificeerde naam wordt opgeslagen (via Bestand - Opslaan als of Bestand - Opslaan of via het pictogram Opslaan, als er nog geen documentnaam gespecificeerd is). |
OnSaveAs |
Document is opgeslagen als |
... nadat een document onder een gespecificeerde naam is opgeslagen (via Bestand - Opslaan als of Bestand - Opslaan of via het pictogram Opslaan, als er nog geen documentnaam gespecificeerd is). |
OnSaveAsDone |
'Opslaan als' is mislukt |
Document kon niet worden opgeslagen. |
OnSaveAsFailed |
-geen UI- |
Wanneer de locatie van een document is gewijzigd, bijvoorbeeld na Bestand - Opslaan als. |
OnStorageChanged |
Kopie van document opslaan of exporteren |
...voordat een document is opgeslagen met , , of het pictogram . |
OnCopyTo |
De kopie van het document is gemaakt |
...nadat een document is opgeslagen met , , of met het pictogram . |
OnCopyToDone |
Maken van documentkopie is mislukt |
Document kon niet worden gekopieerd of geƫxporteerd. |
OnCopyToFailed |
Document afdrukken |
...nadat het dialoogvenster Afdrukken is gesloten, maar voordat het eigenlijke afdrukproces begint. Deze gebeurtenis treedt op voor elk afgedrukt exemplaar. |
OnPrint |
-geen UI- |
... nadat de documentbeveiligingsinstellingen zijn gewijzigd. |
OnModeChanged |
De status 'Gewijzigd' is gewijzigd |
De wijzigingsstatus van een document is gewijzigd. |
OnModifyChanged |
Documenttitel gewijzigd |
Wanneer de documenttitel wordt bijgewerkt. |
OnTitleChanged |
Een subcomponent geladen |
...nadat een databaseformulier is geopend. |
OnSubComponentOpened |
Een subcomponent gesloten |
...nadat een databaseformulier is gesloten. |
OnSubComponentClosed |
Het afdrukken van standaardbrieven begonnen |
...voordat u standaardbrieven afdrukt met de menu's Bestand - Afdrukken of Extra - Assistent standaardbrief. |
OnMailMerge |
Afdrukken van standaardbrieven voltooid |
...na het afdrukken van standaardbrieven met de menu's Bestand - Afdrukken of Extra - Assistent standaardbrief. |
OnMailMergeFinished |
Het afdrukken van formuliervelden is gestart |
...voordat u formuliervelden afdrukt. |
OnFieldMerge |
Het afdrukken van formuliervelden is voltooid |
...na het afdrukken van formuliervelden. |
OnFieldMergeFinished |
Wijziging van het aantal pagina's |
Wanneer het aantal pagina's verandert. |
OnPageCountChanged |
De meeste gebeurtenissen hebben betrekking op documenten, behalve OnStartApp, OnCloseApp, OnCreate en OnLoadFinished die plaatsvinden op applicatieniveau. De gebeurtenissen OnSubComponentOpened en OnSubComponentClosed worden geactiveerd door de formulieren van de database.
Writer-documenten triggeren die specifieke gebeurtenissen: OnLayoutFinished, OnMailMerge, OnMailMergeFinished, OnFieldMerge, OnFieldMergeFinished en OnPageCountChanged.
Een macro aan een gebeurtenis toewijzen
Kies Extra - Aanpassen en klik op de tab Gebeurtenissen.
Selecteer, in de keuzelijst Opslaan in, of u de toewijzing globaal geldig wilt laten zijn of alleen geldig voor het huidige document.
Selecteer de gebeurtenis in de lijst Gebeurtenis.
Klik op Macro en selecteer de macro die moet worden toegewezen aan de geselecteerde gebeurtenis.
Klik op OK om de macro toe te wijzen.
Klik op OK om het dialoogvenster te sluiten.
De toewijzing van een macro aan een gebeurtenis opheffen
Kies Extra - Aanpassen en klik op de tab Gebeurtenissen.
Selecteer of u een globale toewijzing of een slechts in het huidige document geldige toewijzing wilt verwijderen door de optie te selecteren in de keuzelijst Opslaan in.
Selecteer de gebeurtenis die de toewijzing bevat die uit de lijst Gebeurtenis verwijderd moet worden.
Klik op Verwijderen.
Klik op OK om het dialoogvenster te sluiten.