InstallOptionsEx plug-in: Difference between revisions

From NSIS Wiki
Jump to navigationJump to search
m (Linking correctly to InstallOptions plug-in.)
(Version: 2.4.4 beta 1.)
Line 9: Line 9:
== Description ==
== Description ==


'''Version:''' 2.4.2 beta 5.
'''Version:''' 2.4.4 beta 1.


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:
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:
Line 30: Line 30:
== Latest Beta Version Changes ==
== Latest Beta Version Changes ==


*Added RichText control.  
*Removed GPL'd code from the plug-in. Removed support for GDI+, which in turn, removed newer systems support of .png, .tiff, and .emf files.
*Added BufferSize value name for Settings section. A note though, everything, including Type value for all fields are affected.
*Added support for the key "F2" on ''TreeView'' and ''ListView'' controls.
*Added ReadOnlyTxtColor and ReadOnlyBgColor value names for Text and RichText controls.
*Fixed the selection of the last item with the "End" key in a ''ListView'' control without the ''CHECKBOXES'' flag and without using ''LargeImageList'' INI key.
*Added ONTEXTSELCHANGE notification flag for RichText controls.
*Fixed: When StateImageList points to an invalid file, it still applies the ''CHECKBOXES'' flag normally.
*Bitmap, Icon and Animation controls have now fused together into a control called Image. The old control names are still supported for compatibility.
*Fixed: When a label was not changed in TreeView or ListView controls that use the ''EDITLABELS'' flags, it was emptied.
*Image controls now use GDI+ or OLE when needed. So there are new file types supported: .jpg, .jpeg, .gif (GDI+ or OLE), .png, .tiff, .wmf, .emf (GDI+ only).
*Older INI files braking notice: Renamed icon names for ToolTipIcon value name to INFORMATION, EXCLAMATION and STOP, as defined under the icon resources for the State value name for Image controls.  
*Added "\|" escape characters for ListBox, DropList, ComboBox controls. This applies to list based value names only.
*Added "\|", "\{" and "\}" escape characters for ListView and TreeView controls. This applies to list based value names that do not use just numbers only.  
*Fixed internal memory leaks and bugs.
*For Link and Button controls using DIRREQUEST flag:
**Fixed the non-disabling "OK" button when a non-folder item was selected (like My Computer).
**Added ability for the State INI value name to specify the initial folder shown in the DIRREQUEST dialog.
*Now FONTREQUEST and COLORREQUEST flags for Button and Link controls output the control state even if a value is specified for the RefFields value name.
*Fixed string not being truncated at the maximum buffer size allowed when Text and Password controls returned (IO bug).  
*Fixed Link and Button controls with DIRREQUEST flag: "|" character was appended everytime to the end of ListItems value name.
*Corrected the formula to convert pixels into points for Link and Button controls with FONTREQUEST flag.  
*Fixed Link and Button controls State value name return value when used with FILE_OPENREQUEST and MULTISELECT flags: String was truncated to the first 1023 characters (1024 w/ the terminator character).
*State INI value name for ComboBox controls now uses the text specified for the state if it is not one of the items specified in ListItems.
*HSCROLL and VSCROLL flags won't work anymore if specified for controls that do not support this flag. The effect is simply useless.
*Re-added EXTENDEDSELCT and REQ_SAVE flags for compatibility purposes with IO.
*Fixed bugs: {{BR|1287731}} and {{BR|1283528}}.  


== Things To Do on Next Versions ==
== Things To Do on Next Versions ==
Line 66: Line 49:
*'''TODO:''' Make flags for ''Image'' control so that you can make the control to accept files with different extentions for the same image type.
*'''TODO:''' Make flags for ''Image'' control so that you can make the control to accept files with different extentions for the same image type.
*'''BUG:''' When using ''TreeView'' controls with ''EDITLABELS'' flag, and when you change an item name, if you press "ESC" or "ENTER", the installer is dismissed, which is what happens for other actions in the installer. This doesn't happen with ''ListView''.
*'''BUG:''' When using ''TreeView'' controls with ''EDITLABELS'' flag, and when you change an item name, if you press "ESC" or "ENTER", the installer is dismissed, which is what happens for other actions in the installer. This doesn't happen with ''ListView''.
*'''TODO:''' Add a "F2" hotkey to change the name of an ''TreeView'' or ''ListView'' control item.
*'''BUG:''' When ''StateImageList'' points to an invalid file, it still applies the ''CHECKBOXES'' flag normally.


=== Other Future Versions Before Major Release ===
=== Other Future Versions Before Major Release ===
Line 86: Line 67:
== Things Done for the Next Version ==
== Things Done for the Next Version ==


*'''Fixed''': When a label was not changed in TreeView or ListView controls that use the EDITLABELS flags, it was emptied.
*Nothing at this moment.


== Credits ==
== Credits ==

Revision as of 16:36, 13 November 2005

Author: deguix (talk, contrib)


Links

InstallOptionsEx.zip (116 KB) (DLL w/ C++ Source w/ InstallerOptions.cpp diff from last version)

InstallOptionsEx Forums Thread (where anything directly about this plug-in should always be posted)

Description

Version: 2.4.4 beta 1.

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.
  • All in 23 KB compressed with UPX.

Documentation is available with the plugin DLL download.

Latest Beta Version Changes

  • Removed GPL'd code from the plug-in. Removed support for GDI+, which in turn, removed newer systems support of .png, .tiff, and .emf files.
  • Added support for the key "F2" on TreeView and ListView controls.
  • Fixed the selection of the last item with the "End" key in a ListView control without the CHECKBOXES flag and without using LargeImageList INI key.
  • Fixed: When StateImageList points to an invalid file, it still applies the CHECKBOXES flag normally.
  • Fixed: When a label was not changed in TreeView or ListView controls that use the EDITLABELS flags, it was emptied.

Things To Do on Next Versions

Next Version

As Discussed

  • TODO: add "Tab" controls. (?)

As Planned

  • TODO: Add ability to convert "\\" to "\" in lists.
  • BUG: The ListItems value name for ComboBox and DropList controls can't have the combination "\\" and "\|". This needs to be verified.
  • TODO: Make flags for Image control so that you can make the control to accept files with different extentions for the same image type.
  • BUG: When using TreeView controls with EDITLABELS flag, and when you change an item name, if you press "ESC" or "ENTER", the installer is dismissed, which is what happens for other actions in the installer. This doesn't happen with ListView.

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.

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

Things Done for the Next Version

  • Nothing at this moment.

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)

The source code uses parts from AutoHotkey's source code by Chris Mallet, licensed under GPL. Those parts are explicitly marked inside the plug-in's source code.

Retrieved from "https://nsis.sourceforge.io/mediawiki/index.php?title=InstallOptionsEx_plug-in&oldid=8397"