Std DlgMacroRecord: Difference between revisions

From FreeCAD Documentation
No edit summary
(Usage)
 
(57 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
<translate>
<translate>
{{GuiCommand|Name=Std_DlgMacroRecord|MenuLocation=[[Macros|Macro]] → Registra macro ...|Workbenches=All|SeeAlso=[[Std_DlgMacroExecuteDirect|Execute macro]]}}


<!--T:17-->
=== Descrizione ===
{{Docnav
|
|[[Std_DlgMacroExecute|DlgMacroExecute]]
|[[Std_Macro_Menu|Std Macro Menu]]
|
|IconR=Std_DlgMacroExecute.svg
|IconC=Freecad.svg
}}


<!--T:1-->
Questa funzione registra una macro.
{{GuiCommand
|Name=Std DlgMacroRecord
|MenuLocation=Macro → Macro recording...
|Workbenches=All
|SeeAlso=[[Std_MacroStopRecord|Std MacroStopRecord]]
}}


==Description== <!--T:2-->
La funzione è accessibile tramite '''Macro → Registra macro ...''', oppure tramite il pulsante {{KEY/it|[[File:Std DlgMacroRecord.png|16px]] Registra macro}} della barra degli strumenti delle macro [[File:Macros_toolbar.jpg|96px]].


<!--T:3-->
=== Utilizzo ===
The '''Std DlgMacroRecord''' command starts a [[Macros|macro]] recording session during which user actions are stored in a FreeCAD macro, a file with the {{FileName|.FCMacro}} extension. A macro can later be replayed, executed, to repeat the recorded actions.


</translate>
Avviare la funzione con uno dei modi indicati prima. Appare la seguente finestra:
[[Image:Std_DlgMacroRecord_dialog.png]]
{|
<translate>
| [[Image:Menu_Std_DlgMacroRecord_it.png‎|Registrazione macro]]
<!--T:18-->
|
{{Caption|The Macro recording dialog box}}
* '''Nome della macro''' : Inserire il nome della nuova macro.
* '''Percorso della macro''' : Posizione della libreria delle macro. Per modificare il percorso, cliccare su {{KEY/it| ... }}.
* {{KEY/it|Registra}} : Registrare la macro. Avvia la registrazione di tutto quello che viene fatto in seguito.<br />Il pulsante {{KEY/it|[[File:Std_DlgMacroStop.png|16px]] Interrompi la registrazione della macro}} della barra degli strumenti delle macro [[File:Macros_toolbar.jpg|96px]] assume il colore verde [[File:Std_DlgMacroStop_02.png|16px]].
* {{KEY/it|Ferma}} : Arrestare la registrazione della macro.
* {{KEY/it|Annulla}} : Annulla la funzione e chiude la finestra.
|}


==Usage== <!--T:5-->


<!--T:4-->
A lavoro ultimato cliccare su {{KEY/it|[[File:Std_DlgMacroStop_02.png|16px]] [[Std DlgMacroStop/it|Interrompi la registrazione della macro]]}} per interrompere la registrazione della macro.
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Std_DlgMacroRecord.svg|16px]] [[Std_DlgMacroRecord|Std DlgMacroRecord]]}} button.
#* Select the {{MenuCommand|Macro → [[Image:Std_DlgMacroRecord.svg|16px]] Macro recording...}} option from the menu.
# The Macro recording dialog box opens.
# Enter a name for the macro in the '''Macro name''' input box.
# Optionally change the '''Macro path''' by pressing the {{Button|...}} button.
# The {{Button|Stop}} button does not work at this time.
# Press the {{Button|Record}} button to close the dialog box and start the recording session.
# The button image of the command changes to {{Button|[[Image:Std_MacroStopRecord.svg|16px]]}} and the menu text changes to {{MenuCommand|Stop macro recording}}.
# Perform the actions you want to record.
# To end the recording session do one of the following:
#* Press the {{Button|[[Image:Std_MacroStopRecord.svg|16px]] [[Std_DlgMacroRecord|Std DlgMacroRecord]]}} button.
#* Select the {{MenuCommand|Macro → [[Image:Std_MacroStopRecord.svg|16px]] Stop macro recording}} option from the menu.


==Options== <!--T:19-->
La macro può essere recuperata tramite '''Macro → Macro ...''', oppure tramite il pulsante {{KEY/it|[[File:Std_DlgMacroExecuteDirect.png|16px]] [[Std_DlgMacroExecuteDirect/it|Esegui macro registrata]]}} della barra degli strumenti delle macro per essere eseguita o modificata a piacere.

<!--T:20-->
* When the Macro recording dialog box is displayed: press {{KEY|Esc}} or the {{Button|Close}} button to abort the command.

==Notes== <!--T:21-->

<!--T:22-->
* To execute the recorded macro use the [[Std_DlgMacroExecute|Std DlgMacroExecute]] command.
* To learn more about macros see the [[Macros]] page.

==Preferences== <!--T:23-->

<!--T:24-->
* The macro path can also be changed in the preferences: {{MenuCommand|Edit → Preferences... → Python → Macro → Macro path}}. See [[Preferences_Editor#Macro|Preferences Editor]].
* In most cases it is undesirable to record actions that do not change the model: under {{MenuCommand|Edit → Preferences... → Python → Macro → GUI commands}} do one of the following:
** To exclude these actions uncheck the {{CheckBox|FALSE|Record GUI commands}} checkbox.
** To include them as comments only check both the {{CheckBox|TRUE|Record GUI commands}} and {{CheckBox|TRUE|Record as comment}} checkboxes.


<!--T:25-->
{{Docnav
|
|[[Std_DlgMacroExecute|DlgMacroExecute]]
|[[Std_Macro_Menu|Std Macro Menu]]
|
|IconR=Std_DlgMacroExecute.svg
|IconC=Freecad.svg
}}


</translate>
</translate>
{{Std Base navi{{#translation:}}}}
{{clear}}
{{Userdocnavi{{#translation:}}}}
<languages/>

Latest revision as of 08:11, 10 October 2023

Std DlgMacroRecord

Menu location
Macro → Macro recording...
Workbenches
All
Default shortcut
None
Introduced in version
-
See also
Std MacroStopRecord

Description

The Std DlgMacroRecord command starts a macro recording session during which user actions are stored in a FreeCAD macro, a file with the .FCMacro extension. A macro can later be replayed, executed, to repeat the recorded actions.

The Macro recording dialog box

Usage

  1. There are several ways to invoke the command:
    • Press the Std DlgMacroRecord button.
    • Select the Macro → Macro recording... option from the menu.
  2. The Macro recording dialog box opens.
  3. Enter a name for the macro in the Macro name input box.
  4. Optionally change the Macro path by pressing the ... button.
  5. The Stop button does not work at this time.
  6. Press the Record button to close the dialog box and start the recording session.
  7. The button image of the command changes to and the menu text changes to Stop macro recording.
  8. Perform the actions you want to record.
  9. To end the recording session do one of the following:
    • Press the Std DlgMacroRecord button.
    • Select the Macro → Stop macro recording option from the menu.

Options

  • When the Macro recording dialog box is displayed: press Esc or the Close button to abort the command.

Notes

Preferences

  • The macro path can also be changed in the preferences: Edit → Preferences... → Python → Macro → Macro path. See Preferences Editor.
  • In most cases it is undesirable to record actions that do not change the model: under Edit → Preferences... → Python → Macro → GUI commands do one of the following:
    • To exclude these actions uncheck the Record GUI commands checkbox.
    • To include them as comments only check both the Record GUI commands and Record as comment checkboxes.