InstallOptionsEx plug-in: Difference between revisions

From NSIS Wiki
Jump to navigationJump to search
m (Added category links.)
(InstallOptionsEx 2.4.2 beta 2)
Line 5: Line 5:
== Links ==
== Links ==


[[Image:Zip.gif]] [http://forums.winamp.com/attachment.php?s=&postid=1621363 InstallOptionsEx.zip] (72 KB) (DLL - Version 2.4.2 beta 1 w/ C++ Source)
[[Image:Zip.gif]] [http://forums.winamp.com/attachment.php?s=&postid=1621363 InstallOptionsEx.zip] (75 KB) (DLL - Version 2.4.2 beta 2 w/ C++ Source)


[http://forums.winamp.com/showthread.php?postid=1621363#post1621363 InstallOptionsEx Forums Thread]
[http://forums.winamp.com/showthread.php?postid=1663206#post1663206 InstallOptionsEx Forums Thread]


== Description ==
== Description ==
Line 16: Line 16:
*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.
*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.
*Normal and Balloon ToolTips with color change and a halfway multiline support.
*Automatic detection of number of controls available in your INI page file.
*Automatic detection of number of controls available in your INI page file.
Line 29: Line 30:
== Last Version Changes ==
== Last Version Changes ==


*Added new control type: TreeView.
*Added TimeOut INI value name for "Settings" section. This enables the page to return after the specified time. When notifications are activated, the timer pauses until "Abort" is called on page's validation function. Also, it continues to repeat until the page is closed.
*Major Fix: Password controls without a value for Text INI value name gave a fatal error.  
*Added ONRCLICK for TreeView controls.
*Added new flags to Flags INI value name: CHECKBOXES for TreeView controls, TRANSPARENT for Animation controls (second implementation).  
*Fixed ONCLICK notification flag: Only captured single-clicks when ONDBLCLICK was not set.
*Removed flags from Flags INI value name: RIGHT for CheckBox and RadioButton controls, LEFT for UpDown controls.
*Added the missing Notify INI value name on the documentation.
*Added new INI value names for "Field #" INI sections: Align, VAlign, TxtAlign,and TxtVAlign.  
*Removed ellipsis support for strings that pass control border boundaries on Label, Link, DropList, ComboBox and ListBox controls.  
*Added tab character support for Label and Link controls.  
*Added carriage return, new line and tab characters support for DropList, ComboBox and ListBox controls.
*Adjusted rectangles of Label and Link controls so that the focus rectangle don't cut part of strings (only Link controls) and have at least 1 pixel of background color on the left and right of the control.
*Right-To-Left dialogs have the UpDown control to invert its position in relation to its buddy control.  
*Forgot to mention about NOWORDWRAP flag for Text and Password controls in the documentation.
*MaxLen INI value name for TrackBar controls didn't calculate correctly the maximum number of items. Now if you specify 10, there will be 10 items.
*Aplied patch [http://sourceforge.net/tracker/index.php?func=detail&aid=1164307&group_id=22049&atid=373087 #1164307].  


== TODO ==
== TODO ==
Line 48: Line 40:


==== As Discussed ====
==== As Discussed ====
*Add "Notify" INI value name for "Field #" section to the docs.
*None at this moment.
*Fix issues with notification flags with the addition of a new control.


==== As Planned ====
==== As Planned ====
Line 59: Line 50:


=== Other Future Versions ===
=== Other Future Versions ===
*Custom dialogs for pages.
*Custom dialogs for pages.
*Add more types of Windows default dialogs.
*Add more types of Windows default dialogs.

Revision as of 07:33, 7 May 2005

Author: deguix (talk, contrib)


Links

Zip.gif InstallOptionsEx.zip (75 KB) (DLL - Version 2.4.2 beta 2 w/ C++ Source)

InstallOptionsEx Forums Thread

Description

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:

  • More controls: Animation, ProgressBar, TrackBar, IPAddress, DateTime, MonthCalendar, UpDown, and TreeView.
  • 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 16 kb compressed with UPX.

Documentation is available with the plugin DLL download.

Last Version Changes

  • Added TimeOut INI value name for "Settings" section. This enables the page to return after the specified time. When notifications are activated, the timer pauses until "Abort" is called on page's validation function. Also, it continues to repeat until the page is closed.
  • Added ONRCLICK for TreeView controls.
  • Fixed ONCLICK notification flag: Only captured single-clicks when ONDBLCLICK was not set.
  • Added the missing Notify INI value name on the documentation.

TODO

Next Version

As Discussed

  • None at this moment.

As Planned

  • Add more INI value names to the Settings INI section.
  • "Ownerdraw" style for TreeView (?).
  • More types of checkboxes for TreeView controls (?).
  • Make API's to work again with controls.

Other Future Versions

  • Custom dialogs for pages.
  • Add more types of Windows default dialogs.
  • 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).

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)