Panes and Actions
Previous Topic  Next Topic 

The Install / Uninstall Panes and Actions section of the install builder shows a tree of your install's user interface.  The user interface is first defined by a set of possible install types.  Underneath that is a list of all of the panes that are included in that install type.  Each pane can have any number of actions that execute as the user moves through the install.


Panes

Selecting a pane in the tree will bring up some information for that pane as well as properties that you can modify to customize the pane.  See What are Panes? for more details.


Actions

Selecting an action in the tree will bring up some information for that action as well as properties that you can modify to customize the action.  See What are Actions? for more details.


The user interface tree defines how the user will see your install when they run it.  It contains several install modes that are defined by InstallJammer, and beneath those are the panes that are included for that install mode.  Each pane can have any number of actions attached to it.



The User Interface Tree


Note

Panes and actions that have been added since the project was last loaded will appear in blue.  A * beside a pane or action's title tells you that the given pane or action has conditions attached to it.


Common Components 

This section of the interface tree is used to hold panes of an install theme that don't belong anywhere in the install process itself.  Panes installed in the Common Components section can be modified just like normal panes, but you don't have the option to add the same pane to an install type.


Common examples of this are a background window that covers the screen behind the install wizard with some text or images.


Standard Install

This section contains the panes used by InstallJammer for a standard installation.  A standard installation is when the user chooses to install the application just as you built it.  All of the panes will be shown in order as they are shown on the interface tree.


Default Install

A default install is when the user has chosen to accept all of your default settings and just do the install without changing anything.  The default install usually contains just a few screens to prompt the user to confirm installation and then to copy all of the files.


Console Install

A console install is when the user wants to install the program from a command line instead of through the GUI interface.  A console install will run inside a terminal window and everything will be input and output to and from the terminal.


Note

Console installs are not supported on Windows.


Silent Install

A silent install is when the user wants to accept all of the default options and install the program silently without a GUI interface.  This is useful for some administrators who have to install an application on many different machines.


A silent install does not have any panes, only actions.  Because of this, you will only see a list of actions under the Silent Install, and you are not allowed to add panes.


Action Groups

Action groups are a way to group actions together into one place.  An action group can contain any number of actions to execute and has its own conditions and properties as well as those of the actions it holds.


Action groups are best used if you define an alias for them so that you don't always have to remember the ID of the action group.  This is how InstallJammer sets up the default Startup Actions and Install Actions groups when it creates a new project.  You can execute all of the actions in an action group by using the Execute Actions action.


See What are Action Groups?



Previewing a pane

Once you've selected a pane you will see a button in the bottom right-hand corner of the properties window to preview the pane.  Clicking this button will pop up a sample wizard with the pane you're currently viewing.  This lets you see the pane the way it will appear during installation.


Most options, if changed, will automatically affect the appearance of the preview window, so you should be able to make textual and design changes, click Preview Pane again, and immediately see your changes.  Not all changes are immediately seen.  Some changes and options can only be seen when actually running the install.  In this case, simply build and run a test install of your project to see what the panes will look like.


Editing pane code

Each pane in an install is defined by the Tcl/Tk code that built it.  InstallJammer gives you the freedom and flexibility to modify each pane in your install to be exactly what you want it to be.  Simply click the Edit Pane Code button when editing a pane, and an editor will pop up with all of the Tcl/Tk code used to create the pane you're looking at.  If you don't understand Tcl/Tk code, you might want to read What is Tcl/Tk? as a starting point.


Restoring original pane code

The Restore Original Pane button will restore the original code for the pane currently being edited.  This is useful if you wish to remove the changes you've made to the pane or you accidentally messed up the pane code.  Restoring the pane code will put the pane code back into its original state.  It will not modify your properties though.  Only the code of the pane.