InstallOptionsEx plug-in: Difference between revisions

From NSIS Wiki
Jump to navigationJump to search
(Version: 2.0.2 beta 3 post-build 2.)
No edit summary
 
(71 intermediate revisions by 10 users not shown)
Line 3: Line 3:
== Links ==
== Links ==


[[Image:Zip.gif]] [http://forums.winamp.com/attachment.php?s=&postid=1719282 InstallOptionsEx.zip] (90 KB) (DLL w/ C++ Source)
[[File:Zip.gif]] [https://sourceforge.net/projects/nsis-ioex/files/IOEx%20beta/2.4.5%20beta%203/InstallOptionsEx2.4.5b3.zip/download InstallOptionsEx2.4.5b3.zip] (232 KB) (DLL w/ C++ Source)


[http://forums.winamp.com/showthread.php?postid=1719282#post1719282 InstallOptionsEx Forums Thread]
[[File:Exe.gif]] [https://sourceforge.net/projects/nsis-ioex/files/IOEx%20beta/2.4.5%20beta%203/InstallOptionsEx2.4.5b3.exe/download InstallOptionsEx2.4.5b3.exe] (426 KB) (DLL w/ C++ Source)
 
[http://forums.winamp.com/showthread.php?t=265453&page=2#post3067421 InstallOptionsEx Forum Thread]
 
[http://sourceforge.net/projects/nsis-ioex InstallOptionsEx SourceForge Project Page]


== Description ==
== Description ==


'''Version:''' 2.4.2 beta 3 post-build 2.
'''Version:''' 2.4.5 beta 3.


This plugin is an extention for the original InstallOptions 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 plug-in|InstallOptions]] plug-in 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>, <i>ListView</i>, <i>Image</i> (based on already existing ones) and <i>RichText</i>.
*Extended notification system which you can specify the types of notifications you want a control to support.
*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 setting colors and font for most of the controls. Alignment works for some controls.
Line 22: Line 26:
*Flags have been added, like of those <i>Buttons</i> with an image or icon, <i>Checkbox</i>es with "gray" state added...
*Flags have been added, like of those <i>Buttons</i> with an image or icon, <i>Checkbox</i>es with "gray" state added...
*<i>ListBox</i> controls have the multicolumn feature which makes each item to occupy less space of the control.
*<i>ListBox</i> controls have the multicolumn feature which makes each item to occupy less space of the control.
*<i>Height</i> and <i>Width</i> value names, possibiliting a better organization of controls rectangles.
*<i>Height</i> and <i>Width</i> value names, have a better organization of controls rectangles.
*<i>Button</i> and <i>Link</i> controls have the old <i>DirRequest</i> and <i>FileRequest</i> controls abilities so that you can customize the control text and where the result will go of selecting a file or dir.
*<i>Button</i> and <i>Link</i> controls have the old <i>DirRequest</i> and <i>FileRequest</i> controls abilities so that you can customize the control text and where the result will go of selecting a file or dir.
*All in 19.5 KB compressed with UPX.


Documentation is available with the plugin DLL download.
Documentation is available with the plugin DLL download.


== Last Minor Version Changes ==
== Lastest Version Changes ==


*Added new value names for "Field #" section: ''RefField'', ''StateImageList'', ''SmallImageList'', ''LargeImageList'', ''HeaderItems'', ''HeaderItemsAlign'', ''HeaderWidth''.
After seven years since the last beta version, this is the new InstallOptionsEx version 2.4.5 beta 3.
*Added new flags for ''ListView'' controls: ''LIST_VIEW'', ''ICON_VIEW'', ''SMALLICON_VIEW'', and ''REPORT_VIEW'' and for ''Link'' and ''Button'' controls: ''COLORREQUEST'', ''FONTREQUEST''.
*'''Older INI's braking notice:''' All values supported by ''OPEN_FILEREQUEST'', ''SAVE_FILEREQUEST'' and ''DIRREQUEST'' flags for ''Link'' and ''Button'' controls on ''State'' value name and ''UpDown'' controls on ''Text'' value name were transferred to ''RefField'' value name.
*Now ''Link'' and ''Button'' controls with ''OPEN_FILEREQUEST'', ''SAVE_FILEREQUEST'', ''DIRREQUEST'', ''COLORREQUEST'', ''FONTREQUEST'' flags output state values to ''State'' value name.
*''UpDown'' controls now detect automatically the text from its buddy control. ''State'' value is not used anymore when the buddy control is set.
*'''Older INI's braking notice:''' All values for ''TreeView'' controls on ''Text'' value name were transferred to ''StateImageList'' value name.
*Fixed automatic Custom Draw setting for ''Label'', ''DropList'', ''ComboBox'', and ''ListBox''. Custom Draw setting will only be set if you specify one of the color commands values. Because of this, when this setting is disabled, the colors will be as the Windows' default, and some features like multiline for those controls (except ''Label'') will be disabled. The good news is that this fixes problems when setting text to those controls or change some colors for now. To use custom draw in controls with default color values, use empty values like on "TxtColor=".
*Added forgotten details about ''Animation'' controls support for the ''State'' INI value, types of animation supported, ''TreeView'' controls support for the ''StateImageList'' INI value, and the ''ONSELCHANGE'' notification flag.
*Fixed problems with notifications that executed when other handled or non-handled notifications were activated.
*Fixed checkbox state changes on ''TreeView'' controls when the space key was pressed.
*Other small bugfixes.


== TODO ==
A lot of bugs were fixed in this version.


=== Next Version ===
Two versions of the plugin are available: an ANSI and an UNICODE.


==== As Discussed ====
'''Changes since version 2.4.5 beta 2:'''
*add "\|" escape character.
*fix a bug on the last parameter of FONTREQUEST flag "State" INI value. The color is indicated as a decimal number.
*add "Tab" controls. (?)


==== As Planned ====
A big thank to Tallmaris (Leandro Tramma) for the initial unicode compatibility.


*Series of quick versions for bugfixing and addition of pending TODO stuff.
* Added: Full unicode support;
* Added: make_unicode dll function for Unicode build: Convert an ANSI INI file to the UNICODE charset;
* Applied patches from the original InstallOptions source repository.


=== Other Future Versions ===


*Custom dialogs for pages.
== Credits ==
*Create a system for including new types of controls separatedly from this plugin. (This is NSIS TODO)


The rest of it I don't publish (I have my reasons).
Original IO version Copyright © 2001 Michael Bishop ([[User:locnar42|locnar42]])


== Credits ==
IO DLL version 1 Copyright © 2001-2002 Nullsoft, Inc., ORTIM


Original IO version Copyright © 2001 Michael Bishop ([[User:locnar42|locnar42]])
IO DLL version 2 Copyright © 2003-2009 Amir Szekely ([[User:kichik|kichik]]), [[User:Joost Verburg|Joost Verburg]], Dave Laundon ([[User:eccles|eccles]])


IO DLL version 1 Copyright © 2001-2002 Nullsoft, Inc., ORTIM ([[User:nandhp|nandhp]])
IOEx DLL Copyright © 2004-2005 Diego Pedroso ([[User:deguix|deguix]])


IO DLL version 2 Copyright © 2003-2005 Amir Szekely ([[User:kichik|kichik]]), [[User:Joost Verburg|Joost Verburg]], Dave Laundon ([[User:eccles|eccles]])
IOEx DLL (starting at v.2.4.5) Copyright © 2006-2016 [[User:SuperPat|SuperPat]]


IOEx DLL (changed from original IO 2) Copyright © 2004-2005 Diego Pedroso ([[User:deguix|deguix]])


[[Category:Plugins]]
[[Category:Plugins]]

Latest revision as of 12:11, 27 August 2016

Author: deguix (talk, contrib)


Links

Zip.gif InstallOptionsEx2.4.5b3.zip (232 KB) (DLL w/ C++ Source)

Exe.gif InstallOptionsEx2.4.5b3.exe (426 KB) (DLL w/ C++ Source)

InstallOptionsEx Forum Thread

InstallOptionsEx SourceForge Project Page

Description

Version: 2.4.5 beta 3.

This plugin is an extension for the original InstallOptions plug-in 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, ListView, Image (based on already existing ones) and RichText.
  • 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, have 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.

Documentation is available with the plugin DLL download.

Lastest Version Changes

After seven years since the last beta version, this is the new InstallOptionsEx version 2.4.5 beta 3.

A lot of bugs were fixed in this version.

Two versions of the plugin are available: an ANSI and an UNICODE.

Changes since version 2.4.5 beta 2:

A big thank to Tallmaris (Leandro Tramma) for the initial unicode compatibility.

  • Added: Full unicode support;
  • Added: make_unicode dll function for Unicode build: Convert an ANSI INI file to the UNICODE charset;
  • Applied patches from the original InstallOptions source repository.


Credits

Original IO version Copyright © 2001 Michael Bishop (locnar42)

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

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

IOEx DLL Copyright © 2004-2005 Diego Pedroso (deguix)

IOEx DLL (starting at v.2.4.5) Copyright © 2006-2016 SuperPat