Std DlgMacroRecord/ru: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(17 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{UnfinishedDocu{{#translation:}}}} <!-- Needs English UI image -->
<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
{{GuiCommand/ru
{{Docnav/ru
|
|Name=Std DlgMacroRecord
|[[Std_MacroStopRecord/ru|Команда "Остановить запись макроса"]]
|Name/ru=Std DlgMacroRecord
|[[Std_Macro_Menu/ru|Меню "Макросы"]]
|MenuLocation=[[Macros/ru|Макрос]] → Запись макроса ...
|
|Workbenches=All
|IconR=Std_MacroStopRecord.svg
|SeeAlso=[[Std_DlgMacroExecuteDirect/ru|Выполнить макрос]]
|IconC=Freecad.svg
}}
}}
</div>
</div>


{{GuiCommand/ru
== Description ==
|Name=Std_MacroStopRecord
|Name/ru=Запись макроса...
|MenuLocation=Макросы → Запись макроса...
|Workbenches=Все
|SeeAlso=[[Std_MacroStopRecord/ru|Остановить запись макроса]]
}}


<span id="Description"></span>
The [[Image:Std_DlgMacroRecord.svg|16px]] Start Macro recording function initiates a recording session of a [[macros|macro]]. This means it will record all operation the user makes in the [[3D view]]. Once the user is finished with the sequence of action, the [[File:Std MacroStopRecord.svg|16px]] [[Std MacroStopRecord|Stop Macro Recording]] functions ends the macro recording session. This is a powerful technique to record repetitive sequences of actions (in to [[Python]] code that can be saved in a FreeCAD Macro file ({{incode|.FCMacro}})), that can be executed at a later time or even transferred to another computer running FreeCAD.
==Описание==


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.
== Usage ==


[[Image:Std_DlgMacroRecord_dialog.png]]
#The Macro Record function is accessible via several ways:
{{Caption|The Macro recording dialog box}}
#* The {{Button|[[Image:Std_DlgMacroRecord.svg|16px]] Macro recording}} button in the macro toolbar [[File:Macros_toolbar.jpg|96px]]
#* The menu {{MenuCommand|{{StdMenu|[[Std Macro Menu|Macro]]}} → Macro recording}},
# '''Result:''' A dialog box will appear querying the user for the following information
#: [[Image:Menu_Std_DlgMacroRecord_it.png‎|Macro recording]]
#::* '''Macro name''': Enter the name of the new macro.
#::* '''Macro path''': Path macro library. To change the path, click {{Button| ... }}.
#::* {{KEY|Record}}: Record the macro (starts recording all actions in the [[3D view]]).
#:::'''Note:''' The button {{Button|[[File:Std MacroStopRecord.svg|16px]] Stop macro recording session}} in the macros toolbar [[File:Macros_toolbar.jpg|96px]] will turn green [[File:Std MacroStopRecord.svg|16px]].
#::* {{Button|Stop}}: Stop recording the macro.
#::* {{Button|Cancel}}: Cancels and closes the window.
# Once completed, click {{KEY|[[File:Std MacroStopRecord.svg|16px]] [[Std MacroStopRecord|Stop the macro recording session]]}} to stop recording the macro.


<span id="Usage"></span>
=== Executing the Macro===
==Применение==


# There are several ways to invoke the command:
# The macro can be executed several ways:
#* Press the {{Button|[[Image:Std_DlgMacroRecord.svg|16px]] [[Std_DlgMacroRecord|Std DlgMacroRecord]]}} button.
#* Through the {{MenuCommand|Macro → Macros...}} menu
#* Pressing the {{Button|[[File:Std_DlgMacroExecuteDirect.svg|16px]] [[Std_DlgMacroExecuteDirect|Execute this macro]]}} button in the macro toolbar
#* Select the {{MenuCommand|Macro → [[Image:Std_DlgMacroRecord.svg|16px]] Macro recording...}} option from the menu.
# The Macro recording dialog box opens.
# Choose the macro
# Enter a name for the macro in the '''Macro name''' input box.
# Press {{Button|OK}}
# 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.


<span id="Options"></span>
==Example==
==Опции==


<div class="mw-translate-fuzzy">
# Press the [File:Std DlgMacroRecord.svg|16px]] button
* При отображении диалогового окна записи макросов: нажмите {{KEY|Esc}} или кнопку {{Button|Отмена}}, чтобы прервать выполнение команды.
# Enter a name for the macro and press {{Button|OK}}
</div>
# Open a document
# Create an [[Image:Part_Box.svg|24px]] [[Part Box|Cube]]
# Change the color of the box
# Press on [[File:Std MacroStopRecord.svg|16px]] to stop the macro recording


<span id="Notes"></span>
Result: The macro is available in your macros directory. [[#Executing the Macro|Execute]] the macro to recreate the steps you just recorded.
==Примечания==


* To execute the recorded macro use the [[Std_DlgMacroExecute|Std DlgMacroExecute]] command.
{{Std Base navi}}
* To learn more about macros see the [[Macros]] page.

<span id="Preferences"></span>
==Настройки==

* 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.


<div class="mw-translate-fuzzy">
{{Docnav/ru
|
|[[Std_MacroStopRecord/ru|Команда "Остановить запись макроса"]]
|[[Std_Macro_Menu/ru|Меню "Макросы"]]
|
|IconR=Std_MacroStopRecord.svg
|IconC=Freecad.svg
}}
</div>


{{Std Base navi{{#translation:}}}}
{{Userdocnavi}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 08:18, 10 October 2023

Other languages:

Запись макроса...

Системное название
Std_MacroStopRecord
Расположение в меню
Макросы → Запись макроса...
Верстаки
Все
Быстрые клавиши
Нет
Представлено в версии
-
См. также
Остановить запись макроса

Описание

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

Применение

  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.

Опции

  • При отображении диалогового окна записи макросов: нажмите Esc или кнопку Отмена, чтобы прервать выполнение команды.

Примечания

Настройки

  • 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.