Install Options 2 Tutorial

Author: Joel (talk, contrib)

Author: DannyStaple (talk, contrib)

Tutorial Contents

• Introduction
  • Label
  • Text & Password
  • ComboBox, DropList and ListBox
  • Checkbox and RadioButton
  • Tutorial For FileRequest and DirRequest
  • Icon & Bitmap
  • GroupBox
  • Link
• Example
  • Make the "Select" Page INI
  • Make the "Confirm" Page INI
  • Script Used For Downloader

Welcome

Welcome to Install Options (IO) 2 tutorial v2. IO, from NSIS, is a plugin that allows the programmer to add more pages in their installation, see a screenshot. There are a few changes, from the last tutorial:

• Updated external urls.
• Add a good example: Downloader Example.
• Also in CHM Format: Io2-tutorial.zip (818 KB). <-- problem, the chm doesn't link well the page when using vista, all the link goes to this kind of url res://ieframe.dll/syntax.htm#mk:@MSITStore:C:\Users\support\Downloads\Io2-tutorial\io2.chm::/example1_2.htm and the result is that there is the error "L’adresse n’est pas valide ". The other chm files works on this OS. Is this file readable ?
• More order.

Let's begin, this is what we need:

1. NSIS. The installer that "doesn't suck and isn't huge". Get the latest Development Snapshot in their SourceForge site.
2. Read the Install Options !! Readme file !!.
3. Resource Hacker !! Other resource editors!!. To edit the dialogs and put our controls on it.
4. Patience :whistle: .

General Notes

• We'll do a Tweak with Right and Bottom so IO uses are values in the NSIS dialog, remember the values are in dialog units.
• Is there a lot of possibilities that doesn't match the Resource Hacker dialog editor with the final dialog with NSIS. Test and move as many times you want the controls, just re-following the steps.
• This tutorial will show you how to put the controls in a dialog so you get the values. This tutorial will not create a INI file.

General Instructions:

• Select a UI.
• Make a backup file.
• Use that backup file to open with Resource Hacker.
• Once open, look in the dialog 105. That will be our base dialog.
• Clean up all the objects on it, so we have space for our controls.
• Ready? Select you Control tutorial.

If you have questions please use the Comments Section.

Visit NSIS Forum.

Acknowledgements

Nsis and Install Options, as well their logo and related, are from NSIS:

• Original version by Michael Bishop
• DLL version by Nullsoft, Inc.
• DLL version 2 by Amir Szekely, ORTIM, Joost Verburg
• New documentation by Joost Verburg
• Original from Lobo Lunar/Joel

Links

Io2-tutorial.zip (818 KB) - If the file does not display properly read the following... For io2.chm help file to work with windows vista, 7 and some others you will need to extract the file from the archive and then right click on the file and select properties and press the UNBLOCK button. Then the file will display properly.

Version History

!! Out of date - maybe deprecate it in favour of the wiki page history later? !!

24/Oct/2009

Explained how to make the io2.chm file work on vista and others.

5/mar/2004

Changed URL and server.

26/jul/2003

External links updated.

26/jul/2003

Added an Install Options example: Downloader.

7/jul/2003

New web site address...Cool host... for me :P

23/jun/2003

Changed download URL. You can download it in CHM and/or ZIP (html files). Added the "Link" tutorial. (Cool and easy as "Label")

14/jun/2003

Changed download URL.

Thanks and sorry!