InstallOptionsEx plug-in: Difference between revisions

From NSIS Wiki
Jump to navigationJump to search
Line 11: Line 11:
'''Version:''' 2.4.2 beta 4.
'''Version:''' 2.4.2 beta 4.


This plugin is an extension for the original [[InstallOptions]] plugin you find with NSIS package. For those who want to have a more professional looking NSIS page. See a little bit of the feature list below to entertrain yourself:
This plugin is an extension for the original [[InstallOptions]] plugin you find with NSIS package. For those who want to have a more professional looking NSIS page. See a little bit of the feature list below to entertain yourself:


*More controls: <i>Animation</i>, <i>ProgressBar</i>, <i>TrackBar</i>, <i>IPAddress</i>, <i>DateTime</i>, <i>MonthCalendar</i>, <i>UpDown</i>, <i>TreeView</i> and <i>ListView</i>.
*More controls: <i>Animation</i>, <i>ProgressBar</i>, <i>TrackBar</i>, <i>IPAddress</i>, <i>DateTime</i>, <i>MonthCalendar</i>, <i>UpDown</i>, <i>TreeView</i> and <i>ListView</i>.

Revision as of 11:52, 14 September 2005

Author: deguix (talk, contrib)


Links

Zip.gif InstallOptionsEx.zip (90 KB) (DLL w/ C++ Source)

InstallOptionsEx Forums Thread

Description

Version: 2.4.2 beta 4.

This plugin is an extension for the original InstallOptions plugin you find with NSIS package. For those who want to have a more professional looking NSIS page. See a little bit of the feature list below to entertain yourself:

  • More controls: Animation, ProgressBar, TrackBar, IPAddress, DateTime, MonthCalendar, UpDown, TreeView and ListView.
  • Extended notification system which you can specify the types of notifications you want a control to support.
  • Supports setting colors and font for most of the controls. Alignment works for some controls.
  • Supports timeout, which makes the plugin to go to the validation function automatically after the specified time.
  • Normal and Balloon ToolTips with color change and a halfway multiline support.
  • Automatic detection of number of controls available in your INI page file.
  • Supports variables as a value for any value name, so you don't need anymore to write several times into an INI file.
  • Flags have been added, like of those Buttons with an image or icon, Checkboxes with "gray" state added...
  • ListBox controls have the multicolumn feature which makes each item to occupy less space of the control.
  • Height and Width value names, possibiliting a better organization of controls rectangles.
  • Button and Link controls have the old DirRequest and FileRequest controls abilities so that you can customize the control text and where the result will go of selecting a file or dir.
  • All in 20 KB compressed with UPX.

Documentation is available with the plugin DLL download.

Last Beta Version Changes

  • Added MUnit value name for Settings section and NotifyCursor for Field # section.
  • Re-implemented NumFields from original InstallOptions for compatibility reasons.
  • Added ListView and TreeView controls support for TxtColor and BgColor values.
  • Added EDITLABELS flag for TreeView and ListView controls and MULTISELECT for ListView controls (made single selection default in this case).
  • Fixed empty item names for TreeView and ListView controls.
  • Fixed the return of State and ListItems INI values for Link and Button controls with COLORREQUEST flag.
  • Fixed an interminable loop when UpDown controls had a buddy control that had the ONTEXTCHANGE or ONTEXTUPDATE notification flags.
  • Fixed the range of numbers for UpDown controls. Maximum value for MaxLen and MinLen is 2147483646 and the minimum is -2147483646. Also the default values for the two value names are 2147483646 and -2147483646, respectively.

TODO

Next Version

As Discussed

  • add "\|" escape character.
  • add "Tab" controls. (?)

As Planned

  • GIF, JPG, WML support.

Other Future Versions Before Major Release

  • Most of the types of controls available for Windows.
  • Support for multiple dialogs at the same time.
  • Custom dialogs for pages.
  • Create a system for including new types of controls separately from this plugin. (This is NSIS TODO)

Post Major Release

  • Sorting algorithms for "ListItems" based controls (this should be a separate plugin).
  • Dragging of items.
  • Menus.
  • PNG support.

The rest of it I don't publish (I have my reasons).

Credits

Original IO version Copyright © 2001 Michael Bishop (locnar42)

IO DLL version 1 Copyright © 2001-2002 Nullsoft, Inc., ORTIM (nandhp)

IO DLL version 2 Copyright © 2003-2005 Amir Szekely (kichik), Joost Verburg, Dave Laundon (eccles)

IOEx DLL (changed from original IO 2) Copyright © 2004-2005 Diego Pedroso (deguix)