Contenido

# Document Event-Driven Macros

Esta sección describe el procedimiento para asignar secuencias de órdenes a eventos de la aplicación, del documento o de un formulario.

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 document events and at what point an assigned macro is executed.

Evento | Una macro asignada se ejecuta… | rutina
--- | --- | ---
Iniciar aplicación | ...after a LibreOffice application is started. | OnStartApp
Cerrar la aplicación | … antes de que termine una aplicación de LibreOffice. | OnCloseApp
Documento creado | ...New document created with File - New or with the New icon. Note that this event also fires when Basic IDE opens. | OnCreate
Documento nuevo | … después de crear un documento nuevo con Archivo ▸ Nuevo o con el icono Nuevo. | OnNew
La carga del documento ha finalizado | ...before a document is opened with File - Open or with the Open icon. | OnLoadFinished
Abrir documento | … después de abrir un documento con Archivo ▸ Abrir o con el icono Abrir. | OnLoad
Se cerrará el documento | … antes de cerrar un documento. | OnPrepareUnload
Documento cerrado | … después de cerrar un documento. Tenga en cuenta que el evento «Guardar documento» también puede activarse si el documento se guarda antes de cerrarlo. | OnUnload
- sin interfaz de usuario - |  | OnLayoutFinished
Vista creada | Document is displayed. Note that this event also happens when a document is duplicated. | OnViewCreated
La vista se cerrará | Document layout is getting removed. | OnPrepareViewClosing
Vista cerrada | Document layout is cleared prior to the document closure. | OnViewClosed
Activar documento | … después de que un documento se traiga al primer plano. | OnFocus
Desactivar documento | … después de que otro documento se traiga al primer plano. | OnUnfocus
Guardar documento | … antes de guardar un documento con Archivo ▸ Guardar o el icono Guardar, siempre que se haya especificado antes un nombre para el documento. | OnSaveAs
El documento se guardó | … después de guardar un documento con Archivo ▸ Guardar o el icono Guardar, siempre que se haya especificado antes un nombre para el documento. | OnSaveDone
Falló el guardado del documento | No se ha podido guardar el documento. | OnSaveFailed
Guardar documento como | … antes de guardar un documento con un nombre específico (con Archivo ▸ Guardar como, Archivo ▸ Guardar o el icono Guardar, si no se ha especificado todavía un nombre de documento). | OnSaveAs
El documento se guardó como | … después de guardar un documento con un nombre específico (con Archivo ▸ Guardar como, Archivo ▸ Guardar o el icono Guardar, si no se ha especificado todavía un nombre de documento). | OnSaveAsDone
'Save As' has failed | No se ha podido guardar el documento. | OnSaveAsFailed
- sin interfaz de usuario - | Cuando la ubicación del documento en disco ha cambiado, por ejemplo, después de una acción Archivo ▸ Guardar como. | OnStorageChanged
Al almacenar o exportar una copia del documento | ...before a document is saved with File - Save a Copy, File - Export, File - Export as PDF or the Save icons. | OnCopyTo
Se creó una copia del documento | ...after a document is saved with File - Save a Copy, File - Export, File - Export as PDF or the Save icons. | OnCopyToDone
Falló la creación de una copia del documento | No se ha podido copiar ni exportar el documento. | OnCopyToFailed
Imprimir documento | ...after the Print dialog is closed, but before the actual print process begins. This event occurs for each copy printed. | OnPrint
- sin interfaz de usuario - | ...after document security settings have changed. | OnModeChanged
Se ha cambiado el estado «modificado» | Modified state of a document has changed. | OnModifyChanged
Título del documento cambiado | Cuando se actualiza el título del documento. | OnTitleChanged
Se cargó un subcomponente | ...after a database form has been opened. | OnSubComponentOpened
Se cerró un subcomponente | ...after a database form has been closed. | OnSubComponentClosed
Inició la impresión de las cartas modelo | ...before printing form letters using File - Print or Tools - Mail Merge Wizard menus. | OnMailMerge
Finalizó la impresión de las cartas modelo | ...after printing of form letters using File - Print or Tools - Mail Merge Wizard menus. | OnMailMergeFinished
Printing of form fields started | ...before printing form fields. | OnFieldMerge
Printing of form fields finished | ...after printing form fields. | OnFieldMergeFinished
Cambio del recuento de páginas | When the page count changes. | OnPageCountChanged

Most events relate to documents, except OnStartApp, OnCloseApp, OnCreate and OnLoadFinished that occur at application level. OnSubComponentOpened, and OnSubComponentClosed events are fired by database's forms.

Writer documents are triggering those specific events: OnLayoutFinished, OnMailMerge, OnMailMergeFinished, OnFieldMerge, OnFieldMergeFinished and OnPageCountChanged.

## Asignación de una macro a un evento

1. Vaya a Herramientas ▸ Personalizar y pulse en la pestaña Eventos.

2. Seleccione si desea que la asignación sea válida globalmente o solo en el documento actual seleccionando la opción correspondiente en el cuadro Guardar en.

3. Seleccione la acción de la lista Evento.

4. Pulse en Macros y seleccione la macro que se asignará al evento elegido.

5. Pulse en Aceptar para asignar la macro.

6. Pulse en Aceptar para cerrar el cuadro de diálogo.

## Supresión de la asignación de una macro a un evento

1. Vaya a Herramientas ▸ Personalizar y pulse en la pestaña Eventos.

2. Elija si quiere quitar una asignación global o una que solo es válida en el documento actual seleccionando la opción correspondiente en el cuadro de lista Guardar en.

3. Seleccione el evento que contiene la asignación que desee suprimir de la lista de Eventos.

4. Pulse en Quitar.

5. Pulse en Aceptar para cerrar el cuadro de diálogo.

Temas relacionados

In addition to assigning macros to events, one can monitor events triggered in LibreOffice documents.