|
<< Click to Display Table of Contents >> RayPack > 7.3 u6 > User Guide > PackDesigner > MSI / MST / RPP Based Projects > Common Dialogs Select a Component |
The select a component dialog is used wherever a interface view within RayPack requires advanced component control facilities to specify desired project behavior.
The dialog offers a flat list of all components that have already been created within the packaging project. Users can simply select one of the components by a left-click, and use the OK button to make the selection as required by the view which offered the select a component dialog.
Beyond that, the following additional options that might be required to actually be able to make the final component selection are available.
If the options of the Select a component dialog cannot be used to select the right component, users close the dialog with the Cancel button. If a component is selected within the dialog, the selection is not taken over into the view which was the origin of the dialog usage.
Users add a new component to the list by
•Clicking on the Create button at the upper left corner of the dialog, and selecting the Create a new component item from the displayed options menu.
•Hitting Insert on the keyboard
•Right-clicking anywhere inside the listing of existing components and selecting New component from the context menu.
All options lead to the same result: a newly created component with the default name component. If a component with the same name already exists, an automatically incremented index is added (e. g. NewComponent_2).
Read on to find out how that default name can be modified:
To rename a component, users select it within the listing of components, and either hit F2 on the keyboard, or right-click the component and select Rename from the context menu. Either way, the component name is set into direct inline edit mode, which allows to modify the name directly within the listing. Once the desired component name is set, hitting Enter on the keyboard saves the changes.
The new name of the component must follow the guideline for component names:
•Component names must be unique, non-empty values
•Component names may consist of ASCII characters A-Z (a-z), digits, underscores (_), or periods (.)
•Component names must start with an underscore or a letter
If one of these rules is broken, RayPack shows an error icon. Hover over the icon to display the error message. Alter the entered name to solve the described conflict and be able to save it by hitting Enter.
To leave the direct edit mode without trying to save the changes, the Escape key has to be used.
Newly created components are by default not assigned to a feature. Since components have to be assigned to at least one feature in order to be able to build a valid Installer package from a project, it is highly recommended to establish a feature relation for every new component as soon as possible,
To accomplish that:
•Users right-click the component within the component list, and select Assign to feature... from the context menu.
•The Select features dialog is displayed. Select one or more features from the displayed list and use the OK button to establish an assignment to the component. If required, use the control key to multi-select items.
•Abort the assignment process by using the Cancel button within the Select features dialog.
To delete the relation between component and feature(s), switch to either the FEATURES or the COMPONENTS view of the Advanced mode, since this option is not available for execution from the Select a component dialog.
Since the list of components stored within a packaging project may grow to an uncomfortable size, the keyword search is a handy addition to the Select a component dialog. An input field is available at the upper right corner of the dialog. Simply enter the search term letter by letter to reduce the list to those components who contain the keyword within their name. To restore the full component list, remove the keyword from the input field.