How to set the form title - nsis

The form displays with "Name Setup" as the form caption. I understand how to set the titles of the individual installer pages (Welcome, Finish etc), but how do you set the form caption of the installer interface?

Usually setting Name is enough for the title and all pages.
To customize the default title use Caption or to customize the subtitle on a per page basis use SubCaption, or Caption inside a PageEx block (If you are using the Modern UI, it has defines for most of these)

For pages based on nsDialogs use macro MUI_HEADER_TEXT
Example:
Function nsDialogsPage
!insertmacro MUI_HEADER_TEXT "${LICENSE_TITLE}" "${LICENSE_SUBTITLE}"
nsDialogs::Create /NOUNLOAD 1018
...
nsDialogs::Show
FunctionEnd

Related

Simulate next click on INSTFILES page to take user to a Custom Page (NSIS)

This is my use case:
I'm creating an uninstaller using NSIS.
I'm in the "MUI_UNPAGE_INSTFILES" page during the uninstallation flow.
Files got removed in the "Section Uninstall" code.
Now I need the user to be taken to a custom page, by simulating the next button click in "MUI_UNPAGE_INSTFILES".
I did check for "MUI_UNFINISHPAGE_NOAUTOCLOSE", but I don't have it defined in my code. Still it is not automatically moving to the next page.
This is the code where the pages are defined for the uninstaller:
UninstPage custom un.UninstConfirm_Show ;1st page (custom page)
!insertmacro MUI_UNPAGE_INSTFILES ;2nd page
UninstPage custom un.UninstFinish_Show ;3rd & final page (custom page)
I need to move from 2nd page to 3rd page without user clicking on the next button in the 2nd page.
Any ideas ?
Use the following code to simulate clicking the Next button:
GetDlgItem $0 $HWNDPARENT 1
SendMessage $HWNDPARENT ${WM_COMMAND} 1 $0
FYI: http://forums.winamp.com/showthread.php?t=187143
MUI calls SetAutoClose true in un.onGUIInit when the MUI finish page is used but you can just call SetAutoClose true in a uninstaller section to achieve the same effect.

Unable to hide back button in NSIS Uninstaller

I have an uninstaller created in NSIS.
It has 3 pages (1 custom page (Confirm), the macro MUI_UNPAGE_INSTFILES and another custom page (Finish)).
My problem is that I'm unable to hide the 'Back' button in the "INSTFILES" page.
I have tried various things to hide it, but it simply stays there in disabled state.
This is the code that I'm using to hide the Back button:
GetDlgItem $1 $HWNDPARENT 3
ShowWindow $1 ${SW_HIDE}
Above code works fine for Next and Cancel button when used with ID 1 and 2.
I have tried the above code in various places
un.OnInit
myGuiInit (custom)
Page LEAVE callback of confirm page
Page PRE callback of INSTFILES page
Page SHOW callback of INSTFILES page
Code:
!define MUI_PAGE_CUSTOMFUNCTION_LEAVE un.InstShow
UninstPage custom un.UninstConfirm_Show
!define MUI_PAGE_CUSTOMFUNCTION_PRE un.InstShow
!define MUI_PAGE_CUSTOMFUNCTION_SHOW un.InstShow
!insertmacro MUI_UNPAGE_INSTFILES
UninstPage custom un.UninstFinish_Show
un.InstShow has the logic to hide the button.
Any help would be appreciated. I have spent close to 4-5 hours on this with no luck.
This is how the screen looks now (Note that I have hidden Next and Cancel buttons in the image, to illustrate that hiding those buttons are working fine for me) :
The internal page flag PF_BACK_SHOW in NSIS is set for all pages except the first page, you have to hack your way around it.
If the InstFiles page is the last page or if you don't want the back button on the pages after then you can move the button:
Section -un.Main
GetDlgItem $1 $hwndParent 3
System::Call USER32::MoveWindow(pr1,i-9,i-9,i1,i1,i1)
SectionEnd
If you only want to hide it on the InstFiles page but not on the pages after then you must use a timer and call ShowWindow in the timer callback.
GetDlgItem $1 $HWNDPARENT 3
ShowWindow $1 ${SW_HIDE}
This code is perfectly correct and working fine (tested).
I think there is some other code which shows the button again.
E.g. in scenario when you hide the button in LEAVE function of page X, the following page may show the button again. This happens often in regular UI.
The solution is to check all your custom pages and also the standard pages for any operations regarding this button.

write in header section of custom installer page (without MUI)

I used this guide to create custom page in my installer:
nsDialogs
and its working without a problem, this is the code:
!include nsDialogs.nsh
!include LogicLib.nsh
XPStyle on
Var Dialog
Page custom nsDialogsPage nsDialogsPageLeave
Function nsDialogsPage
nsDialogs::Create 1018
Pop $Dialog
${If} $Dialog == error
Abort
${EndIf}
...
nsDialogs::Show
FunctionEnd
Function nsDialogsPageLeave
...
FunctionEnd
Section
SectionEnd
But the only thing missing is this part:
Could someone help me out and show how to add text there, but without this MUI, all the guides i tried to find are refering to the MUI way but i went with Pages instead so i would like to keep it that way, surely there is a way. Thank you in advance!
Your screenshot looks like MUI. Even when using MUI, custom pages still use Page Custom ....
The MUI has a helper macro to set the text on the top for your custom pages:
!include MUI2.nsh
...
Function nsDialogsPage
!insertmacro MUI_HEADER_TEXT "Blah" "Blah blah"
nsDialogs::...
...
FunctionEnd
This macro is documented in the MUI readme. It is not in the nsDialogs documentation because these labels are in the outer dialog, not in the inner page dialog.
In the unlikely event that you are not using MUI (but you are using the MUI dialog layout and ChangeUI) you can copy the MUI_HEADER_TEXT macro from the MUI(v1) source file or write your own custom macro based on the MUI source.

Customise NSIS MessageBox title / caption

In an NSIS installer, I'm interested in displaying a MessageBox with a custom title. I currently have:
MessageBox MB_OK|MB_ICONEXCLAMATION|MB_TOPMOST "%SOME_STRING%"
In this call, there's no definition of MessageBox title, which then becomes a default string, saying <Installer Name> Setup. I would like to remove the 'Setup' part, or provide a string of my own.
Thank you.
You can use the Caption attribute to set the caption Caption "Whatever" but that changes it globally.
NSIS does not have native support for a custom MessageBox caption but you can call the Windows API directly:
Section
!define MB_OK 0x00000000
!define MB_ICONINFORMATION 0x00000040
System::Call 'USER32::MessageBox(i $hwndparent, t "The message", t "The caption", i ${MB_OK}|${MB_ICONINFORMATION})i'
SectionEnd
You can lookup the other MB_* flags on MSDN...

Change default buttons name NSIS

I am very new to NSIS,
I created a simple installer with 2 screens,
!include LogicLib.nsh
!include nsDialogs.nsh
Page custom someName someEndmethod
Page instfiles
First one is a custom page (nsDialogs) and on it the default button is "install" and i have 2 questtions :
How do i bound a method to its click event ?
How do i change the text on that button ?
BTW - I am not using MUI .
The best reference i could found regarding the nsDialogs was the following:
http://nsis.sourceforge.net/Docs/nsDialogs/Readme.html
but could not seem to find answer to those simple questions.
Thanks
!include WinMessages.nsh
Function MyPageCreate
GetDlgItem $0 $hwndparent 1 ; Get the handle to the button
SendMessage $0 ${WM_SETTEXT} 0 `STR:$(^NextBtn)` ; The part after STR: can be any string, using the next button language string here
nsDialogs::Create 1018
pop $0
nsDialogs::Show
FunctionEnd
Function MyPageLeave
MessageBox mb_yesno "User clicked Next/Install, allow the page change?" IDYES allow
Abort
allow:
FunctionEnd
Page Components
Page Custom MyPageCreate MyPageLeave
Page InstFiles
If you just want to change the string on the install button no matter which page it is on (The page before the instfiles page) you can change it with LangString instead.

Resources