diff -r 000000000000 -r d5ce4c64ef88 Docs/ExperienceUI/pages/visual_settings.htm --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Docs/ExperienceUI/pages/visual_settings.htm Tue Oct 16 00:07:41 2007 -0400 @@ -0,0 +1,255 @@ + +
+
+
+
+
+ How skins work+ ++ In the ExperienceUI world, there are two ways of doing the actual skinning. The first - and most common - is the conventional + NSIS-based method of skinning. The second is skinning using an external plugin, such as WAnsis. The + define XPUI_SKIN applies only to conventional skins; XPUI_WANSIS_SKIN applies to installers using WAnsis. + ++ Blah + + +Basic Settings+ + + + + + + + +Abort Warning++ + + An abort warning is a message that shows when you click Cancel. If you don't use an abort warning, the installer will close + as soon as you click Cancel. + + + + +
+ If you don't use an Abort Warning
+ + + If you have an Abort Page in your installer, you may want to use an automatic abort warning in order to make the Abort page + trigger properly. If you aren't using the ExperienceUI's built-in abort warning system, you can insert the following + function to properly invoke the Abort page. + + + Expand Abort function + + + +
+ $NOABORTWARNING: The mystery revealed
+
+
+
+
+ + + I just realized that though this "mystery" variable has been used with the ExperienceUI forever past, it never got a + mention in the documentation. Here's why it's here: + + Note: In ExperienceUI versions <=1.1, the variable was $NOABORTWARNING. It was renamed to $NOABORTWARNING in versions 1.11. + + The Abort and InstSuccess pages, as you may have noticed, take advantage of an NSIS hack to make the Cancel button close + the installer window without a prompt. The $XPUI_NOABORTWARNING variable is always declared, even if it isn't used, because + of the way the ExperienceUI references variables. When the Abort page or the InstSuccess page is triggered, it uses + StrCpy $NOABORTWARNING 1 to make the .onUserAbort function quit the installer immediately after the Cancel
+ button (which has become the close button) is clicked.+ + The thing is, when I created the first tests of the ExperienceUI code, I was also working on a few installers for some + people. The installers used the Modern UI, but with many custom pages (such as the Install Success page) that later + found their way into the ExperienceUI. I used the $NOABORTWARNING variable to keep track of whether the Cancel button + cancelled the installer or closed the installer window. The variable was renamed to $XPUI_NOABORTWARNING in ExperienceUI version 1.11. + + You can use this variable too - all the ExperienceUI pages and functions understand it. If you know basic window + manipulation (very C++), you can do this quite easily: Disable the "Next" button, and set $XPUI_NOABORTWARNING to 1. When you + click Cancel on the affected page, the installer will quit instantly. Optionally, you can set the text on the Cancel + button to Close or whatever. + Dialog Colors++ + + + + + + +Navigation Buttons+ + + ++ After defining custom text for buttons, that text will be used in the next language inserted. Defining any custom button + text after inserting the last language will have no effect in the final installer. + + + + +Page Background Image+ ++ You can show a bitmap in the background of your installer's pages. Support for thie feature is still experimental, but it should work + for most pages. Note that Stardock WindowBlinds 5.0 can cause problems with this, and 4.x versions are known to cause radio buttons and + check boxes to not work at all. Also, avoid using icon controls that show an icon with a 32x32 image that contains an alpha channel, as this causes the background + of the icon controls to show up as black. + + + + +
+ A note on skins: Header Image+ + + + + +Bottom Image+ + + + + +Background Gradient+ + + + |
+
+
+ + | + + + +