The Screens & Actions Configuration Step


The "Installer->Screens & Actions" step shows a tree representation of the installer, the uninstaller and other installer applications, such as updaters. The nodes in the tree are of the following types:

In this chapter, the functionality and configuration options on the "Installer->Screens & Actions" step are discussed, the underlying concepts are discussed in a different help topic.

Adding new installer elements

Installer elements are added by clicking the  Add button.

In the popup window you can select whether to add

Installer elements can only be added to appropriate parent elements. If no appropriate parent element is selected, install4j tries to find one by moving in the ancestor hierarchy from the current selection. If no appropriate parent element can be found, an error message is displayed.

Editing installer elements

If you select a single installer element in the tree of installer elements, you can edit its properties on the right side. Properties that have been modified are shown with an asterisk (*) in front and can be restored to their default value with the "Reset To Default" action from the context menu.

Selecting multiple installer elements is possible on the same tree level, meaning that all selected elements have to be siblings in the tree.

When the configuration area is focused, you can transfer the focus back to the tree of installer elements with the keyboard by pressing ALT-F1.

The tree of installer elements provides the following actions in the toolbar on the right that operate on the current selection. You can also access these actions from the context menu or use the associated keyboard shortcuts.

Searching for installer elements

In the log files, actions and screens are logged with their IDs. You can navigate to installer element if you know their ID by clicking on the  search icon and choosing "Search ID" from the popup menu.

When a match is found the result tree shows the match at the top together with the reverse chain of installer elements that lead to it. You can either show the match itself or select any other element in the result tree and show that element instead when closing the dialog with the Show button. This works even if the target element is in a form component dialog or an action list or a property. The scope of the search is always rooted in the installer elements that are reachable from the current view.

A separate action "Search Names, Comments and Properties" is available to search for arbitrary patterns. You can disable any of the search types to narrow down the scope of the search.

Display options for installer elements

When using the install4j API, you reference installer elements with IDs. You can show IDs in the tree of installer elements by toggling the  Show IDs tool bar button.

In order to adjust the information density in the tree of installer elements, you can change the icon size by choosing large or small icons in the Icon Size sub-menu in the context menu. The default setting is to show large icons.