Dialog Macros - <Project name>

This dialog displays those macros that you manage in macro projects or have inserted into schematic projects.

In a macro project all the representation types and variants are displayed that are stored later during the generation in a macro file for a prepared macro. This applies to all macro types.
In a schematic project only the inserted representation types and variants of a window and / or symbol macros are displayed and not all the variants existing in macro file.

Note:

The macro boxes have to be inserted as well so that the window and symbol macros inserted in the schematic project can be displayed and updated in the macro navigator. To do so activate the project setting Also insert macro boxes. Alternatively you can individually determine for each macro during the preparation of the macros in the macro project whether the macro box is to be inserted or not. The setting at the macro box via the drop-down list Also insert macro box takes priority over the project setting.

You can edit the properties of the macros via the popup menu.

Overview of the main dialog elements:

In the Tree tab, the macros are displayed in a hierarchical structure. The top hierarchy level is the project. Below it the macros are inserted in hierarchy levels with the respective type of usage.

If the macros to be generated are stored within the set macro directory in subdirectories or if the inserted macros are stored in subdirectories, this directory structure is displayed as the next lower hierarchical level. Macros for which no name is entered in the Macro definition or Macro box tab are sorted into the tree structure level "Without name". In the process a separate tree structure level "Without name" is displayed for pages without macro name in which a macro box additionally does not exist.

Below the macros their representation types and variants are displayed. In the process different icons are used for the various macro types and the same icons as for the page types for the representation types.

The placeholder objects existing in a macro are displayed below the hierarchy level for the respective macro variant.

If several placeholder objects are available in a macro variant, they are displayed below the macro variant in accordance with their graphical sequence.
A smaller "anchor" icon is used for placeholder objects that are located in nested macro boxes within the "inner" macro box.

The icons displayed in the tree view of the macro navigator include the following:

Icon	Meaning
	Identifies the project level. This icon is only displayed when several projects are open.
	Directory (in accordance with the path specification in the macro name)
	"Not specified" or "Subordinate" macros
	Defining macros
	Referencing macros
	Window macro
	Symbol macro
	Page macro
(e.g. )	Window and symbol macros: Representation type of the macro box (in this case for example multi-line) Page macros: Page type of the page
	3D macros: layout space
	Macro variant
	Placeholder object

(An overview on the most important icons for project data can be found in the Icons in the Navigators topic.)

Notes:

From the prepared 3D macros that are stored in the layout spaces of a macro project, 3D window macros (*.ema) or 3D symbol macros (*.ems) are generated. Correspondingly the same icons are also displayed for these prepared 3D macros as for the 2D-window or 2D symbol macros.
In the hierarchy level with the representation type / page type the layout space icon with the text "3D mounting layout" is displayed for prepared 3D macros. During the macro generation the representation type "3D mounting layout" is assigned automatically to the 3D macros.

The macro type, the macro name, the representation type, the variant, the description and the file name of the macros are displayed by default in the List tab. In a macro project you can edit some of these properties blockwise as in editing in a table. In a schematic project, the property data is only displayed, and you cannot edit it.

Note:

Only one object at a time can be edited in the list of a navigator. For this reason placeholder objects are not available in the list view of the macro navigator.

Tip:

Use the property Macro: Directory to simply edit the macro directories of macros in the macro project. For direct editing in the added column Macro: Directory, press the [F2] key in the respective spreadsheet cell. With copying and pasting you can then transfer a changed directory to multiple marked directories.

Filter:

This drop-down list displays all the available filters. A selected filter is automatically activated and is applied to both the tree and the list view. The "- Not activated -" entry deactivates the filter and causes an unfiltered display of the data. Click [...] to open the Filter dialog. Here you can create, edit, delete, copy, export, import, and manage filters.

The popup menu of the Filter drop-down list contains the following entries:

Deactivate: This popup menu item is available if a filter has been set: Resets the filter setting to the "- Not activated -" entry.
Activate <filter name>: This popup menu item is available if the filter setting is "- Not activated -": Reactivates the last active filter.

This allows you to toggle rapidly between the unfiltered representation and a representation filtered in accordance with your requirements.

Value: <Property>:

Use this field, via Quick input, to adjust quickly the value of a filter criterion for a defined and activated filter.

Popup menu:

The popup menu provides - depending on the field type (e.g. date, integer, multilingual) - the following menu items that are, depending on the situation, available for influencing the table or editing the values in the fields. You can find an overview of these popup menu items in the section Popup menu items.

In addition, the following dialog-specific popup menu items are available:

Menu item	Meaning
New (tree only)	This menu item is only available in macro projects. Provides a possibility via a submenu to create a page or a layout space for a new macro or – if a page is already opened – to insert a macro box. Depending on the selected hierarchy level (directory, other prepared window macro, etc.) certain data are imported for the new prepared macro.
Delete	Deletes all the selected objects or - in the tree view - all the objects below the selected tree structure level. (Multiple selection of objects or tree structure levels is possible here.)
Generate macros automatically	This menu item is only available in macro projects. Automatically generates macros specifically on the basis of the current selection (for example a single prepared macro).
Update macros	Opens the Update macros dialog with the possibility to change settings for the update. Subsequently the referencing or non-specified macros marked in the project are updated with the data from the associated macro files.
Insert macro	Inserts a window or symbol macro into a layout space from a macro project with the type of usage "Defining" or a project page or a 3D macro. This corresponds to inserting macros from the macro navigator using Drag & Drop. Multiple selection is not possible. Note: Please also note that when inserting via Drag & Drop or via the Insert macro popup menu item, the status of the macro in the macro project and not the saved status of the macro in the macro file is used. If you update a macro that was inserted this way, the status that was saved in the macro file is used.
Assign value set (tree only)	Opens the Select value set - < Placeholder name> dialog, allowing you to assign a value set to the selected placeholder objects.
Select associated objects (only tree)	Selects all objects belonging to the current placeholder object in the graphical editor.
Go to (graphic)	Shows the selected object in the graphical editor or in the layout space.
Insert into list of search results	Allows all of the selected objects to be inserted into the search results list. With Find > Show results you can show these again at a later date.
List with preselection (tree only)	Reduces the number of elements displayed in order to allow for a faster orientation in the list view. If this option is activated, the list view is called up with an automatic filter (preselection) containing the elements that are currently selected.
Select in tree (list only)	Displays the marked object in the Tree tab.
Edit in table	Opens tabular editing, with the possibility of editing the properties of the selected objects.
Properties	Depending on the selection opens the appropriate property dialog for editing the properties of the macro.