/text/sbasic/shared/01040000.xhp Sun Microsystems, Inc. converted from old format - fpe dedr: fixed #i30797#

deleting; macro assignments to events macros; assigning assigning macros events; assigning macros Event-Driven Macros This section describes how to assign Basic programs to program events.

You can automatically execute a macro when a specified software event occurs by assigning the desired macro to the event. The following table provides an overview of program events and at what point an assigned macro is executed. Event An assigned macro is executed... Program Start ... after a $[officename] application is started. Program End ...before a $[officename] application is terminated. Create Document ...after a new document is created with File - New or with the New icon. Open Document ...after a document is opened with File - Open or with the Open icon. Save Document As ...before a document is saved under a specified name (with File - Save As, or with File - Save or the Save icon, if a document name has not yet been specified). Document has been saved as ... after a document was saved under a specified name (with File - Save As, or with File - Save or with the Save icon, if a document name has not yet been specified). Save Document ...before a document is saved with File - Save or the Save icon, provided that a document name has already been specified. Document has been saved ...after a document is saved with File - Save or the Save icon, provided that a document name has already been specified. Close Document ...before a document is closed. Document is being closed ...after a document was closed. Note that the "Save Document" event may also occur when the document is saved before closing. Activate Document ...after a document is brought to the foreground. Deactivate Document ...after another document is brought to the foreground. Print Document ...after the Print dialog is closed, but before the actual print process begins. JavaScript run-time error ...when a JavaScript run-time error occurs. Print Mail Merge ...after the Print dialog is closed, but before the actual print process begins. This event occurs for each copy printed. Change of the page count ...when the page count changes. Message received ...if a message was received. Assigning a Macro to an Event Choose Tools - Customize and click the Events tab. Select whether you want the assignment to be globally valid or just valid in the current document by selecting the $[officename] or Document option. Select the event from the Event list. Select the module containing the macro to be assigned to the selected event from the Macros list. The list contains a hierarchical list of modules, libraries, files, and templates. Select the macro to be assigned from the right list. Click Assign. Click OK to close the dialog. Removing the Assignment of a Macro to an Event Choose Tools - Customize and click the Events tab. Select whether you want to remove a gobal assignment or an assignment that is just valid in the current document by selecting the StarOffice or Document option. Select the event that contains the assignment to be removed from the Event list. Click Remove. Click OK to close the dialog.