NSIS/Contrib/Banner
anders_k 7cc150c464 MakeNSIS can now generate Unicode or Ansi installers based on a script attribute. SCons generates both Ansi and Unicode stubs and plugins.
The official plugins are now stored in architecture specific subdirectories under NSIS\Plugins. !AddPluginDir also gained a new (optional) architecture flag because MakeNSIS now stores separate plugin information for each target architecture. Storing plugins in the root of the Plugins directory is no longer supported.

MinGW does not implement the unicode CRT startup functions so the entry point functions and linker parameters had to be changed. The unicode tools use the ansi entry point and a small helper function that calls into the real code: _tmain has full argc+argv emulation while wWinMain does not pass the command line parameters. The stubs do not use any CRT functions and have no CRT or unicode helper code, they call our entry point directly.



git-svn-id: https://svn.code.sf.net/p/nsis/code/NSIS/trunk@6269 212acab6-be3b-0410-9dea-997c60f758d6
2012-10-13 01:47:50 +00:00
..
Banner.c MakeNSIS can now generate Unicode or Ansi installers based on a script attribute. SCons generates both Ansi and Unicode stubs and plugins. 2012-10-13 01:47:50 +00:00
Example.nsi saner waiting times 2009-02-01 00:29:35 +00:00
Readme.txt no more /UNLOAD with new plug-in api 2008-12-12 19:31:52 +00:00
SConscript install and distribute examples, contribs and documentation 2005-04-30 18:04:55 +00:00

BANNER PLUG-IN
--------------

The Banner plug-in shows a banner with customizable text. It uses the IDD_VERIFY dialog of the UI.

There are three functions - show, getWindow and destroy.

Usage
-----

Banner::show "Text to show"

[optional] Banner::getWindow

Banner::destroy

See Example.nsi for an example.

Modern UI
---------

The Modern UI has two labels on the IDD_VERIFY dialog. To change all the texts, use:

Banner::show /set 76 "Text 1 (replaces Please wait while Setup is loading...)" "Normal text"

Custom UI
---------

If you have more labels on your IDD_VERIFY dialog, you can use multiple /set parameters to change the texts.

Example:

Banner::show /set 76 "bah #1" /set 54 "bah #2" "Normal text"

The second parameter for /set is the ID of the control.

Some More Tricks
----------------

If you use /set to set the main string (IDC_STR, 1030) you can specify a different string for the window's caption and for the main string.

If you use an empty string as the main string (Banner::show "") the banner window will not show on the taskbar.

Credits
-------

A joint effort of brainsucker and kichik in honor of the messages dropped during the battle