Components
Previous Topic  Next Topic 

Components are used to group file groups in your install into user-friendly categories.  Each component can contain any of the file groups in your project, and if the user is presented with the option, they can choose which components they wish to install.


By default, a single component called Default Component is created for your project, and it contains the Program Files file group.



Standard Properties

See Standard Properties.


Checked

If this property is true, this component will be displayed as checked when it is first added to a component tree.  This will automatically set the active status of the component depending on the value when it is first added to a tree.


Component Group

If this property is specified, it tells InstallJammer to put this component into a specific group with other components.  Each component that shares the exact same name of group will be grouped together as radio buttons instead of check buttons.  You must make sure that each component you want in a radio group shares the same exact Component Group name.


Name

The name of this component.


Required Component

This option tells InstallJammer that this component is required for all installations and will therefore not be available for the user to uncheck during installation.  The component will still appear in the list of available components, but it will be disabled for the user.


Selectable

If this property is set to No, the component is displayed in a component tree as a header with no check or radio button.


Show Component

If this property is false, the component will not be added to a component tree when it is drawn.  This can be used to hide components that you don't want shown during installation.


Size

If the size property is specified, it tells InstallJammer to override what may actually be the size of the files stored in the component and use the given size instead.  The size should be given as an integer only which will automatically be converted to a readable size during installation.



Text Properties


Description

This is a brief description of the contents of this component.  If the user is able to choose which components they wish to install (during a Custom installation) they will see this description for each component to tell them what is in it.


Display Name

The name of the component to display when populating the components on a pane.  If this property is left blank for a given language, the installer will use the standard Name property instead.



Build Platforms

This is a list of all the platforms that are supported by InstallJammer and whether or not this component should be built for each platform. If a platform is marked No, this component will not be included when the installer for that platform is built.


It is possible to build a component into multiple platforms and then not install the component based on parameters during installation, but this option specifically tells InstallJammer to not even include this component for the given platform.



Creating a new component

Click the Add New Component button on the toolbar to add a new component to your install.


A new component is created with default values that you can change after its creation.  Since components can be nested, your new component will be a child of whatever component is currently selected when you create your new component.


Deleting a component

Select the component you wish to delete and click the Delete Component button on the toolbar or the delete key on your keyboard.