Difference between revisions of "IT/Documentation/OOo3 User Guides/Getting Started/How to run a macro"

Revision as of 11:30, 20 September 2010

Pagina in traduzione - Translation in progress

Un modo tipico per eseguire una macro è il seguente:

1. Fate clic su Strumenti > Macro > Esegui Macro per aprire la finestra di dialogo Selettore macro (vedere sotto).
2. Selezionate la libreria e il modulo nella lista delle librerie sulla sinistra.
3. Selezionate la macro in Nome macro, sulla destra.
4. Fate clic su Esegui per eseguire la macro.

Utilizzo della finestra di dialogo Selettore macro per eseguire le macro.

Sebbene possiate utilizzare Strumenti > Macro > Esegui macro per eseguire tutte le macro, questo non è il metodo più efficiente nel caso di un loro utilizzo frequente. Una tecnica comunemente utilizzata consiste nell'assegnare a una macro un pulsante di una barra strumenti, una voce di menu, una scorciatoia da tastiera, oppure un pulsante incluso all'interno del documento. Per selezionare un metodo è utile porsi domande come le seguenti:

• La macro deve essere disponibile soltanto per un documento o per tutti i documenti?
• La macro è pertinente solo ad un determinato tipo di documento, come i fogli di lavoro Calc?
• Con quale frequenza verrà utilizzata la macro?

Le risposte a queste domande indicheranno dove memorizzare la macro e come renderla disponibile. Per esempio, probabilmente non vorrete inserire una macro utilizzata raramente in una barra degli strumenti. Per aiutarvi nelle vostre scelte, analizzate la Tabella 2.

Tabella 2. Metodi per eseguire una macro.

Per aggiungere una voce di menu, una scorciatoia da tastiera o un pulsante nella barra degli strumenti che richiami una macro, utilizzate la finestra di dialogo Personalizza. Potete aprire questa finestra in ciascuno di questi modi:

• Fate clic su Strumenti > Personalizza nella barra dei menu principale.
• ogni barra ha un'icona che apre un menu; scegliete l'opzione Modifica.

Finestra di dialogo Personalizza di OpenOffice.org.

Template:Documentation/Tip

La finestra di dialogo Personalizza contiene schede per configurare i menu, le scorciatoie da tastiera, le barre degli strumenti e gli eventi.

Barra degli strumenti Si possono aggiungere le macro alle barre degli strumenti. Per saperne di più sulla modifica delle barre degli strumenti, fate riferimento al Capitolo 14 (Personalizzazione di OpenOffice.org).

Voci di menu Fate clic su Strumenti > Personalizza per aprire la finestra di dialogo Personalizza, e selezionate la scheda Menu. Potete modificare i menu esistenti, oppure creare nuovi menu che richiamano delle macro. Per ulteriori informazioni sulla modifica dei menu, fate riferimento al Capitolo 14 (Personalizzazione di OpenOffice.org).

Scorciatoie da tastiera

Andate su Strumenti > Personalizza per aprire la finestra di dialogo Personalizza, e selezionate la scheda Tastiera. L'assegnazione delle scorciatoie da tastiera viene trattata nel Capitolo 14.

Eventi

In OpenOffice.org, quando accade qualcosa, si dice che si è verificato un evento. Per esempio, quando si apre un documento, quando si preme un tasto o quando si muove il puntatore del mouse. OpenOffice.org permette agli eventi di invocare delle macro; la macro viene in questo caso chiamata gestore dell'evento. La trattazione completa della gestione degli eventi va molto al di là degli scopi di questo documento, ma l'argomento può essere introdotto.

Fate clic su Strumenti > Personalizza per aprire la finestra di dialogo Personalizza, e dopo fate clic sulla scheda Eventi (vedere Figura 3). Gli eventi elencati nella finestra di dialogo Personalizza fanno riferimento sia all'intera applicazione, sia al documento specifico. Utilizzate l'elenco a discesa Salva in per scegliere OpeOffice.org, oppure un documento specifico.

Un metodo comunemente utilizzato consiste nell'assegnare all'evento di Apri documento l'esecuzione di una specifica macro. La macro può quindi eseguire certe impostazioni specifiche per il documento. Selezionate l'evento desiderato e fate clic sul pulsante Macro per aprire la finestra di dialogo Selettore Macro (vedere Figura 4).

Selezionate la macro desiderata e fate clic sul pulsante OK per assegnare la macro all'evento. La scheda eventi mostra che l'evento è stato assegnato ad una macro (vedere Figura 5). Quando verrà aperto il documento, si avvierà la macro PrintHello.

Si possono impostare molti oggetti di un documento per richiamare delle macro quando avvengono gli eventi. L'utilizzo più comune consiste nell'aggiungere un controllo, come un pulsante, all'interno di un documento. Persino effettuare un doppio clic su un grafico permette di aprire una finestra di dialogo con la scheda Macro che vi permette di assegnare una macro a un evento.

Keyboard shortcuts

Use Tools > Customize to open the Customize dialog, and select the Keyboard tab. Assigning keyboard shortcuts is discussed in Chapter 14.

Event

In OpenOffice.org, when something happens, we say that an event occurred. For example, a document was opened, a key was pressed, or the mouse moved. OpenOffice.org allows events to cause a macro to be called; the macro is then called an event handler. Full coverage of event handlers is well beyond the scope of this document, but a little knowledge can accomplish much.

Be careful when you configure an event handler. For example, assume that you write an event handler that is called every time that a key is pressed, but you make a mistake so the event is not properly handled. One possible result is that your event handler will consume all key presses, forcing you to forcibly terminate OpenOffice.org.

Use Tools > Customize to open the Customize dialog, and select the Events tab. The events in the Customize dialog are related to the entire application and specific documents. Use the Save In box to choose OpenOffice.org, or a specific document.

Assign macro to an application level event.

A common use is to assign the Open Document event to call a specific macro. The macro then performs certain setup tasks for the document. Select the desired event and click the Macro button to open the Macro Selector dialog.

Assign macro to the document open event.

Select the desired macro and click OK to assign the macro to the event. The Events tab shows that the event has been assigned to a macro. When the document opens, the PrintHello macro is run.

Print Hello is assigned to the Open Document event.

Many objects in a document can be set to call macros when events occur. The most common usage is to add a control, such as a button, into a document. Even double-clicking on a graphic opens a dialog with a Macros tab that allows you to assign a macro to an event.