Installer - Styles


  For more information on styles, please see the corresponding help topic.
  The  Add button shows a popup window where you can select whether to add
  • a configurable style. Styles can be constructed with a restricted set of the form components for screens that do not take user input and some special form components that are relevant in a styling context.
  • a style that is contained in your custom code. New types of reusable styles can be developed with the install4j API. In your custom code configuration you can specify code locations that are scanned for suitable classes. A class selector will be shown where you can select the desired class.
  • a group for organizing styles, so you have a better overview of which styles belong together.
 

If you select a single style in the list of styles, you can edit its properties on the right side. Selecting multiple styles is possible on the same tree level, i.e. all selected elements have to be siblings in the tree.

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

The list of styles 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.

  • Delete
    All selected styles will be deleted after a confirmation dialog when invoking the  Delete action. The deleted styles cannot be restored.
  • Rename
    After you add a style, the list of styles shows it with its default name. This is often enough, however, if you have multiple instances of the same style alongside, a custom name makes it easier to distinguish these instances. You can assign a custom name to each style with the  Rename action. The default name is still displayed in brackets after the custom name. To revert to the default, just enter an empty custom name in the rename dialog.
  • Comment
    By default, styles have no comments associated with them. You can add comments to selected styles with the  Add Comments action. When a comment is added, the affected styles will receive a "Comments" tab. After adding a comment to a single style, the comment area is focused automatically. Likewise, you can remove comments from one or more styles with the Remove Comments action.

    In order to visit all comments, you can use the Show next comment and Show previous comment actions. These actions will focus the comment area automatically and wrap around if no further comments can be found.

  • Disable
    In order to "comment out" styles, you can use the  Disable action. The configuration of the disabled styles will not be displayed, their entries in the list of styles will be shown in gray and they will not be checked for errors when the project is built.
  • Copy and paste
    install4j offers an inter-process clipboard for styles. You can  Cut or  Copy styles to the clipboard and  Paste them in the same or a different instance of install4j. Note that references to launchers or references to files in the distribution tree might not be valid after pasting to a different project.

    Pasted styles are appended to the end of the list of styles.

  • Reorder
    If your selection is a single contiguous interval, you can move the entire block  up or  down in the list. The selection can only be moved on the same level with the reorder actions. To move the selection to a different parent, you can cut and paste it (see above).
  • Group
    You can create a group from the selected styles with the Create group from selection action. The new group will be inserted in place of the selected elements.

    You can dissolve a group with the Dissolve Group action. This action is only enabled if the selection consists of a single layout group. The elements contained in the group will be inserted in place of the group. Nested groups will not be dissolved.

  Form styles have the following properties:
  • Standalone style
    If selected, the style can be selected for installer applications, screen groups and screens. If a style is not standalone, it can only be used in other styles.
  • Fill horizontal space
    If selected, all available horizontal space is filled by this style. This setting is also used when it is nested in another style by a "Nested style" form component.
  • Horizontal anchor
    If "Fill horizontal space" is not selected, the style can be placed at different locations in the available space.

    Note: This property is only visible if "Fill horizontal space" is selected.

  • Fill vertical space
    If selected, all available vertical space is filled by this style. This setting is also used when it is nested in another style by a "Nested style" form component.
  • Vertical anchor
    If "Fill vertical space" is not selected, the style can be placed at different locations in the available space.

    Note: This property is only visible if "Fill vertical space" is selected.

  You can preview a style with the  Preview button which is also available on the property page of a style.