075a02d3bb
git-svn-id: https://svn.code.sf.net/p/nsis/code/NSIS/trunk@1979 212acab6-be3b-0410-9dea-997c60f758d6
87 lines
No EOL
4.6 KiB
Text
87 lines
No EOL
4.6 KiB
Text
\S1{ui} User Interface Instructions
|
|
|
|
\S2{BringToFront} BringToFront
|
|
|
|
Makes the installer window visible and brings it to the top of the window list (i.e. if a command was executed that shows itself in front of the installer, a BringToFront would bring the installer back in focus).
|
|
|
|
\S2{createfont} CreateFont
|
|
|
|
\c user_var(handle output) face_name [height] [weight] [/ITALIC] [/UNDERLINE] [/STRIKE]
|
|
|
|
Creates a font and puts its handle into user_var. For more information about the different parameters have a look at \W{http://msdn.microsoft.com/library/default.asp?url=/library/en-us/gdi/fontext_8fp0.asp}{MSDN's page about the Win32 API function CreateFont()}.
|
|
|
|
\S2{detailprint} DetailPrint
|
|
|
|
\c user_message
|
|
|
|
Adds the string "user_message" to the details view of the installer.
|
|
|
|
\S2{findwindow} FindWindow
|
|
|
|
\c user_var(hwnd output) windowclass [windowtitle] [windowparent] [childafter]
|
|
|
|
Searches for a window. Behaves like the win32 FindWindowEx(). Searches by windowclass (and/or windowtitle if specified). If windowparent or childafter are specified, the search will be restricted as such. If windowclass or windowtitle is specified as "", they will not be used for the search. If the window is not found, the user variable returned is 0. To accomplish old-style FindWindow behavior, use FindWindow with SendMessage.
|
|
|
|
\S2{getdlgitem} GetDlgItem
|
|
|
|
\c user_var(output) dialog item_id
|
|
|
|
Retrieves the handle of a control identified by item_id in the specified dialog box dialog. If you want to get the handle of a control on the inner dialog, first use FindWindow user_var(output) "#32770" "" $HWNDPARENT to get the handle of the inner dialog.
|
|
|
|
\S2{hidewindow} HideWindow
|
|
|
|
Hides the installer.
|
|
|
|
\S2{iswindow} IsWindow
|
|
|
|
\c HWND jump_if_window [jump_if_not_window]
|
|
|
|
If HWND is a window, Gotos jump_if_window, otherwise, Gotos jump_if_not_window (if specified).
|
|
|
|
\S2{sendmessage} SendMessage
|
|
|
|
\c HWND msg wparam lparam [user_var(return value)] [/TIMEOUT=time_in_ms]
|
|
|
|
Sends a message to HWND. If a user variable $x is specified as the last parameter (or one before the last if you use /TIMEOUT), the return value of SendMessage will be stored to it. Note that when specifying 'msg' you must just use the integer value of the message. If you wish to send strings use "STR:a string" as wParam or lParam where needed.
|
|
|
|
\S2{setautoclose} SetAutoClose
|
|
|
|
\c true|false
|
|
|
|
Overrides the default auto window-closing flag (specified for the installer using AutoCloseWindow, and false for the uninstaller). Specify 'true' to have the install window immediately disappear after the install has completed, or 'false' to make it require a manual close.
|
|
|
|
\S2{setbrandingimage} SetBrandingImage
|
|
|
|
\c [/IMGID=item_id_in_dialog] [/RESIZETOFIT] path_to_bitmap_file.bmp
|
|
|
|
Sets the current bitmap file displayed as the branding image. If no IMGID is specified, the first image control found will be used, or the image control created by AddBrandingImage. Note that this bitmap must be present on the user's machine. Use File first to put it there. If /RESIZETOFIT is specified the image will be automatically resized (very poorly) to the image control size. If you used AddBrandingImage you can get this size, by compiling your script and watching for AddBrandingImage output, it will tell you the size. SetBrandingImage will not work when called from .onInit!
|
|
|
|
\S2{setdetailsview} SetDetailsView
|
|
|
|
\c show|hide
|
|
|
|
Shows or hides the details, depending on which parameter you pass. Overrides the default details view, which is set via ShowInstDetails
|
|
|
|
\S2{setdetailsprint} SetDetailsPrint
|
|
|
|
\c none|listonly|textonly|both|lastused
|
|
|
|
Sets mode at which commands print their status. None has commands be quiet, listonly has status text only added to the listbox, textonly has status text only printed to the status bar, and both enables both (the default). For extracting many small files, textonly is recommended (especially on win9x with smooth scrolling enabled).
|
|
|
|
\S2{setstaticbkcolor} SetStaticBkColor
|
|
|
|
\c hwnd color
|
|
|
|
Sets a background color for a static control. Use GetDlgItem to get the handle (HWND) of the static control.
|
|
|
|
\S2{setwindowlong} SetWindowLong
|
|
|
|
\c hwnd index new_long
|
|
|
|
Same as \W{http://msdn.microsoft.com/library/en-us/winui/winui/windowsuserinterface/windowing/windowclasses/windowclassreference/windowclassfunctions/setwindowlong.asp}{Windows SetWindowLong}.
|
|
|
|
\S2{showwindow} ShowWindow
|
|
|
|
\c hwnd show_state
|
|
|
|
Sets the visibilty of a window. Possible show_states are the same as \W{http://msdn.microsoft.com/library/en-us/winui/winui/windowsuserinterface/windowing/windows/windowreference/windowfunctions/showwindow.asp}{Widnows ShowWindow} function. SW_* are defined in \W{../Include/WinMessages.NSH}{Include\\WinMessages.NSH}. |