Sie sind auf Seite 1von 115

Versi on 2.

0
Jun 15, 2009
www.pantaray.com Pantaray Research LTD.
Qetup
!nsta""ation uite
#anua" $or %ersion 10.0
2
Table of Contents
General ............................................................................................................................ 6
Components ............................................................................................................... 6
Composer.exe ............................................................................................................ 7
Command Line Parameters ........................................................................................ 8
Help ............................................................................................................................ 9
Project ........................................................................................................................... 10
Project Definition ....................................................................................................... 10
Create Split Setup ..................................................................................................... 11
on S!" !iles ........................................................................................................... 1#
Lan$ua$e Support .................................................................................................... 1%
Setup &ill 'xpire ....................................................................................................... 1(
Span CDs ................................................................................................................. 1(
De)u$ ....................................................................................................................... 1*
Compression Le+el ................................................................................................... 1*
Si$n Code ................................................................................................................. 1*
Display ........................................................................................................................... 16
Setup ,ac-$round .................................................................................................... 16
Setup Dialo$ ............................................................................................................. 17
.usic !ile ame ....................................................................................................... 18
Files ............................................................................................................................... 20
Definitions ................................................................................................................. #0
/DD .......................................................................................................................... ##
.0SC'LL/'12S ................................................................................................. #6
3e$ister /s ............................................................................................................... #7
!ile /ttri)utes ............................................................................................................ #8
'xclude !rom ............................................................................................................ #8
1+er4rite !ile ............................................................................................................ #9
5ool5ip ...................................................................................................................... #9
.odif6 Dri+e 5o ......................................................................................................... #9
!ind 7 3eplace ......................................................................................................... %0
!ind ........................................................................................................................... %0
Pat8 /lias .................................................................................................................. %0
Dialogs .......................................................................................................................... 32
&elcome Dialo$ ........................................................................................................ %%
2ser 0nformation Dialo$ ............................................................................................ %%
C8ec-in$ for Serial um)er ...................................................................................... %(
5o-eni9ed Serial um)er .......................................................................................... %*
Setup 56pe Dialo$ .................................................................................................... %6
Cop6 !iles Dialo$ ...................................................................................................... %6
Complete Dialo$ ....................................................................................................... %7
Serial C8ec- DLL !ile ............................................................................................... %7
Switches ........................................................................................................................ 40
1peratin$ S6stems ................................................................................................... (0
3e$ister as /pplication ............................................................................................. (0
Ta&"e o$ 'ontents (
3e$ister project in t8e H:L.;Soft4are )ranc8 ......................................................... (0
Create Setup.lo$ !ile ................................................................................................ (1
'xtract !iles .............................................................................................................. (1
Pre+ious 0nstallation .................................................................................................. (1
3unnin$ 'xecuta)le .................................................................................................. (#
3un<3un1nce ........................................................................................................... (#
5 < #000 < "P < #00% < =ista ..................................................................................... (#
1+er4rite !iles .......................................................................................................... (%
/utorun ..................................................................................................................... (%
.'5 !rame4or- ....................................................................................................... ((
Shortcuts ....................................................................................................................... 45
Start<Pro$ram .enu S8ortcut ................................................................................... (*
1t8er Start<Pro$ram S8ortcut 0tems .......................................................................... (6
1t8er S8ortcuts ......................................................................................................... (7
Lan$ua$e Support .................................................................................................... (7
S8ortcuts are /+aila)le for ........................................................................................ (7
2n0nstall .................................................................................................................... (8
ssociate ...................................................................................................................... 4!
1pen &it8 ................................................................................................................. *0
"egistry ......................................................................................................................... 51
/dd 3e$istr6 0tem ..................................................................................................... *1
0mport 3e$ !ile ......................................................................................................... *#
0nstall 3e$ !ile .......................................................................................................... *#
#niFile ............................................................................................................................. 53
/dd 0ni!ile 0tem ......................................................................................................... *%
$n%iron&ent .................................................................................................................. 54
/dd 'n+ironment =aria)le ........................................................................................ *(
=aria)le 'xpansion ................................................................................................... *(
5 +s 9" ................................................................................................................... *(
Properties ...................................................................................................................... 55
=ersion 0nfo ............................................................................................................... **
0con ........................................................................................................................... **
$'ecute $ngine ............................................................................................................. 56
/dd 'xecute 0tem ...................................................................................................... *6
5est ........................................................................................................................... *6
Ser+ice !iles ............................................................................................................. *7
'xecution DLL !ile .................................................................................................... *7
(ill)oar* ........................................................................................................................ 5+
>eneral ..................................................................................................................... *8
!rame ....................................................................................................................... *9
,ac-$round Color ..................................................................................................... 60
5ext !iles .................................................................................................................. 60
uto ,p*ate .................................................................................................................. 61
58e Concept ............................................................................................................. 61
Ho4 Does it &or-? ................................................................................................... 61
5erms in 2se ............................................................................................................ 61
>eneral ..................................................................................................................... 6#
1ri$inal Setup .......................................................................................................... 6%
5ime to 2pdate ......................................................................................................... 6(
Ta&"e o$ 'ontents )
2pdate Setup ............................................................................................................ 6(
3unnin$ t8e /uto2pdate /$ent ................................................................................ 66
/d+anced /uto 2pdate ............................................................................................. 67
/uto 0nform ............................................................................................................... 67
-erge -o*ules ............................................................................................................. 6!
/dd .er$e .odule .................................................................................................... 69
1ptions ..................................................................................................................... 69
Set Parameters ......................................................................................................... 70
5est ........................................................................................................................... 70
,n#nstall ........................................................................................................................ .1
Create 2n0nstall ........................................................................................................ 71
2n0nstall S8ortcut ...................................................................................................... 7#
/dd<3emo+e Pro$rams ............................................................................................. 7#
Directories .................................................................................................................... .3
@3un5imeDirABC ....................................................................................................... 7(
liases ........................................................................................................................... .6
-S# ................................................................................................................................. .+
&86 .S0? ................................................................................................................. 78
Producin$ an .S0 file ................................................................................................ 78
.S0 +s '"' ............................................................................................................... 79
.issin$ !eatures ....................................................................................................... 79
ppen*i'es / ................................................................................................................. +1
**0,p*ate $'ecution #te& ........................................................................................ +1
0tem ameD............................................................................................................ 81
Perform /tD............................................................................................................ 81
0tem 56peD............................................................................................................. 8#
1nline Help........................................................................................................... 8#
Conditions............................................................................................................. 8#
Stop</nd<1r<"or.................................................................................................... 8(
'xecutions............................................................................................................. 8*
5H'.................................................................................................................... 88
'LS'..................................................................................................................... 88
ext 7 Pre+........................................................................................................... 88
Cop6...................................................................................................................... 88
Paste..................................................................................................................... 88
=aria)le 'xamplesD............................................................................................... 90
C1.P/30> =aria)les........................................................................................ 90
Command Line Parameters................................................................................... 91
1hec2 Depen*ency ..................................................................................................... !3
Static C8ec-.......................................................................................................... 9%
D6namic C8ec-..................................................................................................... 9%
*%ance* uto ,p*ate ............................................................................................... !5
58e Concept ............................................................................................................ 9*
'sta)lis8in$ a Communication C8annel ................................................................... 9*
.essa$e Structure .......................................................................................... 97
0nstructions<3eEuests !rom /pplication to /$ent ..................................................... 97
0nstructions<3eEuests from /$ent to /pplication .................................................... 100
F3P ,ploa* ................................................................................................................ 103
Ta&"e o$ 'ontents 5
Connection DataD .................................................................................................... 10%
!iles to 2ploadD ....................................................................................................... 10%
2pload .................................................................................................................... 10%
**ing new language to 4Setup .............................................................................. 104
5ow to co&pile the sa&ples using 6isual (asic7 .................................................. 10.
1usto& Dialogs ......................................................................................................... 10+
Custom Dialo$s Desi$ner ....................................................................................... 108
Dialo$s /rea ........................................................................................................... 108
Controls /rea .......................................................................................................... 109
Pre+ie4F ,utton................................................................................................... 111
,idi 5est C8ec-,ox............................................................................................. 111
Sa+e ,utton......................................................................................................... 11#
5ools ,utton........................................................................................................ 11#
Special Controls.................................................................................................. 11%
0nteractin$ 4it8 t8e Custom Dialo$ .......................................................................... 11%
1nClic-................................................................................................................ 11%
,efore</fter Dialo$.............................................................................................. 11(
3ead<&rite Control Properties............................................................................. 11(
*
General
GSetup from HPantara6 3esearc8 L5D.HI is toda6Js most effecti+e and po4erful setup
pro$ram.
GSetup is desi$ned to let 6ou create 8i$8 Eualit6 sop8isticated installation deli+er6 4it8
minimum effort and no script pro$rammin$.
GSetup features userKfriendl6 and intuiti+e interfaceI t8at 4ill 8elp 6ou create solid 7
dependa)le installations in a +er6 s8ort period of time.
GSetup 4ill produce a sin$le Self 'xtract installation file t8at can )e easil6 do4nloaded from
t8e 0nternetI distri)uted on a CD or placed on a central !ile Ser+er.
GSetup can also create Split SetupI 48ere 6ou suppl6 6our customers 4it8 a small Setup
:ernel t8at 4ill do4nload t8e rest of t8e setup file from t8e 0nternet.
GSetup is uni8ue in its a)ilit6 to create setup t8at 4ill uto ,p*ate from t8e 0nternetI 48en
a ne4 +ersion of t8e pro$ram is a+aila)le.
Components
58e pro$ram includes % major componentsD
1o&poser.e'e 58e compilin$ pro$ram t8at creates t8e installation deli+er6 file.
$ngine.e'e 58e pro$ram t8at 4ill run on 6our customerJs computer to perform t8e
actual 0nstallation 7 2n0nstallation.
Stu).e'e 58e Self 'xtract -ernel.
Lou 4ill onl6 use directl6 t8e Composer pro$ram. 58e ot8er components 4ill )e added
automaticall6 to t8e 0nstallation deli+er6 )6 t8e Composer.
+enera" ,
Composer.exe
58e Composer is t8e pro$ram t8at creates t8e installation deli+er6 file K also 2nown as
.edia file or Setup file.
Page (uttons
1n t8e 5op<3i$8t side of t8e Composer screen 6ou 4ill find t8e follo4in$ )uttonsD
ProjectI !ilesI Displa6I Dialo$sI S4itc8esI S8ortcutsI /ssociateI 3e$istr6I 0ni!ileI
'n+ironmentI PropertiesI 'xecuteI ,ill)oardI /uto 2pdateI .er$e .odulesI 2n0nstall
and /)out.
&8en e+er 6ou clic- one of t8ese )uttonsI t8e 5op<Left area of t8e composer screen
4ill c8an$e its content to reflect t8e selection 6ou made.
&8en 6ou start a ne4 0nstallation project $o t8rou$8 all t8e pa$es in t8e order of t8e
)uttons and fill t8e reEuired items in e+er6 pa$e.
-e"p Too"s...
Pa.e /uttons
Per$orm
/uttons
#! 0 121
e"ection
+enera" 3
Per9or& (uttons
1n t8e ,ottom<3i$8t side of t8e Composer screen 6ou 4ill find t8e follo4in$ )uttonsD
Sa+eI Pre+ie4I CompileI 2pload and 3un.
Sa%e K &8ene+er 6ou c8an$e an6 data t8is )utton 4ill )ecome acti+eI press t8is
)utton to sa+e t8e data.
Pre%iew K Press t8is )utton to see 48at 6our customers 4ill see durin$ t8e
installation. 58is is just a +isual testI no actual installation 4ill )e performed on 6our
computer.
1o&pile K &8en 6ou press t8is )utton t8e Composer 4ill create t8e actual
distri)ution file M.edia !ileN 6ou 4ill send to 6our customers.
,ploa* K 2se t8is )utton to 2pload 6our setup deli+er6 to t8e 0nternet usin$ !5P
protocol.
"un K &8en 6ou press t8is )utton t8e Composer 4ill run t8e actual distri)ution file. 0f
reEuired t8e Composer 4ill compile t8e file )efore runnin$ it. &8en 6ou clic- t8is
)utton actual installation 4ill )e performed on 6our o4n computer.
-S#0$:$ Selection
1n t8e ,ottom<3i$8t corner of t8e Composer screen 6ou 4ill find a special selection
)ox. 2se t8is selection )ox to select .S0 setup file or traditional '"' setup file as 6our
tar$et setup compilation.
Command Line Parameters
;hen running the 1o&poser
&8en runnin$ t8e Composer 6ou can add t8e follo4in$ parameters on t8e command
lineD
!ile ame K 58e full pat8 of a GSP file name K t8is file 4ill )e loaded for editin$.
<Compile K Compile t8e current setup.
<Compile/2 K Compile t8e current /utoK2pdate setup.
<'xit K 'xit t8e Composer M4ill )e performed after Loadin$ and<or compilin$N.
#-P<"3=3 K if <'xit is specified and an error 8as occurred durin$ compilationI
t8e composer 4ill return 4it8 an 'xitCode of 1ne M1N ot8er4ise t8e 'xitCode 4ill )e
Oero M0N.
Lou can test t8e 'xitCode of t8e composer usin$ a )atc8 file similar to t8e
follo4in$D
@echo off
composer.exe /compile /exit
if ERRORLEVEL 1 goto _ERROR
if ERRORLEVEL 0 goto _NoError
:_ERROR
echo === ERROR ===
goto END
:_NoError
echo === No Error ===
goto END
:END
pase
+enera" 9
;hen running the setup
&8en runnin$ t8e Setup 6ou can add t8e follo4in$ parameters on t8e command lineD
<Silent K 58e Setup pro$ram 4ill run 4it8out inter+ention of t8e user.
<Hide K 58e Setup pro$ram 4ill run completel6 in t8e )ac-$roundI presentin$ no
dialo$ durin$ t8e process.
<0nstallDirPHDestination Director6H K Define t8e default Destination director6 for
t8e setup.
#-P<"3=3 K 0silent 7 0hi*e 4ill 8a+e no effect if t8e H2ser 0nformationH dialo$ is
selected.
6aria)les <n the 1o&&an* >ine
&8en runnin$ t8e Setup 6ou can define +aria)les on t8e command line.
58e s6ntax is similar to t8e follo4in$D
<Q=ar1RP1#%( <Q.6ameRPSo8n
58ere is no limit to t8e num)er of +aria)les 6ou can define in t8is 4a6.
58e +aria)les 6ou define 4ill later )e used )6 t8e H'xecute 'n$ineH.
Help
1n t8e ,ottom<Left side of t8e composer screenI 6ou 4ill find t8e QHelpR )utton.
Clic- t8is )utton to open a small Help area on t8e ,ottom<Left side of t8e composer
screen.
0f 6ou clic- t8is )utton once a$ain t8e 8elp area 4ill close.
Lou can c8an$e t8e si9e of t8e 8elp area )6 dra$$in$ t8e )ar on top of it.
58e content of t8e 8elp area 4ill c8an$e 48en 6ou select different pa$es.
5elp 3ools
Clic- t8e 5elp 3ools panel to open t8e HHelp 5ools .enuH.
Lou can also 3i$8tClic- t8e 8elp area to $et t8e same menu.
!rom t8e HHelp 5ools .enuH 6ou can perform t8e follo4in$ operationsD
Print K Send t8e current 8elp document to t8e printer.
Fin* K Searc8 for a 4ord or p8rase in t8e 8elp s6stem. Lou can perform a
searc8 on t8e current 8elp document or /LL t8e documents.
Show 5elp K ,6 selectin$ t8is option 6ou 4ill open t8e current 8elp document in
a separate 4indo4. 58e content of t8is 8elp 4indo4 4ill 15 c8an$e as 6ou
select different pa$es.
GSetup .anual MpdfN K /ll GSetup 8elp files are no4 a+aila)le for do4nload as
a sin$le PD! file.&8en 6ou select t8is optionI GSetup 4ill first open t8e PD!
from t8e internet. /t t8e same time it 4ill also do4nload it to 6our dis-. ext
time 6ou attempt to open t8e PD! GSetup 4ill open it from t8e local stora$eI
t8us 6ou can read t8is PD! also 48en 6ou are offline.
10
Project
/ project is t8e collection of data from 48ic8 t8e tar$et Setup pro$ram is produced )6 t8e
Composer pro$ram.
5o start a ne4 project K clic- t8e ?=ew Project...@ )utton.
Project Definition
Project na&e
>i+e 6our project a simple name t8at 4ill 8elp 6ou identif6 t8e current project.
'xamples can )e H&ord#000H or H'xcel97H.
Project Directory
58e project director6 is t8e place 48ere t8e output of t8e Composer pro$ram 4ill )e
placed. ,6 default t8e Composer pro$ram 4ill create a su)director6 4it8 t8e name of
t8e project startin$ from t8e HProjectsH su)director6 under t8e Composer pro$ram
director6.
-e*ia File =a&e
58is 4ill )e t8e name of t8e tar$et Setup output file Mt8e installation file 6ou 4ill deli+er
to 6our customersN. 58is file is created )6 t8e composer 48en 6ou press t8e ?1o&pile@
)utton Mlocated at t8e 3i$8t<,ottom of t8e composer screenN. 58is file 4ill )e placed in
t8e HProject Director6H.
1opy File 3o...
/fter 6ou compiled a .edia file 6ou can cop6 it to anot8er location )6 clic-in$ t8e
?1opy File 3o...@ )utton. Lou can perform t8e same operation )6 3i$8t Clic-in$ t8e
?1o&pile@ )utton and selectin$D HCop6 .edia 5o...H.
Progra& Descripti%e =a&e
58is is a descripti+e name t8at is normall6 composed of # or % 4ords Msome times
refers to as t8e HProduct ameHN.
58is name 4ill )e used )6 t8e Setup pro$ram 48en creatin$ s8ortcuts to 6our pro$ram
in t8e Start<Pro$ram menuI and ot8er places.
$'a&ple / H&ord for &indo4sH or Hetscape a+i$atorH.
Progra& 6ersion
'nter 8ere t8e +ersion of 6our pro$ram. 0f 6ou c8ec- t8e uto&atic c8ec- )oxI t8e
composer pro$ram 4ill constantl6 update t8is field )6 readin$ t8e +ersion stamp from
t8e pro$ramJs tar$et executa)le resource ta)le Mdefined in t8e !iles pa$eN. 58is field is
used durin$ installation to create some re$istr6 -e6s.
1o&pany =a&e
'nter 8ere t8e name of 6our compan6. 58is field is used durin$ installation to create
some re$istr6 -e6s.
='3L 0.P135/5
Lou must fill all t8e a)o+e mentioned data items M6N. GSetup is usin$ t8is information
48en constructin$ re$istr6 entries. 0f 6ou omit some or all of t8e itemsI 6our pro$ram
mi$8t not install properl6 under &indo4s.
Pro4ect 11
Project 5an*ling (uttons
=ew Project...
2se t8is )utton to create a ne4 Setup project.
<pen Project...
2se t8is )utton to open an existin$ project for editin$. >enerall6 it 4ill )e enou$8 to
select t8e existin$ project from t8e drop do4n list of Project ames.
,p*ate Project...
2se t8is )utton if 6ou 4ant to modif6 t8e HProject ameH and<or t8e HProject director6H.
Sa%e Project s...
2se t8is )utton to create a duplicate of t8e current project.
Create Split Setup
GSetup allo4s 6ou to create # t6pes of setup deli+er6D
1. "egular Setup K onl6 one Self 'xtract T.'"' file Mup to (>, si9eN.
2. Split Setup K one small :'3'L file MU170:,N and t8e rest of t8e data in anot8er
SPL05 file MT.SPL05N K no si9e limit.
58e idea )e8ind Split Setup is t8at t8e user run t8e :'3'L fileI and t8is file do4nloads
t8e rest of t8e data from t8e 0nternetI or from a central file ser+erI and t8en proceed 4it8
t8e setup process.
Downloa* ,">
'nter 8ere t8e 23L of 6our 4e)site. &8en runI t8e :'3'L 4ill do4nload t8e SPL05
file from t8e 4e)site usin$ H55P protocol.
0f 6our SPL05 file is stored in a su)director6 of t8e 4e)site add t8e name of t8e
su)director6 to t8e 23L.
'xampleD httpA00www.&icroso9t.co&0*ownloa*.
Lou can also specif6 8ere a director6 pat8. 58is option is useful if 6ou 4ant to store t8e
SPL05 file in a central file ser+er.
Force Downloa*
2suall6 48en t8e :'3'L starts it 4ill loo- for t8e SPL05 file in t8e same director6
48ere it 4as started from. 0f t8e file is found t8e :'3'L 4ill use itI if not t8e :'3'L
4ill loo- for t8e file in t8e specified HDo4nloadK23LH.
0f 6ou 4ant to instruct t8e :'3'L to al4a6s use t8e HDo4nloadK23LH c8ec- t8e
H!orce Do4nloadH C8ec-,ox.
Secret 3o2en
58e secret to-en is a means for added securit6. 0t is encr6pted and em)edded in )ot8
t8e :'3'L file and t8e SPL05 file. Setup 4ill onl6 ta-e place if t8e HSecret 5o-enH of
)ot8 files matc8es.
'nter 8ere an6 text 6ou 4ant.
#-P<"3=3 K for added securit6I t8e Secret 5o-en is stored in 6our re$istr6 K not t8e
GSP file.
Pro4ect 12
"e8uest 1on9ir&ation (e9ore Downloa*
0nstruct GSetup to displa6 a messa$e )ox reEuestin$ confirmation )efore do4nloadin$
t8e SPL05 file.
##S Ser%er
0f 6ou are 8ostin$ 6our 4e)site on an 00S ser+erI 6ou 4ill 8a+e to set some ne4 .0.'
t6pes for HSplit SetupH to 4or- properl6. !or more information $o to t8e follo4in$ pa$eD
444.pantara6.com<iis.8tml.
Non SFX Files
2suall6 GSetup creates a sin$le SelfK'xtract MS!"N file. 58is t6pe of setup deli+er6 is )est
suited for small setup files Mse+eral .,N t8at are usuall6 do4nloaded from t8e 0nternet.
Ho4e+er if 6ou attempt to create a lar$e setup deli+er6 Mtens or 8undreds of .,NI 6ou
4ould pro)a)l6 deli+er 6our setup on a CD.
!or performance reasonsI 48en creatin$ a lar$e CD Setup 4e recommend t8at 6ou
create a small S!" file t8at include onl6 small files and lea+e t8e lar$e files M2suall6
0ma$es 7 .o+iesN on t8e CD.
5o create suc8 a setupI 6ou onl6 need to mar- t8e lar$e files K on t8e H!ilesH pa$e K as
H'xcluded !rom S!" !ileH.
/ll t8e files mar-ed t8is 4a6 4ill not )e included in t8e S!" file.
Later 48en 6ou )urn 6our CD 6ou 4ill need to include t8ose files on t8e CD as 4ell.
58e files must )e located on t8e CD in t8e same director6 48ere t8e S!" file is locatedI or
in an6 su)director6 of t8is director6.
0.P135/5 K Lou must ma-e sure t8at all t8e Hon S!" !ilesH 8a+e uniEue names
Munless 6ou c8ec- t8e H,uild on S!" Director6 5reeH option K descri)ed laterN.
Directory 9or =on SF: Files
0f 6ou define t8is director6 t8en durin$ t8e Compile processI all t8e onKS!" files 4ill
)e copied to t8is director6.
,6 default t8is director6 4ill recei+e t8e name HonS!"H and 4ill )e located inside 6our
HProject Director6H.
1lear =on SF: Directory (e9ore 1o&pile
0f t8is option is c8ec-edI all t8e files Mand directoriesN located in t8e HonS!"H director6
4ill )e erased )efore compilation.
(uil* =on SF: Directory 3ree
0f t8is option is c8ec-edI t8en K durin$ compilation K GSetup 4ill attempt to )uild inside
t8e HonS!"H director6 a ne4 director6 tree t8at 4ill loo- li-e t8e director6 tree 6our
setup 4ill )uild on t8e tar$et PC durin$ setup. /lso durin$ compilation GSetup 4ill
place e+er6 on S!" file inside its desi$nated director6. Later on 48en 6ou )urn 6our
CD all t8at 6ou 8a+e to do is cop6 t8e C15'5 of t8e HonS!"H director6 M!iles 7
Su)DirectoriesN to t8e CD.
#-P<"3=3 K if 6our setup includes se+eral files 4it8 t8e same nameI t8e onl6 4a6 to
deli+er t8em as onS!" is )6 c8ec-in$ t8is option.
Pro4ect 1(
1o&press =on SF: Files
&8en t8is option is c8ec-edI all t8e onS!" files 4ill )e compressed durin$
compilation. 0f 6ou select t8is optionI 6ou must 15 allo4 6our customer to use t8e
HPartialH setup option MDescri)ed on t8e HDialo$sH pa$eN.
/ll compressed files 4ill 8a+e t8e extension H.A9H added to t8eir name.
P>$S$ =<3$
Compressin$ t8e onS!" files 4ill reduce t8e total si9e of files on t8e CDI 8o4e+er
t8is mi$8t complicate t8e setup process as files must )e 2nCompressed durin$
installation and t8en copied to t8e 5ar$et Director6.
Force 1opy01o&press =on SF: Files
GSetup 4ill cop6 and<or compress on S!" !iles to t8e on S!" Director6 onl6 if a file
modified since t8e last time it 4as copied. 0f 6ou 4ant to !orce t8e cop6<compress
operation C8ec- t8is C8ec-,ox. GSetup 4ill compare files )ased on t8eir time stamp.
Lanuae Support
GSetup includes a compre8ensi+e infrastructure for .ultilin$ual support. Currentl6 more
t8en %0 lan$ua$es are supported 4it8 more to come.
#-P<"3=3 K Lan$ua$e Support is 15 a+aila)le in t8e L05' =ersion.
Selection
C8ec- all t8e lan$ua$es 6ou 4ant 6our project to support.
Durin$ 0nstallation t8e Setup pro$ram 4ill select t8e reEuired lan$ua$e )ased on t8e
><1>$ information found in t8e operatin$ s6stem. 0f a matc8 is not foundI t8e Setup
pro$ram 4ill default to 'n$lis8.
0f 6ou c8ec- <=>B <=$ lan$ua$e t8is one 4ill )e t8e selected lan$ua$e K no c8ec-
performed.
**ing &ore languages
58e lan$ua$e support is )ased on a text file in t8e form of an 00 file. 58e files are
located in t8e su)director6 L/>.
0f 6ou 4ant to create 6our o4n L/>2/>' fileI 6ou must cop6 t8e H'n$lis8.ln$H file to
a ne4 file 4it8 a name li-e H!renc8.ln$H and t8en edit t8e ne4 file. Detailed instructions
can )e found in t8e file H0nstructions.txt H located in t8e L/> director6.
&it8 similar tec8niEues 6ou can also easil6 edit an existin$ lan$ua$e file.
>anguage Files on the ;e)
&e are 8ostin$ a special pa$e on our &e)SiteI 4ere 4e post +arious lan$ua$e files
t8at 4ere contri)uted )6 users of t8e pro$ramI to +isit t8is pa$e $o to
444.pantara6.com<lan$ua$e.8tml.
>anguage Selection Dialog
,6 defaultI Durin$ 0nstallationI GSetup 4ill select t8e reEuired lan$ua$e )ased on t8e
><1>$ information found in t8e operatin$ s6stem. 0f 6ou c8ec- t8e option HLan$ua$e
Selection Dialo$HI GSetup 4ill present to t8e end user a selection dialo$ 4ere 8e can
select t8e reEuired installation lan$ua$e. 58is dialo$ 4ill appear at t8e +er6 )e$innin$
of t8e installation Mjust after extractN.
Pro4ect 1)
**itional >anguage Support
GSetup pro+ides additional tools for a full lan$ua$e support. 2sin$ t8is dialo$ 6ou can
pro+ide t8e follo4in$ P'3 L/>2/>' informationD
License /$reement 5ext !ile.
3ead.e 5ext !ile B1
3ead.e 5ext !ile B#
Pro$ram Descripti+e ame
Compan6 ame
5op La)el
5op La)el #
,ottom La)el
2sin$ t8is dialo$ 6ou can pro+ide HLicense /$reementH and<or H3ead.eH files in
different lan$ua$es as 4ell as names and la)els.
/dd information onl6 for t8e lan$ua$es 6ou are interested in.
0f some fields are left unused GSetup 4ill use default +alues from t8e rele+ant
composer screen. !or instance if 6ou lea+e H3eadme 5ext !ile B1H empt6I GSetup 4ill
use t8e rele+ant information found on t8e HDialo$sH pa$e.
3esting >anguage Support
5o properel6 test 6our multilin$ual setup 6ou must adjust 6our operatin$ s6stem to t8e
lan$ua$e under test.
!or more info read t8e follo4in$ lin-D 444.pantara6.com<lan$ua$e.8tmlBtestin$.
Setup !ill "xpire
2se t8is option limit t8e time 6our setup 4ill )e functional.
Lou 8a+e # optionsD
Set a !0"'D date for expiration.
Set a num)er of da6s after 6ou compile t8e setup.
&8en t8is option is set and t8e expiration date 8as elapsedI 6our user 4ill not )e a)le to
run t8e S'52P P31>3/. an6 more.
Span CDs
,6 default GSetup 4ill produce a sin$le Self 'xtract file.
Sometimes t8e sin$le file mi$8t $ro4 too )i$ to fit on a sin$le CD or ot8er distri)ution
media.
2sin$ t8is option 6ou can split t8e sin$le file into se+eral files )ased on si9e.
C8ec- t8is option and set t8e maximum si9e of eac8 file Mfor CDs 4e recommend 6*0
.,N.
Lou can set 8ere an6 +alue also a fractional num)er li-e 1.( ., if 6ou 4ant to use
dis-ettes.
DonJt enter +alues smaller t8en 0.6 .,.
Pro&pting 9or =e't Dis2
&8en extractin$ filesI GSetup 4ill prompt t8e user for t8e next dis- onl6 if t8e dis- is
not found in t8e 1ri$in director6. 58an-s to t8is )e8a+iorI an 05 .ana$er can cop6 /LL
t8e CDs to one director6 and instruct all users to install from t8is director6 4it8out
promptin$ for t8e next dis-.
Pro4ect 15
Force Pro&pt
58is C8ec-,ox is +alid onl6 on t8e de+elopers station. 2sin$ t8is option t8e de+eloper
of t8e setup can $et a )etter feelin$ of t8e setup )e8a+ior e+en t8ou$8 all t8e setup
files are located in one director6.
(urning a 1D
LetJs sa6 6our H.edia !ile ameH isD H.6SetupHI and 6ou 8a+e c8ec-ed t8e option
HCreate /utorun.inf fileH on t8e HS4itc8esH pa$e.
/fter 6ou compile a SpanCDs setup 6ou 4ill 8a+e in t8e project director6 a list of files
similar to t8e follo4in$D
autorun.inf
.6Setup.exe
.6Setup.exe.001
.6Setup.exe.00#
.6Setup.exe.00%
&8en )urnin$ t8is sample 6ou 4ill need % CDs.
1n t8e first CD 6ou 4ill place t8e follo4in$ % filesD
autorun.inf
.6Setup.exe
.6Setup.exe.001
1n t8e second CD 6ou 4ill place t8e fileD .6Setup.exe.00#.
1n t8e t8ird CD 6ou 4ill place t8e fileD .6Setup.exe.00%.
56picall6 6our setup 4ill include 1 or more files 4it8 t8e extension .exe.00?.
Debu
58e HDe)u$H option is an important tool t8at 4ill 8elp 6ou 48en 6ou de+elop 6our setup.
&8en t8is option is c8ec-ed a special popup 4indo4 4ill open 48en 6ou run t8e setupI and a list
t8at descri)e t8e steps of t8e setup 4ill appear in t8is 4indo4.
<n this P1
&8en t8is option is c8ec-ed t8e HDe)u$H 4indo4 4ill popup onl6 on t8e PC on 48ic8 t8e setup is
)ein$ de+eloped. 58is is t8e recommended option.
<n e%ery P1
&8en t8is option is c8ec-ed t8e HDe)u$H 4indo4 4ill popup onl6 e+er6 PC.
Compression Le#el
&8en creatin$ t8e Setup fileI GSetup compress t8e file to reduce t8e total si9e of t8e file.
2sin$ t8is selection )ox 6ou can select amon$ se+eral le+els of compression.
58e )etter t8e compression t8e lon$er it 4ill ta-e to compress t8e file.
58e De9ault option pro+ides t8e )est compromise )et4een speed 7 compression.
Sin Code
&it8 t8e introduction of &in"P SP#I Si$nin$ 6our Setup file usin$ /ut8enticode
tec8nolo$6 )ecomes a real necessit6. /fter 6ou compile 6our setup and )efore 6ou upload
it to t8e 4e)I clic- t8e ?Sign 1o*e@ )utton to open t8e HSi$n CodeH dialo$ and si$n 6our
setup file.
Detailed explanation of t8e process can )e found atD 444.pantara6.com<si$ncode.8tml.
0.P135/5 K 58e HSi$n CodeH dialo$ is a+aila)le onl6 in t8e P31 =ersion.
1*
Displa$
0n t8is pa$e 6ou 4ill define 48at 6our customer 4ill see durin$ t8e installation process.
&8ile editin$ t8is pa$e 6ou can constantl6 clic- t8e QPre+ie4R )utton Mlocated at t8e
3i$8t<,ottom of t8e composer screenN to monitor t8e results.
Setup %ac&round
** Setup (ac2groun*
0f 6ou c8ec- t8is C8ec-)ox t8en a colored )ac-$round Mormall6 4it8 $radientN 4ill co+er
t8e entire screen durin$ installation.
3D Fra&e
C8ec- t8is option to add a standard %D &indo4s !rame around t8e Setup ,ac-$round.
3op >a)el
Durin$ installation t8e Setup pro$ram 4ill displa6 t8is la)el at t8e top of t8e screen.
2se t8is la)el to displa6 a descripti+e name of 6our pro$ram.
Lou can control t8e appearance of t8e la)el )6 selectin$D Side and t8e follo4in$ !ont
attri)utesD ameI Si9eI St6leI Color and Script.
#&portant K &8en selectin$ a font ma-e sure 6ou select a &indo4s >eneric font li-e
5a8omaI =erdanaI /rialI 5ime e4 3oman etc... Ho4e+er if t8e font 6ou selected is
not found on t8e tar$et mac8ineI t8e Setup pro$ram 4ill default to H/rialH.
** 6ersion
&8en t8is option is c8ec-edI t8e pro$ram +ersion Mas entered on t8e HProjectH pa$eN
4ill )e added to t8e H5op La)elH in smaller si9e fonts.
3op >a)el 2
Durin$ installation t8e Setup pro$ram 4ill displa6 t8is la)el at t8e top of t8e screen K just
under t8e H5op La)elH.
(otto& >a)el
Durin$ installation t8e Setup pro$ram 4ill displa6 t8is la)el at t8e )ottom of t8e screen.
2suall6 6ou 4ill use t8is la)el to displa6 Cop6ri$8t otice of 6our pro$ram.
Lou can control t8e appearance of t8e la)el )6 selectin$D Side and t8e follo4in$ !ont
attri)utesD ameI Si9eI St6leI Color and Script.
Clic- t8e c8aracters V and W to insert t8em in to t8e la)el 48ile editin$.
Design
Select an6 of t8e follo4in$ desi$nsD
>radient
Li$8t Source M3i$8tN
Li$8t Source MLeftN
&indmill M3i$8tN
&indmill MLeftN
Disp"ay 1,
"P ,ac-$round
3ectan$les M3i$8tN
3ectan$les MLeftN
3andom 3ectan$les M3i$8tN
3andom 3ectan$les MLeftN
1olors
2se t8ese color settin$s to define t8e colors of t8e )ac-$round.
58e function of eac8 color settin$s +ar6 accordin$ to t8e desi$n selected.
0f 6ou prefer a solid color )ac-$roundI unc8ec- t8e second C8ec-)ox.
(ac2groun* (it&ap File =a&e
Lou can add a )itmap ima$e to )e displa6ed on t8e )ac-$round durin$ installation.
58e ima$e must )e of a ,itmap t6pe MT.,.PN.
>ocation
Clic- t8e ?>ocation@ ,utton to define t8e location of t8e )itmap.
Select an6 of t8e follo4in$ locationsD
CenterI 5op<LeftI 5op<3i$8tI ,ottom<LeftI ,ottom<3i$8tI
5op<CenterI ,ottom<CenterI Left<CenterI 3i$8t<CenterI
'ntire Screen.
&8en 6ou select $ntire Screen t8e ima$e 4ill )e stretc8ed to co+er t8e entire screen.
2se t8e D" 7 DL +alues to s8ift t8e ima$e 8ori9ontall6 and +erticall6 from t8e ori$inal
location.
3ransparent
&8en 3ransparent is C8ec-ed t8e ima$e 4ill )e displa6ed as transparent. 58e
transparent color is al4a6s t8e first pixel on t8e )itmap. Please note t8at on most
,itmap t8e first pixel is t8e first on t8e )ottom lineI on some )itmaps t8e first pixel is t8e
first on t8e top line.
Setup Dialo
Style
GSetup can displa6 # t6pes of Setup dialo$sD
Classic
.odern
>ocation
Clic- t8e ?>ocation@ ,utton to define t8e location of t8e Setup Dialo$.
Select an6 of t8e follo4in$ locationsD
CenterI 5op<LeftI 5op<3i$8tI ,ottom<LeftI ,ottom<3i$8tI 5op<CenterI ,ottom<CenterI
Left<CenterI 3i$8t<Center.
2se t8e D" 7 DL +alues to s8ift t8e ima$e 8ori9ontall6 and +erticall6 from t8e ori$inal
location.
#&age File =a&e
58e setup dialo$ includes a small default ,itmap. Lou can replace t8is )itmap )6 selectin$
a ne4 one.
Disp"ay 13
58e recommended maximum si9e of t8e )itmap isD
ClassicD Hei$8tP#*6I &idt8P1#0.
.odernD Hei$8tP%07I &idt8P160.
58e ima$e must )e of a ,itmap t6pe MT.,.PN.
Lou donJt need to add t8e )itmap file to t8e files listI t8e Composer 4ill add it
automaticall6.
3D Fra&e
C8ec- t8is c8ec-)ox to add a classic %D !rame around t8e ima$e M=alid onl6 for
Classic st6leN.
#&age File =a&e S&all
58is selection is +alid onl6 for .odern st6le.
2se t8is option to select a small ,.P file to )e added to man6 of t8e dialo$s in t8e
.odern st6le.
58e si9e of t8e ima$e must )eD Hei$8tP*#I &idt8P*#.
1lipart
Startin$ from +ersion 9.1.0.0 4e pro+ide a clipart of complimentar6 pairs of )itmaps.
2se t8is clipart to en8ance t8e displa6 of 6our setup.
1o&pany ,">
'nter 8ere t8e 23L of 6our Compan6Js &e)Site. 58is 23L 4ill appear on t8e ,ottom<Left
side of t8e Setup Dialo$. Clic-in$ t8is 23L 4ill open t8e )ro4ser 4it8 6our 4e)site.
Lou can direct t8e )ro4ser to anot8er 4e) pa$e )6 addin$ a | Mpipe si$nN and t8e tar$et
23L.
>ocation
23L 5extD 444.pantara6.com|8ttpD<<444.pantara6.com<Esetup.8tml
Displa6D 444.pantara6.com
&e)Pa$eD 8ttpD<<444.pantara6.com<Esetup.8tml
0.P135/5 K Compan6 23L is a+aila)le onl6 for t8e P31 and S52D01 +ersions.
'usic File Name
GSetup 8as t8e a)ilit6 to pla6 music durin$ t8e setup process.
C8ec- t8is C8ec-,ox and specif6 a &/=' file or a .0D0 file. MT.&/= T..0DN.
58e music 4ill pla6 durin$ t8e HCop6 !ilesH sta$e of t8e installation.
>oops
Specif6 8ere 8o4 man6 times t8e .usic file 4ill repeat itself. Lou ma6 specif6 $n*less
for continues pal6.
1nce t8e HCop6 !ilesH sta$e is terminatedI t8e pla6)ac- 4ill terminate also no matter
8o4 man6 loops 6ou specified. MPlease remem)er t8at t8e actual installation time 4ill
+ar6 from PC to PCN.
Lou ma6 also specif6 8ere $ntire 3rac2 in t8is case t8e setup 4ill terminate onl6 after
t8e complete 4a+e file 8as pla6ed to its end.
Delay C-SD
!or a small setupI t8e time a+aila)le for t8e music to pla6 mi$8t )e too s8ort. Lou can
increase t8is time )6 addin$ a s8ort dela6 after e+er6 file cop6 operation durin$ t8e
HCop6 !ilesH sta$e.
Sli*er
C8ec- t8is C8ec-,ox to displa6 a Slidin$ =olume Control durin$ installation.
Disp"ay 19
58e Slider 8as # optional locations.
Fi'e* K 58e silder 4ill )e placed on t8e setup dialo$.
Floating K 58e slider can )e placed an648ere on screen. Clic- t8e ?>ocation@
)utton to determine t8e exact location.
20
Files
!n t8is pa$e 6ou 4ill define t8e collection of files t8at 6ou 4ill send to 6our customers in t8e
0nstallation deli+er6.
Definitions
pplication Fol*er
Define 8ere t8e ultimate tar$et director6 6ou su$$est 6our customers as t8e tar$et
installation director6 for 6our pro$ram.
58e H/pplication !olderH consists of t4o partsD
58e first part is a predefined root director6 li-e @Pro$ram!ilesDirC.
58e second part is t8e tar$et application director6 inside t8e predefined root
director6.
ormall6 6ou 4ill enter 8ere 6our compan6 name li-e =etscape.
5n6 optiona""y the name o$ the pro.ram in the $orm Netscape(Na#iator.
7sua""y your customers wi"" ha%e the option to se"ect another 6irectory 6urin. the
etup process.
1o&&on Fol*er
58e HCommon !olderH is usuall6 used 48en 6our compan6 supplies se+eral pro$rams
t8at must s8are common files li-e DLLs and Data)ase files.
58e HCommon !olderH consists of t4o partsD
58e first part is a predefined root director6I normall6 @Common!ilesDirC.
0n t8e second part 6ou 4ill normall6 enter 6our compan6 name.
Please =ote K Lour customers 4ill =<3 8a+e t8e option to select a different HCommon
!olderH director6 durin$ t8e Setup process.
u'iliary Fol*er
58e H/uxiliar6 !olderH is usuall6 used 48en 6ou 4ant to place files in some ot8er H&ell
:no4nH location li-e t8e !15S director6.
58e same rules t8at appl6 to t8e HCommon !olderH appl6 also to t8is folder.
Please =ote K Lour customers 4ill =<3 8a+e t8e option to select a different H/uxiliar6
!olderH director6 durin$ t8e Setup process.
Groups
/ll files &ust )e arran$ed in $roups so 6ou must create at least one $roup.
Lou add a >roup )6 clic-in$ t8e ?** Group@ )utton.
.ore t8en one $roup is reEuired if 6ou plan to offer 6our customers t8e option to select
H56picalHI HCompactH or HCustomH installation.
Groups are la)ele* with Green characters.
8i"es 21
Fol*ers
0nside a $roup all files &ust )e arran$ed in predefined folders.
Lou add a !older )6 clic-in$ t8e ?** Fol*er@ )utton.
Lou ma6 add t8e follo4in$ predefined folders to eac8 $roupD
@/pplication !olderC 58is is t8e director6 6ou defined as t8e /pplication
!older.
@Common !olderC 58is is t8e director6 6ou defined as t8e Common !older.
@/uxiliar6 !olderC 58is is t8e director6 6ou defined as t8e /uxiliar6 !older.
@&indo4s Director6C 58is is t8e &indo4s director6 as defined )6 t8e
operatin$ s6stem.
@S6stem Director6C 58is is t8e &indo4s;S6stem%# director6 as defined )6
t8e operatin$ s6stem.
@S6stem 16 Director6C 58is is t8e &indo4s;S6stem director6 as defined )6 t8e
operatin$ s6stem.
@!ontDirC 58is is t8e &indo4s;!onts director6 as defined )6 t8e
operatin$ s6stem.
@.6DocumentsDirC 58is is t8e H.6 DocumentsH director6 as defined )6 t8e
operatin$ s6stem.
@3un5imeDirA1..8C 2p to 8 H3un 5imeH directories. / detailed description of
t8ose directories can )e found atD HDirectoriesH.
&8en creatin$ ne4 !oldersI 6ou can also define t8e H1+er4rite !ilesH polic6 for eac8
folder indi+iduall6.
58e follo4in$ options are a+aila)leD
Setup De9ault K 2se t8e >lo)al settin$ as defined on t8e HS4itc8esH pa$e.
lways K 58e ne4 file 4ill al4a6s o+er4rite t8e old file.
;hen 9ile is =ewer or Sa&e K 58e ne4 file 4ill o+er4rite t8e old one onl6 if it is ne4er
or same.
;hen 9ile is =ewer K 58e ne4 file 4ill o+er4rite t8e old one onl6 if it is ne4er.
=e%er K 58e ne4 file 4ill ne+er o+er4rite t8e old one.
#&portant K 58e same !olders ma6 appear in se+eral different >roups.
Fol*ers are la)ele* with "e* characters.
Directories
Lou ma6 create in eac8 !older an6 com)ination of Directories and Su)directories.
58e +er6 same director6 tree 4ill )e created on t8e tar$et computer inside t8e tar$et
installation director6.
=ote / Directories are not a must K 6ou can add files directl6 inside !olders.
#&portant K 58e same Directories ma6 appear in se+eral different !olders.
,6 default all directories are mar-ed 4it8 (<>D (lac2 color.
0f later on 6ou set an6 attri)ute to t8is director6 its color 4ill c8an$r to (<>D (lue.
8i"es 22
)DD
** Group
Clic- t8e ?** Group...@ )utton to add a ne4 $roup to t8e setup.
'nter t8e $roup name.
C8ec- t8e H>roup .2S5 /l4a6s )e 0nstalledH C8ec-)ox if 6ou 4ant t8is $roup
to )e installed al4a6s.
C8ec- t8e H0nclude >roup in 5LP0C/L 0nstallationH C8ec-)ox if 6ou 4ant t8is
$roup to )e part of t8e 5LP0C/L installation.
C8ec- t8e H0nclude >roup in C1.P/C5 0nstallationH C8ec-)ox if 6ou 4ant t8is
$roup to )e part of t8e C1.P/C5 installation.
0f 6ou plan to offer 6our customers t8e option of C2S51. installationI 6ou ma6 enter
some descripti+e text in t8e HDescriptionH areaI t8is text 4ill 8elp 6our customers decide
if to install t8is $roup.
$'clusi%ity 3ag
2sin$ t8e H'xclusi+it6 5a$H 6ou can force t8e user to select onl6 one $roup out of
se+eral.
$:-P>$A
Lou plan distri)ute 6our soft4are to % countriesD 'n$landI !rance 7 >erman6.
Lou add to 6our soft4are % 8elp $roupsD
Help 'n$lis8.
Help !renc8.
Help >erman.
o4 6ou 4ant t8at if t8e user C8ec- one of t8e % t8e ot8ers 4ill )e automaticall6
2nC8ec-ed.
5o ac8ie+e t8is $oal do t8e follo4in$D
.ar- all % $roups 4it8 t8e same $'clusi%ity 3ag num)er Mfor instance
#%N.
C8ec- 1LL t8e HHelp 'n$lis8H >roup on t8e HC2S51. 0nstallation
Pa$eH.
o4 48en 6our customer 4ill C8ec- t8e HHelp !renc8H $roup or t8e HHelp
'n$lis8H $roup durin$ SetupI t8e HHelp 'n$lis8H $roup 4ill )e automaticall6
2nC8ec-ed.
#-P<"3=3
5o ma-e sure t8at one and onl6 one $roup is /L&/LS selected 6ou must set
t8e $'clusi%ity 3ag to a +alue $reater t8en 100.
#nclu*e Group in Setup )y Serial =u&)er le%el
/s pre+iousl6 explainedI $roups $i+es 6our customer t8e a)ilit6 to control t8e content of
t8e installation at setup time.
,6 selectin$ C1.P/C5 t8e user 4ill normall6 install a smaller su)set of t8e
entire setup.
,6 selectin$ C2S51. t8e user 4ill 8a+e a t8e option to manuall6 select 48at to
include in t8e actual setup.
58e #nclu*e Group in Setup )y Serial =u&)er le%el offers 6ou K t8e de+eloper K t8e
option to control 48at part of t8e setup 4ill )e installed on 6our customerJs computer
)ased on t8e Serial um)er 6ou pro+ide 8im.
8i"es 2(
5o ta-e ad+anta$e of t8is option do t8e follo4in$D
Decide 8o4 man6 0nstallation le+els 6ou 4ant to use Mupto 8 le+elsN.
C8ec- in eac8 $roup t8e le+els 6ou 4ant t8is $roup to )e included in.
0n t8e HDialo$sH pa$e 1hec2 t8e H2ser 0nformationH dialo$ and ,n1hec2 t8e
HSetup 56peH and HCustomH dialo$s.
&8en 6ou pro+ide a serial num)er to 6our customer ma-e sure 6ou pro+ide
8im<8er 4it8 a serial num)er t8at starts 4it8 a num)er M1..8N or a c8aracter
M/..HN accordin$ t8e le+el of installation 6ou are offerin$ 8im.
$:-P>$
Lets sa6 6our setup include ( $roupsD >roupK1I >roupK#I >roupK% and >roupK(.
Lou plan to 8a+e % le+els of installationD
Le+elK1 t8at includes t8e $roupsD >roupK1I >roupK#I >roupK% and >roupK(.
Le+elK# t8at includes t8e $roupsD >roupK1 and >roupK%.
Le+elK% t8at includes t8e $roupsD >roupK1 and >roupK(.
5o adjust t8is plan 6ou 4ill mar- t8e >roups a follo4sD
>roupK1 included in Le+elK1I Le+elK# and Le+elK%.
>roupK# included in Le+elK1 onl6.
>roupK% included in Le+elK1 and Le+elK#.
>roupK( included in Le+elK1 and Le+elK%
&8en pro+idin$ a Serial um)er to 6our customer use t8e follo4in$ samplesD
0f S1H is entitled to Le+elK1 Setup send 8im a Serial um)er li-eD 1*9%K7#8(
or :8'K(8DS.
0f ./3L is entitled to Le+elK# Setup send 8er a Serial um)er li-eD 2*9%K7#8(
or (:8'K(8DS.
0f D/=' is entitled to Le+elK% Setup send 8im a Serial um)er li-eD 3*9%K7#8(
or 1:8'K(8DS.
58e actual len$t8 and content of t8e serial num)er is not important. 58e onl6 t8in$ t8at
matters is t8e first c8aracter t8at must )e 1..+ or ..5.
58is sc8eme 4or-s for all t6pes of Serial um)ers t8at GSetup supports MDLL ,asedI
Predefined 7 5o-eni9edN.
5o learn more a)out Serial um)er clic- HDialo$sH.
Space "e8uire* on Dri%e CE(DA
,6 default GSetup 4ill calculate t8e space reEuired for e+er6 $roup on t8e tar$et
mac8ine and present it on t8e Custom dialo$.
Lou can manuall6 set a different +alue in t8is edit )ox.
** Fol*er
Clic- t8e ?** Fol*er...@ )utton to add a ne4 folder to t8e setup.
Select one of t8e ( predefined folders.
Define t8e H1+er4rite !ilesH le+el for t8e selected folder. 0f 6ou select t8e first
option MSetup DefaultN t8en t8e 1+er4rite le+el 4ill follo4 t8e $lo)al definition on
t8e ComposerJs Switches pa$e.
Define t8e H2n0nstall 3emo+e Polic6H of t8e folder. 3ead t8e next para$rap8
M/dd Director6N for explanations.
8i"es 2)
** Directory
Clic- t8e ?** Directory...@ )utton to add a ne4 director6 to t8e setup.
'nter t8e ne4 director6 name. Lou ma6 also select a name form t8e
Com)o,oxI if 6ou 4ant to duplicate one director6 in more t8en one $roup.
0f reEuired clic- t8e H!13C' 3emo+e Director6 Durin$ 2n0nstallH C8ec-)ox.
$'planation K Durin$ 2n0nstall t8e 2n0nstall pro$ram 4ill attempt to delete all
t8e files t8at t8e Setup pro$ram placed in t8e said director6. 0f t8e director6 is
empt6 t8e 2n0nstall pro$ram 4ill delete it. 0f t8e director6 is not empt6 )ecause
ot8er files 4ere added later to t8is director6I t8e director6 4ill not )e deleted.
0f t8e H!orce 3emo+e Director6 Durin$ 2n0nstallH is c8ec-edI t8e 2n0nstall
pro$ram 4ill D'L'5' all t8e files in t8is director6 and in all t8e su)directories
t8at are included in t8is director6I and t8en 3'.1=' t8is director6 completel6.
0f reEuired clic- t8e HD1J5 3emo+e Director6 /D 05S C15'5 Durin$
2n0nstallH C8ec-)ox.
$'planation K 0f a director6 is mar-ed 4it8 t8is optionI t8e 2n0nstall pro$ram 4ill
not remo+e it or an6 su)director6 t8at starts from t8is director6. /lso all t8e files
in t8is director6 and an6 su)director6 of t8is director6 4ill not )e erased.
0f reEuired clic- t8e HD1J5 3emo+e S2S5 Director6 Durin$ 2n0nstallH
C8ec-)ox.
$'planation K 0f a director6 is mar-ed 4it8 t8is optionI t8e 2n0nstall pro$ram 4ill
not remo+e t8is director6I 8o4e+er /LL t8e contents of t8is director6 M!iles 7
Su)DirectoriesN 4ill )e remo+edI
#&portant / 0t is 6our responsi)ilit6 to refrain from conflicts. / conflict ma6 arise
48en one director6 is mar-ed as H!13C' 3emo+eH and a su)director6 of it is
mar-ed as HD1J5 3emo+eH. 0n case of conflictI t8e H!13C' 3emo+eH 4ill
pre+ail.
0f 6ou c8ec- an6 of t8e a)o+e mentioned s4itc8es t8e name of t8e director6 4ill appear
in (lue color.
** Files
Clic- t8e ?** Files...@ )utton to add one or more files to t8e setup.
Select t8e files to add to eac8 of t8e !olders 6ou defined.
!iles ma6 )e added directl6 into a !older or inside Directories.
,6 default all files are mar-ed 4it8 (lac2 color.
** File 3ree
Clic- t8e ?** File 3ree...@ )utton to add tree of directories and t8e files included in
t8em to t8e setup.
Lou ma6 add a file tree to t8e setup files )6 selectin$ a certain director6 in 6our
computer. 58e result 4ill )e addin$ all t8e files and director6 structure t8at starts from
t8is director6.
,6 default all files are mar-ed 4it8 (lac2 color.
8i"es 25
>in2
2sin$ t8is option 6ou can instruct GSetup to lin- t8e content of a director6 to t8e setup
deli+er6.
Durin$ compilation GSetup 4ill scan t8e lin-ed director6 and add to t8e setup all t8e
files and<or su)directories t8at matc8es t8e lin- definition.
GSetup support % lin- optionsD
>in2 Files (y -as2...
3i$8tClic- t8e !iles 5ree=ie4 and select HLin-<Lin- !iles ,6 .as-...H.
58e pro$ram 4ill displa6 a special dialo$.
Clic- t8e ?(rowse...@ )utton and select a file.
58e pro$ram 4ill create a pat8 for a file in t8e form F.e't.
Durin$ compilation GSetup 4ill add all t8e files found in t8at director6 t8at matc8 t8e
specified extention.
>in2 ll Files...
3i$8tClic- t8e !iles 5ree=ie4 and select HLin-<Lin- /ll !iles...H.
58e pro$ram 4ill displa6 a special dialo$.
Clic- t8e ?(rowse...@ )utton and select a director6.
58e pro$ram 4ill create a pat8 for a file in t8e form F.F.
Durin$ compilation GSetup 4ill add all t8e files found in t8at director6.
>in2 Directory 3ree...
3i$8tClic- t8e !iles 5ree=ie4 and select HLin-<Lin- Director6 5ree...H.
58e pro$ram 4ill displa6 a special dialo$.
Clic- t8e ?(rowse...@ )utton and select a director6.
58e pro$ram 4ill create a pat8 for t8at director6.
Durin$ compilation GSetup 4ill add all t8e files and su)directories found in t8at
director6.
Durin$ Setup a simmilar director6 tree 4ill )e )uilt on t8e tar$et mac8ine.
8i"es 2*
'*SC"LL)N"+,S
1hec2 Depen*ency
&8en 6ou deli+er 6our pro$ram to a customer 6ou must ma-e sure 6ou also deli+er all
t8e DLLs and 1C"s files t8at 6our pro$ram depends on.
58e HC8ec- Dependenc6H option 4ill 8elp 6ou find out 48at DLLs and 1C"s are
reEuired.
/fter 6ou clic- t8e ?1hec2 Depen*ency...@ )utton t8e pro$ram 4ill c8ec- all t8e
rele+ant files in 6our pro$ram M.'"'I .DLL 7 .1C"NI and produce a list of all reEuired
files. Clic- ?** Files@ to add t8e ne4 files to 6our installation deli+er6. 58e files 4ill )e
added to t8e current director6I 6ou can t8en mo+e t8em to anot8er director6 usin$ Dra$
7 Drop.
Lou can also c8ec- dependenc6 for a sin$le file )6 3i$8t Clic-in$ t8is file.
!iles t8at 4ere added usin$ t8is option 4ill )e 2nderLined in t8e files +ie4.
HC8ec- Dependenc6H is especiall6 important if 6ou pro$ram 4it8 H=isual ,asicH.
!or more information Clic-D C8ec- Dependenc6.
Pre*e9ine* Directories G H"un3i&eDirIJK
4Setup includes a lon$ list of predefined directories li-e @Pro$ram !iles DirCI
@&inDirC and upto 8 directories 48ose location is found at runtime. / detailed
description of t8ose directories can )e found atD HDirectoriesH.
ormall6I predefined directories are used as tar$et startin$ directories for 6our
installation.
Drag G Drop
Lou can use Dra$ 7 Drop for t8e follo4in$ operationsD
Dra$ files from &indo4s 'xplorer to t8e Composer file tree area.
Dra$ a director6 tree from &indo4s 'xplorer to t8e Composer file tree area.
.o+e files 7 Directories inside t8e Setup file tree.
3arget $'ecuta)le
'nter in t8is field t8e name of t8e main executa)le file of 6our pro$ram.
2se t8e H,ro4seH )utton to select one of t8e files in t8e Composer file tree.
58is name 4ill )e used for t8e follo4in$ tas-sD
Create s8ortcutMsN to 6our application.
3e$ister 6our pro$ram as an H/pplicationH in t8e &indo4s 3e$istr6.
1ffer t8e user to launc8 t8e pro$ram at t8e end of t8e setup process.
=ote / 58e name must include relati+e pat8 and extension.
8i"es 2,
-eister )s
Share* 9ile
3e$isterin$ a file as a s8ared one started 4it8 t8e introduction of &indo4s 9*. 58e
idea 4as to re$ister s8ared DLLsI later on t8e concept e+ol+ed to include all t6pe of
files.
&8en re$isterin$ a file as s8ared t8e Setup pro$ram 4ill create a special entr6 for t8is
file in t8e follo4in$ 3e$istr6 -e6D
H:'LAL1C/LA./CH0';Soft4are;.icrosoft;&indo4s;Current=ersion;S8aredDLLs
0n t8is entr6 t8e Setup pro$ram 4ill create a counter and set it to 1'.
0f suc8 an entr6 alread6 exists t8e Setup pro$ram 4ill increment t8e counter.
&8en 2n0nstallin$ t8e application t8e 2n0nstall pro$ram 4ill decrement t8e counterI
and proceed to delete t8e file onl6 if t8e counter is set to O'31.
Lou 4ill normall6 use t8is option 1LL if 6ou install a file t8at mi$8t )e used )6 ot8er
applications.
<1:01<- Ser%er
/cti+e" files need to )e re$istered under &indo4s.
2suall6 6ou perform t8e re$istration manuall6 usin$ t8e command line pro$ram
3e$S+r%#.exe.
2se t8is option to instruct GSetup to perform t8is operation automaticall6 durin$
0nstallation.
=<3$ K 58is option is also a+aila)le from t8e H'xecuteH pa$e.
uto 3est <1:01<- Ser%er
5o )e a)le to )e re$istered as a Ser+er a DLL or 1C" must implement t8e
HDll3e$isterSer+erH function call. ,6 default GSetup 4ill c8ec- for e+er6 1C" or DLL if
t8is function call is implemented and 'na)le t8e <1:01<- Ser%er C8ec-,ox
accordin$l6.
5o disa)le t8is automatic test do t8e follo4in$D
1. 3i$8tClic- t8e H!ilesH 5ree=ie4 pane.
#. Select t8e H3e$ister /sH menu.
%. Clic- t8e H/uto 5est 1C"<C1. Ser+erH menu.
3>(
56peLi)rar6 files need to )e re$istered under &indo4s.
2se t8is option to instruct GSetup to perform t8is operation automaticall6 durin$
0nstallation.
56peLi)rar6 files are files 4it8 t8e follo4in$ extensionsD T.5L,.
Font
!ont files need to )e re$istered under &indo4s.
2se t8is option to instruct GSetup to perform t8is operation automaticall6 durin$
0nstallation.
!ont files are files 4it8 t8e follo4in$ extensionsD T.55!I T.!1I T.!15I T.!5.
8i"es 23
.=$3 sse&)ly
Some .'5 /ssemlies M.dllN files need to )e re$istered under .'5.
2suall6 6ou perform t8e re$istration manuall6 usin$ t8e command line pro$ram
3e$/sm.exeI 48ic8 comes 4it8 t8e .'5 !rame4or- installation.
2se t8is option to instruct GSetup to perform t8is operation automaticall6 durin$
0nstallation.
File )ttributes
ormall6 48en GSetup copies files durin$ installation it clears all attri)utes of t8e copied
files.
2se t8is option to set an6 com)ination of t8e follo4in$ attri)utesD
3ead 1nl6.
Hidden.
/rc8i+e.
S6stem.
=<3$ K '+er6 file t8at is mar-ed as 3ead1nl6 )6 t8e Setup pro$ramI &0LL ,'
3'.1='D durin$ 2n0nstall. files t8at 4ill )e mar-ed manuall6 )6 t8e user &0LL 15 ,'
3'.1='DI and t8e 2n0nstall pro$ram 4ill issue a correspondin$ messa$e.
"xclude From
GSetup can create setup deli+er6 t8at 4ill update automaticall6 from t8e 0nternet. 5o learn
more a)out t8is concept $o to t8e H/uto 2pdateH pa$e.
"egular Setup
/n6 file or director6 mar-ed 4it8 t8is C8ec-,ox 4ill 15 )e included in a 3e$ular Setup.
uto ,p*ate
/n6 file or director6 mar-ed 4it8 t8is C8ec-,ox 4ill 15 )e included in an /uto 2pdate
Setup.
,n#nstall
/n6 file mar-ed 4it8 t8is C8ec-,ox 4ill 15 )e 2n0nstalled durin$ t8e 2n0nstall process.
Lou must also ma-e sure t8at an6 of t8e directories t8is file is included in is 15 mar-ed
asD
LF<"1$ "e&o%e Directory During ,n#nstallL.
!5M !+M -$M =3M 2EM :PM 2E3M 6ista
/n6 file or director6 mar-ed 4it8 an6 of t8ese C8ec-,oxes 4ill 15 )e installed 48en
installation is carried out on t8e rele+ant operatin$ s6stem.
SF: File
/n6 file or director6 mar-ed 4it8 t8is C8ec-,ox 4ill 15 )e included in t8e Self 'xtract
MS!"N file produced durin$ compilation. !or more information on =on SF: !iles $oto t8e
HProjectH pa$e.
?1lr ll@ Clic- t8is )utton to clear all H'xclude !rom S!" !ileH mar-s in 6our project.
Partial Setup
H'xclude !rom Partial SetupH is onl6 rele+ant if 6ou create a Setup on CDI and mar- t8e
HSetup 56peH option in t8e HDialo$sH pa$e as HCD SetupH. !or more information on HCD
SetupH $oto t8e HDialo$sH pa$e.
/n6 file or director6 mar-ed 4it8 t8is option 4ill 15 )e included in t8e HPartial SetupH
48en t8e user selects t8is option durin$ installation.
H'xclude !rom Partial SetupH is onl6 rele+ant for files t8at are mar-ed as H'xclude !rom
S!" !ileH.
8i"es 29
#-P<"3=3
&8en 6ou mar- a director6 4it8 an6 of t8e a)o+e mentioned s4itc8esI t8is settin$ 4ill
influence also t8e content M!iles and Su)DirectoriesN of t8is director6
+#er.rite File
2sin$ t8is option 6ou can decide 48at t8e setup pro$ram 4ill do 48en an old file is a)out
to )e replaced )6 a ne4 one.
58e follo4in$ options are a+aila)leD
Fol*er De9ault K 2se t8e settin$ as defined for t8e current folder.
lways K 58e ne4 file 4ill al4a6s o+er4rite t8e old file.
File is Sa&e or =ewer K 58e ne4 file 4ill o+er4rite t8e old one onl6 if it is ne4er
or same.
File is =ewer K 58e ne4 file 4ill o+er4rite t8e old one onl6 if it is ne4er.
=e%er K 58e ne4 file 4ill ne+er o+er4rite t8e old one.
#-P<"3=3
58e H1+er4rite !ileH polic6 ma6 )e defined in % placesD
1. Per !ile.
#. Per !older.
%. / $lo)al definition on t8e HS4itc8esH pa$e.
HPer !ileH 8as first priorit6.
0f HPer !ileH is set to H!older DefaultH t8en HPer !olderH is used.
0f HPer !olderH is set to HSetup DefaultH t8en t8e H>lo)alH definition is used.
ToolTip
ormall6 all files and directories in t8e 5ree=ie4 displa6 4ill )e la)eled in (>1E color.
'+er6 file or director6 t8at 8as an6 of its attri)ute set 4ill )e la)eled 4it8 (>,$ color.
'+er6 file t8at 4as added to t8e list usin$ t8e HDependenc6 C8ec-H mec8anism 4ill )e
la)eled 4it8 "$D color.
&8en 6ou mo+e t8e mouse pointer o+er a (>,$ or "$D la)eled file or director6I a tooltip
4ill appear under t8e mouse pointer. 58is tooltip 4ill include a list of all t8e attri)utes t8at
4ere set for t8is file or director6.
'odif$ Dri#e To
58is option is useful 48en 6ou need to mo+e 6our source files to anot8er dri+e.
Perform t8e follo4in$ seEuence of operationsD
Hi$8li$8t all t8e files 6ou 4ant t8eir dri+e to )e modified.
3i$8tClic- one of t8e selected files.
Clic- t8e H.odif6 Dri+e 5oH item in t8e menu.
Select t8e ne4 dri+e.
/ll t8e selected files 4ill 8a+e t8eir dri+e modified accordin$l6.
#-P<"3=3
/ll t8e selected files must reside on t8e same dri+e.
58e pro$ram 4ill not c8ec- if t8e files are actuall6 a+aila)le on t8e ne4 dri+e.
8i"es (0
Find / -eplace
58is option is useful 48en 6ou need to modif6 t8e P/5H of 6our source files.
5o open t8e H!ind 7 3eplaceH dialo$I 3i$8tClic- t8e !iles 5ree=ie4 and select H!ind 7
3eplaceH.
'nter t8e Pat8 to !ind in t8e first 'dit,ox.
'nter t8e 3eplacement in t8e second 'dit,ox.
Clic- t8e ?"eplace@ )utton.
Lou can set t8e Scope of files to )e modified )6 selectin$D
>lo)al.
Selected Lines.
Current Line.
Lou can define 48at lines 4ill )e replacedD
/l4a6s K 3eplace all lines t8at matc8es t8e HPat8 to !indH definition.
1nl6 48en ne4 file exists K 58e line 4ill )e replaced onl6 if actual file exists in t8e
ne4 pat8.
,n*o
2se t8e ?,n*o@ )utton to restore t8e files to its status )efore t8e replacement.
'+er6 clic- 4ill ta-e 6ou one step )ac-.
58e undo option is +alid onl6 as lon$ as 6ou did not close t8e H!ind 7 3eplaceH dialo$.
Find
58is option is useful 48en 6ou need to searc8 for a speciifc file or pat8 in t8e files list.
5o open t8e H!indH dialo$I 3i$8tClic- t8e !iles 5ree=ie4 and select H!indH.
Pat0 )lias
58e Pat8 /lias concept 4ill 8elp 6ou 48en 6ou need to pro+ide a setup 4it8 similar
structure )ut different set of filesI or 48en 6ou constantl6 need to mo+e 6our de+elopment
en+ironment amon$ se+eral computers in 6our net4or-.
5o use t8e HPat8 /liasH option C8ec- t8e Path lias C8ec-,ox at t8e )ottom<ri$8t of t8e
H!ilesH pa$e.
&8en HPat8 /liasH is c8ec-ed a special Panel 4ill appear at t8e )ottom of t8e H!ilesH
pa$e.
1n t8is panel 6ou 4ill find % Com)o,oxes mar-ed as HP35I1KI HP35I2K 7
HP35I3K.
0n eac8 Com)o,ox 6ou can set a different director6 pat8 usin$ t8e Q/dd...R )utton.
o4 6ou can enter t8e alias HP35I1K into an6 pat8 of 6our source files and at Compile
time t8is alias 4ill )e replaced 4it8 t8e content of t8e HP35I1K Com)o,ox.
$:-P>$
LetJs sa6 t8at 6our project include t8e follo4in$ # filesD HSimple5est.exeH 7 HSer+ice.dllH.
Lou alternati+el6 de+elop 6our project from 8ome and from t8e office.
8i"es (1
/t 8ome t8e files are located atD
CD;Pro$rams;5est;Simple5est.exe
CD;Pro$rams;5est;Ser+ice.dll
0n t8e office t8e files are located atD
!D;De+elopment;5ools;5est;Simple5est.exe
!D;De+elopment;5ools;5est;Ser+ice.dll
5o ta-e ad+anta$e of t8e Path lias optionI 6ou 4ill set t8e pat8 to t8e # files as
follo4sD
@P/5HA1C;5est;Simple5est.exe
@P/5HA1C;5est;Ser+ice.dll
&8en 6ou are 4or-in$ from 8ome 6ou 4ill set HP35I1K toD HCD;Pro$ramsH.
&8en 6ou are 4or-in$ from t8e office 6ou 4ill set HP35I1K toD
H!D;De+elopment;5oolsH.
#-P<"3=3
58e onl6 4a6 to add @P/5HABC to an existin$ pat8 is )6 usin$ t8e H!ind 7 3eplaceH
option.
5o start H!ind 7 3eplaceHI 8i$8li$8t t8e rele+ant filesI 3i$8tClic- t8e files and select
H!ind 7 3eplaceH.
<ther Files
&8en creatin$ a setup 6ou mi$8t need to appl6 HPat8 /liasH also to t8e follo4in$ filesD
0ma$e 7 .usic files on t8e HDispla6H pa$e.
License 3eadme 7 0ma$e file on t8e HDialo$sH pa$e.
Ser+ice files on t8e H'xecuteH pa$e.
0ma$e 7 5ext files on t8e H,ill)oardH pa$e.
5o appl6 t8e proper HPat8 /liasH 6ou 4ill eit8er need to modif6 t8e text manuall6 or
8i$8li$8t t8e rele+ant lines in a List=ie4I 3i$8tClic- and select H!ind 7 3eplaceH.
(2
Dialos
58e Setup pro$ram is actuall6 a 4i9ard t8at contains se+eral dialo$sI 4it8 eac8 dialo$
8andlin$ anot8er aspect of t8e Setup process. 2se t8is pa$e to select 48at Dialo$s t8e user
4ill encounter durin$ t8e Setup process. 58e order of t8e Dialo$s in t8e list is also t8e order
of t8eir appearance.
Clic- t8e ?Show Dialog@ )utton to see t8e selected dialo$.
<r*er o9 Dialogs
58e order of t8e Dialo$s in t8e list is also t8e order of t8eir appearance in t8e Setup
pro$ram. Lou can c8an$e t8e order of t8e dialo$s )6 usin$ Dra$7Drop operation or )6
usin$ t8e /rro4 )uttons.
3i$8t Clic- t8e Dialo$s list and select "estore De9ault <r*er to restore t8e ori$inal
order of t8e dialo$s.
=ote / 0t is 6our responsi)ilit6 to ma-e sure t8at t8e ne4 order does ma-e senseI donJt
put t8e HDestinationH dialo$ after t8e HCop6 !ilesH dialo$ etc...
** #&age
Clic- t8is )utton to add a uniEue 0ma$e to t8e selected dialo$.
58e recommended maximum si9e of t8e )itmap isD
ClassicD Hei$8tP#*6I &idt8P1#0.
.odernD Hei$8tP%07I &idt8P160 for t8e Lar$e 0ma$e K Hei$8tP*#I &idt8P*#
for t8e Small 0ma$e.
58e ima$e must )e of a ,itmap t6pe MT.,.PN.
Lou can add t8e same ima$e to se+eral dialo$s.
Lou donJt need to add t8e )itmap file to t8e files listI t8e Composer 4ill add it
automaticall6.
"e&o%e #&age
Clic- t8is )utton to remo+e t8e ima$e from t8e selected dialo$.
58e selected dialo$ 4ill use t8e default ima$e as defined in t8e HDispla6H pa$e.
>icense gree&ent 3e't File
0f 6ou select t8e HLicenseH dialo$I 6ou must pro+ide text for t8is dialo$. 58e text must
)e supplied in t8e form of a pure /SC00 text file Mot 20C1D'N or 3ic85ext file M.35!N.
'nter 8ere t8e full pat8 of t8e source text file.
=ote K 0f 6ou 4ant t8is file to )e -ept on t8e tar$et computer after installationI 6ou must
add it to t8e installation files list also.
"ea*&e 3e't File J1
0f 6ou select t8e H3eadmeH dialo$I 6ou must pro+ide text for t8is dialo$. 58e text must
)e supplied in t8e form of a pure /SC00 text file Mot 20C1D'N or 3ic85ext file M.35!N.
'nter 8ere t8e full pat8 of t8e source text file.
=ote K 0f 6ou 4ant t8is file to )e -ept on t8e tar$et computer after installationI 6ou must
add it to t8e installation files list also.
Dia"o.s ((
"ea*&e 3e't File J2
0f 6ou select HPropose to Displa6 3eadme file B# after 0nstallationH 6ou must pro+ide
text for t8is dialo$. 58e text must )e supplied in t8e form of a pure /SC00 text file Mot
20C1D'N or 3ic85ext file M.35!N. 'nter 8ere t8e full pat8 of t8e source text file.
=ote K 0f 6ou 4ant t8is file to )e -ept on t8e tar$et computer after installationI 6ou must
add it to t8e installation files list also.
,se =otepa*
ormall6 GSetup 4ill displa6 3ead.e file B# in a 4indo4 of its o4n. Lou can
instruct GSetup to use otepad for t8is purpose )6 c8ec-in$ t8e H2se otepadH
c8ec-)ox. 0f t8e file 6ou are pro+idin$ is an 35! file t8en &ordPad or &in&ord 4ill
pro)a)l6 )e used.
Space "e8uire* on Dri%e C-(D
GSetup 4ill displa6 on t8e HDestinationH dialo$ t8e space reEuired on t8e destination
dri+e. GSetup calculates t8is data )6 readin$ t8e si9e of t8e files to )e installed. 0f 6our
installation also includes files t8at are copied usin$ commands from t8e H'xecutionH
Pa$eI t8en GSetup 4ill not )e a)le to calculate t8eir si9e. 0n suc8 a case 6ou 4ill 8a+e
to do t8e calculation manuall6. &8en enterin$ t8e data 6ou must set it in .e$a,6tes.
!elcome Dialo
Show reco&&en*ation to 1lose all Progra&s
.ost &indo4s setup pro$ramsI displa6s a recommendation to close all pro$rams
)efore proceedin$ 4it8 t8e 0nstallation process. &e )elie+e t8is is not al4a6s
necessar6I especiall6 not for simple installations. 0f 6ou feel t8is recommendation is
necessar6I C8ec- t8e Show reco&&en*ation to 1lose all Progra&s C8ec-)ox.
Show *ware Disclai&er
0f 6ou are usin$ /d+ertisement tec8nolo$6 o+er t8e 0nternetI C8ec- t8is option to )rin$
t8is fact to t8e attention of 6our customers.
Show 1opyright ;arning
/lmost all setup pro$rams displa6 a standard 1opyright ;arning on t8e &elcome
dialo$. Ho4e+er if 6our installation does not include cop6ri$8ted materialI 6ou can 8ide
t8is 4arnin$ )6 2nC8ec-in$ t8is option.
,ser *nformation Dialo
0n t8is dialo$ t8e user 4ill )e prompted to enter t8e follo4in$ dataD
2ser ame.
2ser Compan6 ame.
Soft4are Serial um)er.
58e information 4ill )e stored )6 t8e Setup pro$ram in t8e re$istr6 under t8e follo4in$
-e6D
H:'LAL1C/LA./CH0';Soft4are;@Compan6C;@/ppameC;@=ersionC
2sin$ t8e follo4in$ =alue amesD
ame.
Compan6.
Serial.
Dia"o.s ()
"e8uest ,ser =a&e
C8ec- t8is item so t8at t8e user 4ill )e prompted to enter 8is name durin$ installation.
"e8uest 1o&pany =a&e
C8ec- t8is item so t8at t8e user 4ill )e prompted to enter 8is compan6 name durin$
installation.
"e8uest Serial =u&)er
C8ec- t8is item so t8at t8e user 4ill )e prompted to enter t8e Serial num)er of t8e
soft4are durin$ installation.
=<3$ K /t least one of t8e % items must )e c8ec-ed.
-an*atory
'ac8 one of t8e a)o+e % items ma6 )e c8ec-ed as H.andator6H. &8en H.andator6H is
c8ec-ed t8e user 4ill 8a+e to enter a +alue in t8e rele+ant field )efore proceedin$.
Fro& P1 <nly
H2ser ameH and HCompan6 ameH ma6 )e c8ec-ed as H!rom PC 1nl6H.
&8en t8is option is c8ec-ed t8e rele+ant name 4ill )e read from t8e PC lea+in$ t8e
user no option to alter it durin$ t8e setup process.
C0ec&in for Serial Number
Lou 8a+e % options a+aila)le to c8ec- t8e +alidit6 of t8e Serial um)er entered )6 6our
customer.
1. Pro+ide a DLL t8at 4ill perform t8e c8ec-.
#. 'm)ed in 6our Setup pro$ram one or more predefined num)ers.
%. 5o-eni9ed serial num)er.
Serial 1hec2 D>> File
'nter 8ere t8e full pat8 of 6our DLL.
/ sample of t8e code reEuired for t8e DLL is found at t8e end of t8is 8elp pa$eI or in
t8e director6D Sa&pleD>>s located under t8e GSetup director6.
2se t8e ?3est D>>...@ )utton to test 6our DLL.
Pre*e9ine* Serial =u&)erCsD
0f 6ou select t8e option of predefined num)ersI 6ou can use an6 com)ination of
c8aractersI numeral and punctuation mar-s K except for t8e N mar-.
0f 6ou 4ant to enter more t8en one predefined num)er 6ou must use t8e N si$n as
delimiterD
t8e lineD a)c123Ntony2000N:J6.F K 4ill 6ield % serial num)ersD
1. a)c123
2. tony2000
3. :J6.F
#-P<"3=3 / !or added securit6 t8e Predefined num)ers are stored in 6our re$istr6I
not t8e GSP file.
Dia"o.s (5
To&eni1ed Serial Number
58e idea )e8ind t8is option is to pro+ide 6our customer 4it8 a serial num)er 48ic8 is
)ased on a secret 5o-en pro+ided )6 6ouI and a H2ser ameH and<or HCompan6 ameH
pro+ided )6 6our customer. 58is 4a6 6ou can pro+ide e+er6 one of 6our customers 4it8 a
uniEue HSerial um)erH.
Select t8is option and enter a to-en of se+eral c8aracters. .a-e sure 6ou -eep t8is to-en
in secret. Later on 48en a customer )u6s 6our soft4areI as- 8im to send 6ou K )6 'mail or
an6 ot8er means K 8is H2ser ameH and HCompan6 ameH.
&8en 6ou recei+e t8is informationI clic- t8e ?1reate...@ )utton to open t8e HCreate Serial
um)erH dialo$.
'nter in t8is dialo$ t8e H2ser ameH and HCompan6 ameH 6ou just recei+ed and clic-
?1reate Serial =o.@.
58e pro$ram 4ill create a uniEue serial num)er M,ased on t8e H2ser ameHI HCompan6
ameH and t8e 5o-enN.
Send t8e ne4 HSerial um)erH to 6our customer K )6 'mail or an6 ot8er means K so t8at
8e can complete t8e installation process.
&8en creatin$ a serial num)er 6ou can select t8e follo4in$ optionsD
Group >e%el
Select 8ere HLe+elK1H.. HLe+elK8H or HoKLe+elH.
!or more information on t8is option read a)out #nclu*e Group in Setup )y Serial
=u&)er le%el in t8e H!ilesH pa$e.
1haracters
Di$its 1nl6 K 58e num)er 4ill include 1LL di$its.
5ext 1nl6 K 58e num)er 4ill include 1LL 2ppercase 'n$lis8 c8aracters.
5ext X Di$its K 58e num)er 4ill include Di$its and 2ppercase 'n$lis8
c8aracters.
>ength
Set t8e len$t8 of t8e serial num)er M6 to %0 c8aractersN.
** 5yphens
0f t8is option is c8ec-ed t8en 86p8ens 4ill )e added to t8e serial num)er e+er6 % or (
c8aracters. H6p8ens are not counted in t8e >ength of t8e Serial um)er.
1ase Sensiti%e
0f t8is option is 15 c8ec-ed t8en t8e pro$ram 4ill i$nore t8e case 48en enterin$
H2ser ameH and HCompan6 ameH. &e recommend t8at 6ou lea+e t8is option
2nC8ec-ed.
1opy to 1lip)oar*
&8en t8is option is c8ec-ed t8en as 6ou clic- t8e ?1reate Serial =o.@ )uttonI t8e
pro$ram 4ill place t8e ne4l6 created Serial um)er in t8e clip)oard. >oto 6our 'mail
pro$ram and paste t8e ne4 num)er directl6 to t8e 'mail messa$e 6ou are a)out to
send to 6our customer.
#-P<"3=3
&8en 6ou create a serial num)er 6ou must use t8e S/.' 5o-en 6ou used
48en 6ou created t8e Setup deli+er6.
!or added securit6 t8e 5o-en is stored in 6our re$istr6I not t8e GSP file.
Dia"o.s (*
Setup T$pe Dialo
0n t8is dialo$ t8e user 4ill 8a+e t8e option to select one of #<% Setup 56pes.
56pical.
Compact.
Custom M1ptionalN.
Show 1o&pact Setup lso
C8ec- t8is C8ec-)ox if 6ou 4ant t8e user to 8a+e t8e option to perform Compact
installation.
=ote / !or t8is s4itc8 to )e rele+ant 6ou must mar- onl6 some of t8e >roups as
included in compact installation.
1D Setup
58is option is rele+ant if 6ou create a setup t8at 4ill )e distri)uted on a CD.
0f HCD SetupH is c8ec-edI t8e user 4ill 8a+e t8e option to select one of # Setup 56pesD
1o&plete K 58e entire pro$ram 4ill )e copied from t8e CD and installed on t8e
Hard Dis-.
Partial K 1nl6 some files 4ill )e copied from t8e CD to t8e Hard Dis- durin$
installation. 58e user 4ill 8a+e to insert t8e CD to t8e CDKDri+e e+er6 time 8e
runs t8e pro$ram. 58e files t8at are not copied are t8ose mar-ed as H'xclude
!rom Partial SetupH on t8e H!ilesH pa$e.
Force Partial setup
C8ec- t8is option if 6ou create a HCD SetupH and 6ou 4ant it to )e installed as HPartialH
K o Selection )6 t8e user.

Cop$ Files Dialo
58is dialo$ is for displa6 onl6. 0t 4ill s8o4 up durin$ t8e cop6 files sta$e of t8e installationI
and displa6 t8e names of t8e files and a pro$ress )ar t8at reflects t8e pro$ress of t8e
cop6 process.
0f 6ou define a ,ill)oard t8en t8is dialo$ 4ill )e replaced 4it8 a small pro$ress )ar at t8e
)ottom of t8e screen.
0f 6ou unc8ec- t8is dialo$I t8e cop6 process 4ill )e performed 4it8out t8e displa6 of t8is
dialo$I Mt8is option ma6 )e reasona)le if 6ou install +er6 fe4 filesN.
Show Progress (ar J2
2suall6 GSetup displa6s onl6 one pro$ress )ar durin$ t8e H!ile Cop6H process.
58is Pro$ress ,ar merel6 counts t8e files as t8e6 are copied.
Lou ma6 add anot8er Pro$ress ,ar )6 c8ec-in$ t8e Show Progress (ar J2 C8ec-,ox.
58e second Pro$ress ,ar is used for indication of t8e Cop6 Process of e+er6 indi+idual
file.
&e su$$est t8at 6ou add t8is Pro$ress ,ar onl6 if 6ou deli+er ='3L L/3>' files in 6our
setup.

Per9or& Silent Setup
&8en t8is option is c8ec-edI t8e Setup pro$ram 4ill run 4it8out inter+ention of t8e user.
58e Setup pro$ram 4ill s-ip all t8e first pa$esI $o strai$8t to t8e HCop6 !ilesH dialo$I
perform t8e installation and close.
Lou can ac8ie+e t8e same effect )6 unc8ec-in$ all t8e dialo$s except t8e HCop6 !ilesH
dialo$.
Lou can ac8ie+e t8e same effect )6 addin$ 0silent parameter on t8e commandKline of t8e
setup pro$ram.
Dia"o.s (,
$na)le 1ancel (utton
C8ec- t8is option if 6ou 4ant to $i+e t8e end user t8e option to a)ort a HSilent SetupH.
Per9or& 5i**en Setup
&8en t8is option is c8ec-edI t8e Setup pro$ram 4ill run completel6 in t8e )ac-$roundI
presentin$ no dialo$ durin$ t8e process.
Lou can ac8ie+e t8e same effect )6 addin$ 0hi*e parameter on t8e commandKline of t8e
setup pro$ram.
#-P<"3=3
0silent 7 0hi*e 4ill 8a+e no effect if t8e H2ser 0nformationH dialo$ is selected.
Complete Dialo
Propose to "estart the 1o&puter a9ter #nstallation
C8ec- t8is option if 6ou 4ant t8e user to restart 8is PC after 0nstallation. Setup 4ill as- t8e
user for confirmation.
F<"1$ K 0f t8is option is c8ec-edI setup 4ill al4a6s restart t8e PC K no Euestions
as-ed.
#-P<"3=3 K 0f setup fails to cop6 one or more filesI setup 4ill mar- t8em for later
cop6 and prompt t8e user to restart 8is PC K e+en if t8is c8ec-)ox is not c8ec-ed.
Propose to >aunch the pplication a9ter #nstallation
C8ec- t8is option if 6ou 4ant t8e user to launc8 t8e 5ar$et 'xecuta)le ri$8t after
0nstallation. Setup 4ill as- t8e user for confirmation.
15$1E$D K C8ec- t8is option to set t8e default status of t8e rele+ant c8ec-)ox to
chec2e*.
Propose to Display "ea*&e 9ile J2 a9ter #nstallation
C8ec- t8is option to displa6 a readme file after installation. Setup 4ill as- t8e user for
confirmation.
15$1E$D K C8ec- t8is option to set t8e default status of t8e rele+ant c8ec-)ox to chec2e*.
Serial C0ec& DLL File
0f 6ou 4ant 6our customers to enter a serial num)er durin$ installationI 6ou must pro+ide a
special DLL or H/cti+e" DLLH to c8ec- t8e +alidit6 of t8e entered serial num)er.
Sample code for t8e DLL can )e found in t8e director6 Sa&pleD>>s under t8e GSetup
director6.
58e DLL or H/cti+e" DLLH must export t4o functions 4it8 t8e follo4in$ protot6peD
C2C33 Code4
__!eclspec"!llexport# i$t __c!ecl %etDllVersio$"#
__!eclspec"!llexport# i$t __c!ecl %et&erialO'"()ND )$!* char+
&erial* char+ ,ser* char+ -ompa$.#
Pascal Code4
f$ctio$ %etDllVersio$: i$teger/ c!ecl/
f$ctio$ %et&erialO'")$!: ()ND/ &erial*,ser*-ompa$.: 0-har#:
i$teger/ c!ecl/
Dia"o.s (3
5isual %asic Code4
01lic 2$ctio$ %etDllVersio$"# 3s 4$teger
01lic 2$ctio$ %et&erialO'")$! 3s Lo$g* &erial 3s &tri$g* ,ser 3s
&tri$g* -ompa$. 3s &tri$g# 3s 4$teger
58e return +alue of t8e first function must )e 1.
58e return +alue of t8e second function must )e 0 if t8e test failed or 1 if t8e test
succeeded.
Sa&ple 101OO 1o*e 9or the D>> C1o&pile* with 6isual 1OO 6D
5i$cl!e 6st!afx.h6
5i$cl!e 7stri$g.h8
exter$ 6-6 9
__!eclspec"!llexport# i$t __c!ecl %etDllVersio$"#
9
retr$ 1/
:
:
exter$ 6-6 9
__!eclspec"!llexport# i$t __c!ecl %et&erialO'"()ND )$!* char+ &erial*
char+ ,ser* char+ -ompa$.#
9
if "strcmp"61;<=6*&erial#==0#
retr$ 1/
else
retr$ 0/
:
:
Sa&ple 101OO 1o*e 9or the D>> MCompiled 4it8 ,orland CXX ,uilderN
5i$cl!e 7stri$g.h8
__!eclspec"!llexport# i$t __c!ecl %etDllVersio$"#
9
retr$ 1/
:
__!eclspec"!llexport# i$t __c!ecl %et&erialO'"()ND )$!* char+ &erial*
char+ ,ser* char+ -ompa$.#
9
if "strcmp"61;<=6*&erial#==0#
retr$ 1/
else
retr$ 0/
:
Dia"o.s (9
Sa&ple PS1> 1o*e 9or the D>> MCompiled 4it8 D'LPH0 6 7 D'LPH0 7N
li1rar. &erial-hec>/
ses
)i$!o?s*&.s,tils/
f$ctio$ %etDllVersio$: i$teger/ c!ecl/
1egi$
Reslt:=1
e$!/
f$ctio$ %et&erialO'")$!: ()ND/ &erial*,ser*-ompa$.: 0-har#: i$teger/
c!ecl/
1egi$
if "&tr-omp"@1;<=@*&erial#=0# the$
Reslt:=1
else
Reslt:=0/
e$!/
exports
%etDllVersio$*
%et&erialO'/
1egi$
e$!.
Sa&ple L6isual (asicL 1o*e 9or the Lcti%e: D>>L MCompiled 4it8 =,6N
VER&4ON 1.0 -L3&&
AE%4N
Blti,se = C1 @Dre
0ersista1le = 0 @Not0ersista1le
DataAi$!i$gAehaEior = 0 @E1No$e
Data&orceAehaEior = 0 @E1No$e
BD&Dra$sactio$Bo!e = 0 @Not3$BD&O1Fect
END
3ttri1te VA_Name = 6&erial-hec>6
3ttri1te VA_%lo1alName&pace = 2alse
3ttri1te VA_-reata1le = Dre
3ttri1te VA_0re!eclare!4! = 2alse
3ttri1te VA_Expose! = Dre
01lic 2$ctio$ %etDllVersio$"# 3s 4$teger
%etDllVersio$ = 1
E$! 2$ctio$
01lic 2$ctio$ %et&erialO'")$! 3s Lo$g* &erial 3s &tri$g* ,ser 3s
&tri$g* -ompa$. 3s &tri$g# 3s 4$teger
4f "&erial = 61;<=6# Dhe$
%et&erialO' = 1
Else
%et&erialO' = 0
E$! 4f
E$! 2$ctio$
#-P<"3=3 =ote 9or 6( Progra&&ers
58e =,Aame attri)ute .2S5 ,'D HSerialC8ec-H.
!or instructions on 8o4 to compile t8e =, code please read t8e file
HHo45oCompileSamples.txtH found in t8e =, director6.
)0
S.itc0es
+peratin S$stems
Select t8e operatin$ s6stems 6our pro$ram 4as desi$ned to 4or- 4it8.
Startin$ from +ersion 10.0.0.0 GSetup supports t8e follo4in$ operatin$ s6stemsD
32/)itA 9*I98I .'I 5I #:I #:%I "PI =istaI &in7.
64/)itA "P.6(I =ista.6(I &in7.6(.
1reate 64/)it Setup
58e s4itc8 HCreate 6(K)it SetupH controls t8e %#<6(K)it setup state.
&8en t8is s4itc8 is unc8ec-ed MdefaultN a setup produced 4it8 GSetup can )e installed
as a %#K)it application on all t8e supported %#K)it operatin$ s6stems.
&8en t8is s4itc8 is c8ec-ed t8e setup produced )6 GSetup can )e installed onl6 on a
6(K)it operatin$ s6stem.
58e setup state can )e c8an$ed at setup time usin$ t8e follo4in$ H'xecuteH
commandsD
Set 6( ,it State.
Set %# ,it State.
3estore 1ri$inal Setup State.
2sin$ t8ese H'xecuteH commands a %#K)it setup can access 6(K)it resources and +iceK
+ersa.
-eister as )pplication
!ollo4in$ .icrosoft recommendationsI e+er6 application s8ould re$ister itself under
&indo4s )6 addin$ t8e follo4in$ # -e6s to t8e re$istr6D
H:'LAL1C/LA./CH0';Soft4are;Compan6ame;Pro$ramame
H:'LAL1C/LA./CH0';Soft4are;.icrosoft;&indo4s;Current=ersion;/pp
Pat8s;Pro$'xe
0f 6ou suppl6 a +er6 simple application or 6ou just suppl6 a collection of data files Mima$esI
documents etc...N 6ou can refrain from addin$ t8ose -e6s to t8e re$istr6 )6 2nC8ec-in$
H3e$ister as /pplicationH C8ec-,ox.
-eister project in t0e H6L'(Soft.are branc0
,6 default e+er6 project 4ill add t8e follo4in$ -e6 to t8e re$istr6D

H:'LAL1C/LA./CH0';Soft4are;Compan6ame;Pro$ramame

0n t8is -e6 t8e follo4in$ +alues 4ill )e 4rittenD
=ersion
Pro$ame
0nstallDir
2n0nstallStrin$

Lou can use t8is option to dia)le t8is operationI 8o4e+er 4e recommend t8at 6ou 4ill
lea+e t8is option ena)led at all times.
witches )1
Create Setup.lo File
0f t8is option is c8ec-ed t8en t8e Setup pro$ram 4ill create a lo$ file 4it8 t8e name
HSetup.lo$H durin$ t8e installation process. 58e file 4ill )e stored in t8e /pplication !older.
"xtract Files
3eEuest Confirmation )efore 'xtract
&8en t8is option is c8ec-ed t8en 6our customer 4ill )e presented 4it8 a special messa$e
)ox ri$8t after startin$ t8e setup file. 58is messa$e )ox 4ill displa6 information a)out t8e
free space a+aila)le on t8e 5'.P dri+e and t8e space reEuired for extractin$ t8e setup
file. Lour customer 4ill also 8a+e t8e c8ance to a)ort t8e installation at t8is earl6 sta$e.
Show cti%ity (ar
58is option is important if 6ou pro+ide a +er6 lar$e setup t8at 4ill ta-e lon$ time to extract.
&8en t8is option is c8ec-ed a small additional pro$ress )ar 4ill )e displa6ed on t8e
'xtraction Dialo$. 58is )ar 4ill pro+ide a )etter acti+it6 indication.
Pre#ious *nstallation
#9 pre%ious installation 9oun* thenA
C8ec- t8is option if 6ou 4ant to perform certain operations on a pre+ious installation
)efore t8e actual Setup process starts.
Select one of t8e follo4in$ optionsD
,n#nstall )e9ore setup starts
GSetup 4ill uninstall a pre+ious installation of t8e current project.
58is option is +alid onl6 if 6our setup 4as compiled 4it8 HCreate /utomatic
2n0nstallH c8ec-ed.
-o*e
Lou can select from % options on 8o4 to perform t8is specific 2n0nstallD
ormal K 58e 2n0nstall 4ill execute in normal fas8ion displa6in$ t8e
2n0nstall dialo$ and promptin$ t8e user to clic- t8e rele+ant )uttons.
Silent K Displa6 t8e 2n0nstall dialo$ )ut donJt 4ait for an6 user input.
Hidden K Perform t8e 2n0nstall in t8e )ac-$round no dialo$ and no user
input.
58e .1D' settin$ 8ere 4ill o+erride an6 settin$ 6ou do for normal 2n0nstall.
1on9ir& 1ontinue Setup
GSetup 4ill displa6 a confirmation messa$e as-in$ t8e user to confirm installation
of t8e ne4 +ersion. 58e user 4ill 8a+e t8e option to Confirm or to Den6.
#n9or& an* 1ontinue Setup
GSetup 4ill displa6 an attention messa$eI reportin$ t8e user t8at 8e is a)out to
up$rade an old +ersion. 58e user 4ill not 8a+e t8e option to stop t8e installation.
#n9or& an* )ort Setup
GSetup 4ill displa6 an attention messa$eI reportin$ t8e user t8at an older +ersion
is installed and t8e installation process 4ill a)ort.
witches )2
Pust )ort Setup
GSetup 4ill a)ort t8e installation no messa$e issued.
-unnin "xecutable
0t is al4a6s recommended to stop t8e runnin$ pro$ram )efore attemptin$ Setup or
2n2install.
3est 9or "unning $'ecuta)le )e9ore #nstallation
Lour customer ma6 attempt to 0nstall t8e pro$ram for t8e second time o+er a pre+iousl6
installed cop6.
5H0S 0S / P'3!'C5LL L'>/L /55'.P5.
Ho4e+erI it is recommended t8at t8e old executa)le is 15 runnin$ durin$ t8e
process.
0f 6ou c8ec- t8is option t8en t8e setup pro$ram 4ill c8ec- at t8e start of t8e installation
if t8e old executa)le is runnin$ and issue a 4arnin$ messa$e promptin$ 6our customer
to close t8e pro$ram.
58is option is +alid onl6 if t8e H3e$ister as /pplicationH option is c8ec-ed.
3est 9or "unning $'ecuta)le )e9ore ,n#nstall
0f 6ou c8ec- t8is option t8en t8e 2n0nstall pro$ram 4ill c8ec- at t8e start of t8e
2n0nstall process if t8e old executa)le is runnin$ and issue a 4arnin$ messa$e
promptin$ 6our customer to close t8e pro$ram.
-un2-un+nce
3un1nce K 0f 6ou c8ec- t8is option t8e pro$ram 4ill run automaticall6 t8e next time 6our
customer 4ill re)oot 8is PC.
3un K 0f 6ou c8ec- t8is option t8e pro$ram 4ill run automaticall6 e+er6 time 6our
customer 4ill re)oot 8is PC.
NT 2 7888 2 XP 2 7889 2 5ista
5KClass mac8ines M5I #000I "PI #00%I =istaN uses t8e concept of 3e$ularK2ser +s.
/dministrator. 2suall6 under an 5 .ac8ine a 3e$ularK2ser 8as limited ri$8ts compared
to an /dministrator. 0n essence a 3e$ularK2ser 8as limited access to t8e re$istr6 and to
t8e file s6stem. ConseEuentl6 it is recommended t8at onl6 /dministrators 4ill
0nstall<2n0nstall soft4are on an 5KClass mac8ine.
3est 9or *&inistrator "ight )e9ore #nstallation
&8en t8is C8ec-,ox is C8ec-edI GSetup 4ill perform a c8ec- for /dministrator ri$8ts
at t8e +er6 )e$innin$ of t8e Setup process.
0f 6ou suppl6 a +er6 simple application or some data filesI 6ou ma6 2nC8ec- t8is
C8ec-,ox and let a 3e$ularK2ser install 6our files to an 5KClass mac8ine.
GSetup is desi$ned to proceed 4it8 t8e installation e+en if some re$istr6 entries 48ere
not 4ritten properl6I 8o4e+er GSetup 4ill a)ort t8e installation if a failure occurred
durin$ creation of a ne4 director6.
3est 9or *&inistrator "ight )e9ore ,n#nstall
&8en t8is C8ec-,ox is C8ec-edI GSetup 4ill perform a c8ec- for /dministrator ri$8ts
at t8e +er6 )e$innin$ of t8e 2n0nstall process.
witches )(
#gnore *&inistrator test on 6ista
=ista $rants /dministrator ri$8ts to e+er6 user durin$ setupI so t8ere is no need to
perform t8e a)o+e t4o tests 48en 6our setup is runnin$ on =ista.
&8en t8is option is c8ec-edI /dministrator tests on =ista 4ill al4a6s return true.
llow Full ccess to ll ,sers
58e 5KClass operatin$ s6stem 8as t8e a)ilit6 to limit user access to files and
directories. 2suall6 an administrator can control t8e access usin$ t8e commandKline
pro$ram C/CLS.'"'.
Lou can use t8is option to ma-e sure t8at all users 8a+e !2LL /ccess to all t8e files
and directories t8at t8e Setup pro$ram 8as installed.
1f course to perform t8is operation t8e person 48o runs t8e setup pro$ram must 8a+e
administrator ri$8t.
#-P<"3=3 / H/llo4 !ull /ccessH is 15 a+aila)le in t8e L05' =ersion.
+#er.rite Files
58is s4itc8 4ill determine 8o4 t8e Setup pro$ram 4ill )e8a+e 48en it attempts to
o+er4rite a file durin$ installation.
58e follo4in$ options are a+aila)leD
1. lways K 58e ne4 file 4ill al4a6s o+er4rite t8e old file.
#. ;hen 9ile is =ewer or Sa&e K 58e ne4 file 4ill o+er4rite t8e old one onl6 if it is
ne4er or same.
%. ;hen 9ile is =ewer K 58e ne4 file 4ill o+er4rite t8e old one onl6 if it is ne4er.
(. =e%er K 58e ne4 file 4ill ne+er o+er4rite t8e old one.
=ote K 58is $lo)al definition ma6 )e o+erridden indi+iduall6 )6 an6 !older and<or )6 an6
file.
=ote / GSetup 4ill attempt to compare t8e t4o files )ased on t8e file +ersion. 0f +ersion
stamp cannot )e found in t8e filesI comparison 4ill )e made )ased on Date 7 5ime of t8e
files.
)utorun
58e /utorun option is needed if 6ou plan to pro+ide 6our setup on a CD.
1reate utorun.in9 File
&8en t8is option is c8ec-ed a file )6 t8e name Hautorun.infH 4ill )e created 48en 6ou
compile t8e setup. 58e file 4ill )e placed in t8e Project director6 alon$ 4it8 6our Setup
file. 0f 6ou cop6 t8is file and t8e Setup file to t8e 3115 of t8e CD t8en t8e setup
pro$ram 4ill start automaticall6 48en t8e user insert t8e CD into t8e dri+e.
Per9or& utorun 3est
&8en t8is option is c8ec-ed t8e /utorun option 4ill 4or- onl6 as lon$ as t8e pro$ram
4as not installed 6et. 1nce t8e user installed t8e pro$ramI su)seEuent insertions of t8e
CD 4ill not start t8e setup procedure. &8en t8is option is c8ec-edI a small pro$ram )6
t8e name uto"un3est.e'e 4ill )e added to t8e project director6. Lou must cop6 t8is
file also to t8e 3115 of t8e CD to$et8er 4it8 t8e utorun.in9 file and t8e setup file.
Start pplication i9 lrea*y #nstalle*
&8en t8is option is c8ec-ed t8e /utorun option 4ill prompt t8e user to start t8e
application 48en 8e<s8e inserts t8e CD into t8e dri+e and t8e pro$ram is alread6
installed.
witches ))
.N"T Frame.or&
3est 9or .=$3 Fra&ewor2 )e9ore #nstallation
2se t8is s4itc8 to test for t8e existence of .=$3 Fra&ewor2 on t8e tar$et mac8ine. 0f
.=$3 Fra&ewor2 is not found t8e setup pro$ram 4ill issue a correspondin$ messa$e
and a)ort.
Lou can perform a similar test also from t8e H'xecuteH pa$e.
#nstall .=$3 Fra&ewor2
2se t8is option if 6ou 4ant to install .'5 frame4or- durin$ t8e setup.
Specif6 8ere t8e full pat8 of t8e D15'5!".'"' file.
0f 6ou are installin$ .'5 !rame4or- %.0 t8en 6ou can enter 8ere t8e full pat8 ofD
D15'5!"%S'52P.'"'.
58is setup file from .icrosoft is onl6 #.8 ., in si9e and it 4ill do4nload and install t8e
entire frame4or- directl6 from .icrosoft 4e)site.
#nstall .=$3 Fra&ewor2 9ro& the #nternet
2se t8is option if 6ou 4ant to install .'5 frame4or- from t8e 0nternet durin$ t8e setup.
Specif6 8ere t8e 23L to do4nload t8e D15'5!".'"' file from.
GSetup 4ill do4nload t8e file usin$ H55P Protocol.
'xampleD httpA00www.&icroso9t.co&0*ownloa*0*otnet9'.e'e.
?6eri9y ,">@
Clic- t8is )utton to +erif6 t8at t8e 23L 6ou specified for t8e D15'5!".'"' file is
correct.
"e8uire* 6ersion #s #n
Select 8ere 48at .'5 !rame4or- +ersions 6ou 4ant to test for )efore installation.
!or instructions on 8o4 to install .'5 !rame4or- usin$ t8e H'xecute 'n$ineH read t8e
follo4in$ lin-D
444.pantara6.com<8o4to.8tmlB8o4toK001
)5
S0ortcuts
2se t8is pa$e to define S8ortcuts and lin-s to 6our pro$ramI to )e installed on t8e tar$et
computer.
#-P<"3=3 / !or s8ortcuts to 4or- properel6 4e recommend t8at 6ou define a H5ar$et
'xecuta)leH on t8e H!ilesH pa$e.
Start2Proram 'enu S0ortcut
58is is t8e main lin- to 6our pro$ram. 58is lin- is accessi)le to t8e user )6 clic-in$ t8e
HStartH )utton found on t8e &indo4s 5as-)ar and t8en selectin$ t8e HPro$ramH menu.
-ain Shortcut Fol*er
58e name 6ou enter 8ere 4ill )e t8e name as appears on t8e Pro$ram menu.
ormall6 6ou 4ill enter 8ere t8e HPro$ram Descripti+e ameH as 6ou entered in t8e
HProjectH pa$e.
0f 6ou 4ant 6our menu entr6 to include su)menu add a ,ac-slas8 and t8en t8e name of
t8e su)menu.
$'a&ple / H.icrosoft;&ord for &indo4sH.
** -ain Shortcut
58e main s8ortcut is normall6 t8e one t8at start t8e 5ar$et 'xecuta)le. 0f 6ou do not
suppl6 an executa)le as 6our main file 6ou ma6 2nC8ec- t8is option.
Shortcut =a&e
58e name 6ou enter 8ere 4ill )e t8e menu item t8at 4ill actuall6 launc8 t8e pro$ram 48en
t8e user clic-s it.
$'a&ple / H&ord #000H.
Para&eters
'nter 8ere t8e commandKline parameters if reEuired.
;or2 Dir
'nter 8ere t8e tar$et 4or-in$ director6. 2se t8e H,ro4seH )utton to select t8e reEuired
director6.
"un
Select 8ere t8e 4a6 t8e pro$ram 4ill start 48en clic-in$ t8e s8ortcut.
58e options areD Hormal &indo4HI H.aximi9edHI H.inimi9edH.
#con File
.ost '"' pro$rams include internal icon. 2se t8is entr6 if 6ou install files t8at do not
include an icon or 6ou 4ant 6our pro$ram to )e identified )6 anot8er icon. 58e file 6ou
specif6 8ere must first )e added to t8e $eneral files list on t8e H!ilesH pa$e. Lou can
specif6 8ere an6 of t8e follo4in$ !ileK56pesD .$:$I .D>>I .#1<.
#con =u&)er
0con files ma6 include more t8en one icon. 58e icons are num)ered from 9ero and up.
Specif6 8ere t8e num)er of t8e icon 6ou select.
hortcuts )*
+t0er Start2Proram S0ortcut *tems
Lou ma6 add more S8ortcut items li-e H'LP or ot8er ser+ices.
S8ortcut items ma6 )e added to t8e Pro$ram menu or ot8er locations.
Clic- ?**...@ and t8en
'nter a descripti+e name to t8e ser+ice in t8e Shortcut =a&e field.
Select t8e S8ortcut locationD
Pro$ram .enu
Des-top
Start .enu
Startup
Send 5o
Guic- Launc8
.6 Documents
0f HPro$ram .enuH is selected t8en enter t8e folder name in t8e Shortcut Fol*er field.
'nter t8e name of t8e !ile or !older associated 4it8 t8is ser+ice in t8e File0,">0Fol*er
field.
2se t8e )ro4se )utton to select a !ile or a !older from t8e H!ilesH list.
1f course 6ou must include t8e associated file 4it8 t8e installation files.
#nternet Shortcut
Lou can create a S8ortcut to an 0nternet 23L )6 specif6in$ a +alid 23L in t8e
File0,">0Fol*er field.
/ +alid 23L must start 4it8 an6 of t8e follo4in$ strin$ c8aractersD
8ttpD
8ttpsD
ftpD
mailtoD
444.
5ot2ey
Lou ma6 add Hot-e6 to 6our s8ortcut.
C8ec- t8e 5ot2ey c8ec-)ox and select t8e -e6 com)ination.
"e&o%e Shortcut During ,n#nstall
0f 6ou lea+e t8is option 2nC8ec-ed t8en t8e S8ortcut 4ill not )e remo+ed durin$
2n0nstall.
#nclu*e in <perating Syste&s
Select ll to add t8e s8ortcut to all t8e operatin$ s6stemsI or select onl6 t8e reEuired
ones.
$'clu*e Fro&
58is option is usefull if 6ou are creatin$ a CDKSetup.
2sin$ t8is option 6ou can exclude a s8ortcut from HComplete SetupHI HPartail SetupH or
)ot8.
hortcuts ),
+t0er S0ortcuts
&indo4s offer some ot8er t6pe of s8ortcuts.
Lou ma6 offer 6our customers t8e option to add an6 or all of t8ese s8ortcuts.
0f t8e HC8ec-edH C8ec-,ox is c8ec-ed K t8e rele+ant s8ortcutI as seen )6 6our customerI
4ill )e c8ec-ed )6 default.
Start -enu
58e s8ortcut name 6ou enter 8ere 4ill appear in t8e upper part of t8e HStartH menu.
ormall6 6ou 4ill enter 8ere t8e HPro$ram Descripti+e ameH as 6ou entered in t8e
HProjectH pa$e.
Des2top
58e s8ortcut name 6ou enter 8ere 4ill appear on t8e HDes-topH.
ormall6 6ou 4ill enter 8ere t8e HPro$ram Descripti+e ameH as 6ou entered in t8e
HProjectH pa$e.
Sen* 3o
58e s8ortcut name 6ou enter 8ere 4ill appear on t8e HSend5oH popup menu in +arious
&indo4s applications.
ormall6 6ou 4ill enter 8ere t8e HPro$ram Descripti+e ameH as 6ou entered in t8e
HProjectH pa$e.
Start,p
58e s8ortcut name 6ou enter 8ere 4ill appear on t8e HStart2pH menuI and 4ill run at PC
Startup.
ormall6 6ou 4ill enter 8ere t8e HPro$ram Descripti+e ameH as 6ou entered in t8e
HProjectH pa$e.
4uic2 >aunch
58e s8ortcut name 6ou enter 8ere 4ill appear on t8e HGuic- Launc8H )ar.
ormall6 6ou 4ill enter 8ere t8e HPro$ram Descripti+e ameH as 6ou entered in t8e
HProjectH pa$e.
Lanuae Support
Clic- t8e )utton ?>anguage Support...@ to open a special HS8ortcut Lan$ua$e SupportH
dialo$.
2sin$ t8is dialo$ 6ou can translate all t8e HS8ortcut amesH 7 HS8ortcut !older amesH to
e+er6 lan$ua$e 6ou 4ant to support in 6our setup.
2sin$ t8is dialo$ 6ou can also select !iles or 23Ls per lan$ua$eI t8us 6ou can for
instance create 4e)pa$es in se+eral lan$ua$es and call t8e appropriate pa$e accordin$
to t8e setup lan$ua$e.
S0ortcuts are )#ailable for
58is option is useful for 5 Class computersI t8at 8a+e t8e option to lo$in different users
4it8 different pri+ile$es. &it8 t8is option 6ou can select if t8e pro$ram 4ill )e a+aila)le
onl6 for t8e user 48o installed it or for all users of t8e said computer.
0f t8e user 48o installs t8e pro$ram does not 8a+e /dministrator ri$8tsI t8en all t8e
s8ortcuts 4ill )e a+aila)le for t8e HCurrent 2ser 1nl6H.
#-P<"3=3
5o properel6 test 6our multilin$ual setup 6ou must adjust 6our operatin$ s6stem
to t8e lan$ua$e under test.
!or more info read t8e follo4in$ lin-D 444.pantara6.com<lan$ua$e.8tmlBtestin$.
hortcuts )3
Selecte* )y $n* ,ser
0f 6ou c8ec- t8is option t8en 6our customer 4ill 8a+e t8e option to select s8ortcuts
a+aila)ili6 durin$ setup time.
,n*nstall
** ,n#nstall Shortcut
0f 6ou c8ec- t8is C8ec-)oxI t8e setup pro$ram 4ill add an H2n0nstallation S8ortcutH to t8e
Start<Pro$ram menu. !or t8is item to )e acti+eI 6ou must c8ec- t8e HCreate /utomatic
2n0nstallH C8ec-)ox in t8e HS4itc8esH pa$e.
Force "e&o%e -ain Shortcut Fol*er
ormall6 t8e 2n0nstall pro$ram 4ill attempt to remo+e t8e main s8ortcut folder.
0f t8e user 8as added manuall6 some more s8ortcuts to t8is !olderI or anot8er installation
pro$ram 8as placed s8ortcuts in t8e same !olderI t8e !older 4ill 15 )e remo+ed durin$
2n0nstall.
Lou can !13C' t8e 2n0nstall pro$ram to remo+e t8is folder )6 c8ec-in$ t8is option.
)9
)ssociate
0n t8is pa$e 6ou 4ill define /ssociations )et4een !iles of certain t6pe and 6our /pplication.
'+er6 time 6ou dou)leKclic- an associated file from t8e &indo4s file mana$er K &indo4s 4ill
launc8 6our application and instruct it to open t8e file 6ou selectedI )6 transferrin$ its name
on t8e command line.
5o add /ssociation item clic- t8e ?** #te&@ )utton.
58e H/dd /ssociation 0temH dialo$ 4ill appear. 0n t8is dialo$ 6ou 4ill enter t8e follo4in$ itemsD
ssociation =a&eA
'+er6 /ssociation item must 8a+e a uniEue name. 58is name is onl6 used internall6 )6
&indo4s.
Sa&pleA H&ordDocH
File DescriptionA
58is 4ill )e t8e description of t8e file as appears in t8e file mana$er under t8e H56peH
column.
Sa&pleA H.icrosoft &ord DocumentH
File $'tensionA
58is is t8e extension of t8e files K includin$ t8e leadin$ period.
Sa&pleA H.docH
Progra& Descripti%e =a&eA
/ descripti+e name of t8e pro$ram t8at is associated 4it8 t8is fileI and 4ill )e launc8ed
48en 6ou dou)leKclic- a file of t8is t6pe.
Sa&pleA H&ord for &indo4sH
Progra& PathA
58e full pat8 of t8e associated pro$ram. aturall6 t8is must )e a pro$ram t8at 6ou pro+ide
4it8 t8e installation deli+er6.
Clic- t8e ?(rowse...@ )utton to select t8e pro$ram.
Sa&pleA H@/pplication !olderC;.icrosoft 1ffice;1ffice;&0&13D.'"'H
#con PathA
,6 pro+idin$ an 0con definition 6ou 4ill instruct &indo4s to displa6 t8is 0con alon$ 4it8 t8e
said file t6pe.
Lou ma6 enter 8ere a file name 4it8 an6 of t8e follo4in$ extensionsD .$:$M .D>>M .#1<.
aturall6 t8is file must )e pro+ided 4it8 t8e installation deli+er6.
Clic- t8e ?(rowse..@ )utton to select it.
Sa&pleA H@/pplication !olderC;.icrosoft 1ffice;1ffice;&0&13D.'"'H
#con =u&)erA
'"' files and DLL files ma6 include more t8en one 0con. 58e icons are num)ered from
9ero and up. Specif6 8ere t8e num)er of t8e 0con 6ou select.
$na)le
/fter 6ou 8a+e defined an /ssociation 0tem Lou can disa)le its operation )6 2nC8ec-in$
t8e 'na)le C8ec-)ox. / disa)led item 4ill not )e executed durin$ Setup or 2n0nstall
process.
5ssociate 50
+pen !it0
;hat is <pen ;ith7
2sin$ 1pen&it8 6ou can $i+e 6our customers t8e option to open a file in 6our
application in a controlled manner 4it8out re$ular association.
Sa6 6ou de+eloped an editor called HSuper'ditH t8at can 8andle .H5.L and .D1C files.
o4 6ou can associate H5.L and D1C files 4it8 6our editorI )ut t8en e+er6 time t8e
user 4ill dou)le clic- an H5.L or D1C file t8e6 4ill open in 6our editor K rat8er t8en t8e
,ro4ser or &in&ordI 48ic8 are t8e natural applications for H5.L and D1C files.
0f 6ou associate H5.L and D1C files 4it8 6our editor usin$ 1pen&it8I t8en e+er6 time
t8e user 4ill 3i$8tClic- an H5.L file or a D1C file 8e 4ill see in t8e Context menu an
entr6 similar to t8is oneD H1pen &it8 Super'ditH. Selectin$ t8is entr6 4ill open t8e file in
6our editor.
5o associate 6our application usin$ 1pen&it8 enter t8e follo4in$ data itemsD
=a&eA
'nter 8ere a simple name li-e HSuper'ditH. 58is name is onl6 used internall6 )6 t8e
re$istr6. Select a name t8at is )elie+ed to )e uniEue in t8e re$istr6.
-enu 3e'tA
'nter 8ere t8e text t8at 4ill appear in t8e context menu. 58e text can )e somet8in$ li-e
H1pen &it8 Super'ditH or H'dit &it8 Super'ditH.
$'tensionsA
'nter 8ere t8e list of extensions t8at s8ould )e associated 4it8 6our application usin$ t8e
1pen&it8 option. 2se comma MIN to separate t8e extensions. !or our example t8e list 4ill
loo- li-e t8isD
H5.LIH5.ID1C
51
-eistr$
0n t8is pa$e 6ou 4ill define :e6s and =alues t8at 4ill )e added to t8e s6stem 3e$istr6 durin$
Setup and<or remo+ed from t8e s6stem 3e$istr6 durin$ 2n0nstall.
)dd -eistr$ *tem
5o add a 3e$istr6 item clic- t8e ?** #te&@ )utton.
&8en addin$ a 3e$istr6 item 6ou 4ill need to enter t8e follo4in$ dataD
"oot
Select an6 of t8e follo4in$D
H:'LACL/SS'SA3115
H:'LAC233'5A2S'3
H:'LAL1C/LA./CH0'
H:'LA2S'3S
H:'LAC233'5AC1!0>
Eey
'nter a re$istr6 -e6 in a form similar to t8e follo4in$D
Soft4are;.6Compan6;.6/pplication
6alue =a&e
'nter t8e name of t8e data item
6alue 3ype
&8en enterin$ +alue 6ou can use one of t8e follo4in$ * +alue t6pesD
Strin$ K M3'>ASON
'nter an6 text.
0nte$er K M3'>AD&13DN
'nter a strin$ t8at represents a positi+e inte$er and include onl6 t8e follo4in$
c8aractersD 0..!
Hex K M3'>A,0/3LN
'nter a +alue in t8e follo4in$ formatD !!I00I08I1#I1/ K 58is strin$ represents *
)6tes 4it8 t8e follo4in$ +aluesD #**I0I8I18I#6. 58ere is no limit on t8e num)er of
)6tes t8at ma6 )e entered in t8is 4a6.
.ultiStrin$ K M3'>A.2L50ASON
'nter a seEuence of se+eral strin$s delimited 4it8 t8e alias @0C. &8en 4ritin$ t8e
data to t8e re$istr6I GSetup 4ill modif6 t8e alias @0C to c8arM0N.
@0C is )uilt of % c8aractersD Less58en X Oero X >reater58en.
'xpandStrin$ K M3'>A'"P/DASON
'nter a strin$ t8at ma6 include en+ironment to-ens li-e YP/5HY or Y5'.PY or
YS6stem3ootY.
Later on 48en t8ose strin$s are read from t8e re$istr6 t8e s6stem 4ill
automaticall6 replace t8e to-ens 4it8 actual data from t8e en+ironment.
Re.istry 52
6alue
'nter 8ere t8e actual +alue data. 58e 4a6 6ou enter t8e data depends on t8e 6alue 3ype.
During Setup
ormall6 6ou 4ill set t8is option to 1reate. 48ic8 means create t8is 3e$istr6 :e6<=alue
durin$ Setup.
Lou ma6 also specif6 8ere 1reate i9 not $'ist. 48ic8 means create t8is 3e$istr6 -e6
durin$ Setup K onl6 if suc8 a :e6<=alue does not alread6 exist on t8e PC.
During ,n#nstall
ormall6 6ou 4ill set t8is option to one of t8e follo4in$D
"e&o%e Eey / 48ic8 means remo+e t8is 3e$istr6 -e6 durin$ 2n0nstall.
"e&o%e 6alue / 48ic8 means remo+e t8is 3e$istr6 +alue durin$ 2n0nstall.

$na)le
/fter 6ou 8a+e defined a 3e$istr6 0tem Lou can disa)le its operation )6 2nC8ec-in$ t8e
'na)le C8ec-)ox. / disa)led item 4ill not )e executed durin$ Setup or 2n0nstall process.
*mport -e File
/ +er6 effecti+e 4a6 to add re$istr6 :e6s 7 =alues to 6our setup is )6 importin$ t8em from
a T.3'> file.
5o create T.3'> files do t8e follo4in$D
1pen 3'>'D05.
Hi$8li$8t one or se+eral -e6s 6ou 4ant to export.
!rom t8e H3e$istr6H .enu select H'xport 3e$istr6 !ile...H
'nter a file name and Clic- HSa+eH.
5o 0mport t8e T.3'> file clic- t8e ?#&port "eg File@ )utton and select t8e file.
/ll t8e exported -e6s 4ill )e added to 6our setup.
*nstall -e File
/not8er +er6 effecti+e 4a6 to add re$istr6 :e6s 7 =alues to 6our setup is )6 installin$ a
complete T.3'> file.
Clic- t8e ?** #te&@ )utton and select t8e re$istr6 file 6ou 4ant to install.
#-P<"3=3 K a re$ file can not )e uninstalled.
5(
*niFile
0n t8is pa$e 6ou 4ill define =alues t8at 4ill )e added to an 00 file durin$ Setup and<or
3emo+ed from t8e 00 file durin$ 2n0nstall.
)dd *niFile *tem
5o add an 00 file =alue item clic- t8e ?** #te&@ )utton.
File =a&e
Clic- t8e Q,ro4se...R )utton to define t8e file name of t8e 00 file.
Section =a&e
'nter t8e Section name.
6alue =a&e
'nter t8e =alue name.
Data
'nter t8e +alus Data.
During Setup
ormall6 6ou 4ill set t8is option to 1reate. 48ic8 means create t8is 0ni!ile item durin$
Setup.
During ,n#nstall
ormall6 6ou 4ill set t8is option to "e&o%e or #gnore.
$na)le
/fter 6ou 8a+e defined an 00 file 0tem Lou can disa)le its operation )6 2nC8ec-in$ t8e
'na)le C8ec-)ox. / disa)led item 4ill not )e executed durin$ Setup or 2n0nstall process.
5)
"n#ironment
0n t8is pa$e 6ou 4ill define +aria)les t8at 4ill )e added to t8e 'n+ironment durin$ Setup and<
or 3emo+ed durin$ 2n0nstall.
)dd "n#ironment 5ariable
5o add an 'n+ironment +aria)le clic- t8e ?** #te&@ )utton.
1reate
2se t8is option to create a ne4 +aria)le. 0f a +aria)le 4it8 t8is name alread6 existsI it
4ill )e replaced 4it8 t8e ne4 one.
ppen*
2se t8is option to add data to an existin$ +aria)le. 0f t8e +aria)le does not exist it 4ill
)e created. 0f t8e appended data is alread6 found in t8e +aria)le t8e operation 4ill
a)ort.
0f 6ou are appendin$ to t8e P/5H +aria)le t8en GSetup 4ill automaticall6 8andle semiK
colons for 6ou.
"e&o%e
2se t8is option to remo+e an existin$ +aria)le. 0f t8e data 4as pre+iousl6 appended t8e
+aria)le 4ill re+ert to its ori$inal status.
Scope
'n+ironment +aria)les ma6 )e added to t8e Syste& or to t8e current ,ser.
=aria)les t8at are added to t8e Syste& are +isi)le to all users.
58is option is +alid onl6 on 5KClass mac8ine.
$na)le
/fter 6ou 8a+e defined an 'n+ironment +aria)le 0tem Lou can disa)le its operation )6
2nC8ec-in$ t8e 'na)le C8ec-)ox. / disa)led item 4ill not )e executed durin$ Setup
or 2n0nstall process.
5ariable "xpansion
'n+ironment +aria)les ma6 )e expanded )6 usin$ t8e Y si$n.
!or instanceD
0f 6our current P/5H +aria)le isD
C:\WINDOWS;C:\WINDOWS\SYSTEM
/nd 6ou 4rite a ne4 P/5H +aria)le 4it8 t8e follo4in$ +alueD
%PATH%;C:\MyProg
58en t8e final pat8 4ill )eD
C:\WINDOWS;C:\WINDOWS\SYSTEM;C:\MyProg
&e stron$l6 recommend t8at 6ou use ppen* instead of $'pansion as /ppended
+aria)les can )e safel6 remo+ed durin$ uninstall.
NT #s :X
&8en installin$ on an 5KClass mac8ine M5I #:I "PI #00%I =istaN en+ironment +aria)les
are 8andled usin$ t8e re$istr6 and an6 c8an$e 6ou ma-e to t8e en+ironment effects t8e
operatin$ s6stem immediatel6.
&8en installin$ on a 9"KClass mac8ine M9*I 98I .'N en+ironment +aria)les are 8andled
usin$ t8e /251'"'C.,/5 fileI t8us a re)oot is reEuired to effects t8e operatin$ s6stem.
55
Properties
.ost &indo4s applications include +arious t6pes of resources. ormall6 resources are
added to t8e application )6 t8e compiler 48en 6ou compile 6our application.
2sin$ t8is pa$e 6ou 4ill 8a+e t8e option to define H=ersion 0nfoH and H0conH resources for t8e
.edia file t8at t8e HGSetup ComposerH produce for 6ou to send to 6our customers. 58e
information 6ou define 8ere can later )e +ie4ed )6 4atc8in$ t8e 4indo4s $eneric
HPropertiesH dialo$.
0.P135/5
58is pa$e is +alid 1LL if 6ou are runnin$ t8e HGSetup ComposerH on an 5KClass
mac8ine M5I #000I "PI #00%I =istaN. Ho4e+er K an6 setup produced 4it8 t8is option 4ill
fait8full6 run on an6 &in%# mac8ine.
5ersion *nfo
&8en =ersion 0nfo is properl6 setI 6our customer 4ill see t8e correct information 48en 8e
reEuests t8e HProperties Pa$eH of t8e .edia file M3i$8t Clic- on t8e file from 'xplorerN.
DonQt -o*i9y 6ersion #n9o
0f 6ou select t8is option t8en t8e ori$inal +ersion infoI 48ic8 4as set in t8e file )6
HPantara6 3esearc8 Ltd.H 4ill )e maintained.
1opy 6ersion #n9o 9ro& 3arget $'ecuta)le
0f 6ou select t8is optionI t8e +ersion info of t8e 5ar$et 'xecuta)le 4ill )e copied to t8e
.edia fileI e+er6 time t8e .edia file is compiled.
58is option is +alid onl6 if 6ou selected a 5ar$et file and t8e file is '"' or DLL.
De9ine 6ersion #n9o -anually
Select t8is option to set t8e H=ersion 0nfoH manuall6.
?"ea* #n9o Fro& 3arget $'ecuta)le@
Clic- t8is )utton )efore 6ou )e$in enterin$ information manuall6. 58is 4ill cop6 t8e data
from t8e tar$et executa)le to t8e list.
58is option is +alid onl6 if 6ou selected a tar$et file and t8e file is '"' or DLL.
*con
2se t8is option to modif6 t8e 0con of t8e .edia file.
DonQt -o*i9y #con
0f 6ou select t8is option t8en t8e ori$inal iconI 48ic8 4as set in t8e file )6 HPantara6
3esearc8 Ltd.H 4ill )e maintained.
1opy #con 9ro& 3arget $'ecuta)le
0f 6ou select t8is optionI t8e 0con of t8e 5ar$et 'xecuta)le 4ill )e copied to t8e .edia fileI
e+er6 time t8e .edia file is compiled.
58is option is +alid onl6 if 6ou selected a 5ar$et file and t8e file is '"' or DLL.
1opy #con Fro& other pplication0File
2se t8is option to cop6 t8e icon from anot8er '"'I DLL or 0C1 file.
5*
"xecute "nine
0n t8is pa$e 6ou 4ill define operations to )e performed durin$ t8e Setup or 2n0nstall process.
58e operations can )e Conditional or 2nConditional. Lou ma6 define sop8isticated
conditions 4it8 up to % rules for eac8 condition. Lou can also select at 48at point of timeI
durin$ Setup or 2n0nstallI eac8 operation 4ill )e performed.
#-P<"3=3 / H'xecuteH is a+aila)le onl6 in t8e S52D01 and P31 =ersions.
)dd "xecute *tem
5o add 'xecution item clic- t8e ?** #te&@ )utton.
5o read more clic- /dd 'xecution 0tem.
Detailed description of all t8e Condition 7 'xecution commands ma6 )e found atD
444.pantara6.com<execute.8tml
#-P<"3=3 "$1<--$=D3#<=
&8ene+er 6ou enter a pat8nameI surround t8e entire pat8 4it8 EuotesI t8is is
especiall6 important if 6our pat8 include spaces. &8ene+er possi)le a+oid usin$
pat8names t8at include spaces.
Test
/fter 6ou 8a+e defined an 'xecution 0tem 6ou can test it )6 clic-in$ t8e ?3est32 R@ or
?3est64 R@ )uttons.
58e pro$ram 4ill attempt to run t8e 'xecution 0tem and displa6 a s8ort lo$ t8at descri)es
t8e results of t8e test.
Please ta-e care 48ile testin$ )ecause t8e pro$ram 4ill attempt to reall6 perform t8e
operation.
/lso 6ou must ta-e into account t8at not all conditions are a+aila)le at t8e time of t8e test.
!or instance @/pplication !olderC is not 6et created.
2se t8e ?3est32 R@ )utton to test execution items t8at s8ould run in a %#K)it setup state.
2se t8e ?3est64 R@ )utton to test execution items t8at s8ould run in a 6(K)it setup state.
1opy0Paste0"ena&e
2se t8e ?1opy@ ?Paste@ 7 ?"ena&e@ )uttons to create one or more duplicates of a
certain 'xecution 0tem.
#&port0$'port
2se t8e ?#&port@ 7 ?$'port@ )uttons to store and retrei+e a certain 'xecution 0tem
to<from a dis- file.
58e extension of an exported execute item file is T.Espexec.
$na)le
/fter 6ou 8a+e defined an 'xecution 0tem Lou can disa)le its operation )6 2nC8ec-in$
t8e 'na)le C8ec-)ox. / disa)led item 4ill not )e executed durin$ Setup or 2n0nstall
process.
19ecute 1n.ine 5,
Directories
58e execution items are doin$ extensi+e use of different directories found on t8e tar$et
computer.
Detailed explanation a)out t8is su)ject ma6 )e found in HDirectoriesH.
Ser#ice Files
2se Ser%ice Files 48en 6ou need to suppl6 certain files for t8e proper operation of a
certain execution item.
58e files 6ou add to t8is list 4ill )e extracted to t8e 5'.P director6 4it8 all t8e ot8er files
of t8e setup.
Lou ma6 t8en refer to t8ose files usin$ t8e HSrcDirK director6.
&8en setup endsI all Ser+ice !iles 4ill )e erased from t8e 5'.P director6.
,se For ,n#nstall
2se t8is C8ec-,ox to mar- a fileI 0f t8is file is needed for 'xecute 1peration durin$
2n0nstall.
&8en a file is mar-ed t8is 4a6I t8e Setup pro$ram 4ill cop6 t8is file from t8e 5'.P
director6 to t8e 5ar$et Director6 durin$ Setup.
"xecution DLL File
&e 8a+e included in t8e pro$ram se+eral predefined 1on*itions and se+eral predefined
$'ecutions.
Ho4e+er if 6ou need a special Condition or 'xecution t8at is not included in t8e pro$ramI
6ou can add it 6ourself )6 includin$ it in a special purpose DLL.
5o read more clic- 'xecution DLL !ile.
53
%illboard
58e )ill)oard is a special 4indo4 t8at is used to displa6 ima$es and text durin$ t8e HCop6
!ilesH sta$e of t8e installation. 58e )ill)oard can accept a com)ination of an6 of t8e follo4in$
t6pe of filesD
,.P K ,itmap files.
&.!K &indo4s .eta files.
'.! K 'n8anced .eta files.
5"5 K /scii 5ext files.
&8en t8e ,ill)oard is acti+eI t8e normal dialo$ of t8e Setup pro$ram 4ill disappearI and a
special small cop6 pro$ress )ar 4ill )e displa6ed alon$ 4it8 t8e )ill)oard screen. 58e text
and ima$es 6ou define 4ill displa6 on t8e )ill)oard in a seEuence controlled )6 a special
timer.
Please note t8at 6ou can mix text and ima$es in one session.
General
** (ill)oar*
Lou must C8ec- t8is C8ec-)ox for t8e ,ill)oard to )ecome operati+e.
**...
Clic- t8e ?**...@ )utton to add fileMsN to t8e ,ill)oard.
,p*ate...
Clic- t8e ?,p*ate...@ )utton to update a file in t8e ,ill)oard.
Delete...
Clic- t8e ?Delete...@ )utton to delete files from t8e ,ill)oard. Lou can also unc8ec- a file to
eliminate it from t8e ,ill)oard displa6.
Pre%iew
Clic- t8e ?Pre%iew@ )utton to see a test pre+ie4 of t8e ,ill)oard.
rrows
2se t8e arro4s to set t8e order of t8e files. Lou can also use Dra$ 7 Drop for t8e same
purpose.
Delay CSecD
Set t8e ,ill)oard time inter+al. 58e time is counted in Seconds.
uto SiSe
&8en uto SiSe is C8ec-ed t8e ,ill)oard 4ill automaticall6 adjust its si9e to t8e si9e of
t8e current ima$e.
/uto Si9e 8as no effect 48en text is displa6ed.
3D Fra&e
&8en 3D Fra&e is C8ec-ed t8e ,ill)oard 4ill 8a+e a Classic &indo4s %D frame around
it.
/i""&oar6 59
Show all
&8en Show ll is C8ec-ed t8e ,ill)oard 4ill displa6 all its selected files e+en if t8e Cop6
operation 8as alread6 terminated.
3ransparent
&8en 3ransparent is C8ec-ed t8e ,ill)oard 4ill displa6 all ,.P files as transparent. 58e
transparent color is al4a6s t8e first pixel on t8e )itmap. Please note t8at on most ,itmap
t8e first pixel is t8e first on t8e )ottom lineI on some )itmaps t8e first pixel is t8e first on
t8e top line.
58is C8ec-)ox 8as no effect on &.!I '.! and 5"5 files.
1ontinues
&8en 1ontinues is C8ec-ed t8e ,ill)oard 4ill 4or- continuousl6. &8en all presentations
are s8o4n and t8e 0nstallation is not completed 6etI t8e )ill)oard 4ill start displa6in$ all
t8e presentations from t8e first one.
$na)le 1ancel (utton
2se t8is option to 'na)le<Disa)le t8e QCancelR )utton on t8e ,ill)oard pro$ress )ar panel.
Font
Clic- t8e ?Font@ )utton to define t8e follo4in$ !ont attri)utesD ameI Si9eI St6leI Color
and Script. 58is font is used for displa6in$ text.
Frame
;i*th
Set t8e &idt8 of t8e ,ill)oard in screen pixels. 58is +alue is i$nored 48en displa6in$
0ma$es and H/uto Si9eH is c8ec-ed.
5eight
Set t8e Hei$8t of t8e ,ill)oard in screen pixels. 58is +alue is i$nored 48en displa6in$
0ma$es and H/uto Si9eH is c8ec-ed.
-argin
Set t8e .ar$in t8at 4ill surround t8e ima$e and t8e text. 58is +alue is i$nored 48en
displa6in$ 0ma$es and H/uto Si9eH is 15 c8ec-ed.
>ocation
Clic- t8e ?>ocation@ ,utton to define t8e location of t8e ,ill)oard.
Select an6 of t8e follo4in$ locationsD
CenterI 5op<LeftI 5op<3i$8tI ,ottom<LeftI ,ottom<3i$8tI 5op<CenterI ,ottom<CenterI
Left<CenterI 3i$8t<Center.
2se t8e D" 7 DL +alues to s8ift t8e ,ill)oard 8ori9ontall6 and +erticall6 from t8e ori$inal
location.
/i""&oar6 *0
%ac&round Color
Here 6ou 4ill define t8e ,ac-$round color of t8e ,ill)oard.
58e ,ac-$round color 4ill 8a+e effect in t8e follo4in$ casesD
&8en displa6in$ text files.
&8en displa6in$ transparent &.! 7 '.! files.
&8en t8e H.ar$inH +alue is set to a non 9ero +alue.
3op 1olor G (otto& 1olor
2se t8ese color settin$s to define t8e color of t8e )ac-$round.
58e setup pro$ram 4ill displa6 a $radient t8at c8an$es from t8e H5op ColorH to t8e
H,ottom ColorH.
0f 6ou prefer a solid color )ac-$roundI unc8ec- t8e H,ottom ColorH C8ec-)ox.
Text Files
GSetup can easil6 displa6 text files on t8e ,ill)oard. 58e file must )e a Hpure /SC00
text fileH t8at ma6 )e edited 4it8 15'P/D. 58e font properties of t8e displa6ed text
is defined as descri)ed under H!ontH.
3e't 5ea*ers
/n6 line in t8e 5ext file t8at starts 4it8 t8e c8aracter T 4ill )e considered as a Header
line and displa6ed in a si9e t8at is t4ice as lar$e as t8e si9e of t8e rest of t8e text.
*1
)uto ,pdate
T0e Concept
H/uto 2pdateH is a po4erful concept. 2sin$ t8is option 6ou 4ill )e a)le to 2pdate 6our
customers automaticall6 from t8e 0nternetI or from a central file ser+er K 48en e+er 6ou
8a+e a ne4 +ersion of 6our soft4are a+aila)le.
uto #n9or&
H/uto 0nformH 4ill onl6 0nform 6our user a)out a ne4 updateI and prompt 8im to do4nload
t8e ne4 update from t8e internet usin$ t8e )ro4ser.
uto #n9or& is descri)ed in detail at t8e end of t8is document.
##S Ser%er
0f 6ou are 8ostin$ 6our 4e)site on an 00S ser+erI 6ou 4ill 8a+e to set some ne4 .0.'
t6pes for H/uto 2pdateH 7 H/uto 0nformH to 4or- properl6. !or more information read t8e
follo4in$ pa$eD 444.pantara6.com<iis.8tml.
#-P<"3=3 / H/uto 2pdateH and H/uto 0nformH are a+aila)le onl6 in t8e P31 +ersion.
Ho. Does it !or&;
&8en 6ou add /uto2pdate option to 6our setupI GSetup 4ill add a small /$ent to t8e
Setup deli+er6. 58is /$ent is placed durin$ setup in t8e H/pplication !olderH.
58e /$ent is installed in suc8 a 4a6 t8at it 4ill run in parallel to 6our pro$ram.
58e /$ent 4ill connect to t8e 0nternet from time to time and c8ec- if a ne4 +ersion is
a+aila)le.
0f a ne4 +ersion is foundI t8e /$ent 4ill do4nload it usin$ H55P protocolI and place it in
t8e /pplication director6.
&8en do4nload is completeI t8e /$ent 4ill perform t8e follo4in$ stepsD
0nstruct 6our application to s8ut itself do4n Mif neededN.
'xtract all reEuired files from t8e do4nloaded file.
3un t8e update setup and replace old files 4it8 ne4 ones.
3estart 6our application Mif neededN.
#-P<"3=3 / &indo4s does not allo4 to o+er4rite a runnin$ executa)le MT.'"'I T.DLLI
T.1C"I etc...N.
Terms in ,se
<riginal Setup K 58e )asic setup 6ou distri)ute to 6our customersI compiled 4it8
HGSetup 0nstallation SuiteH.
,p*ate Setup K 58e collection of files t8at 4ill )e deli+ered to 6our customers durin$
t8e /uto 2pdate process.
5uto 7p6ate *2
General
0n t8is area 6ou 4ill enter data reEuired for )ot8 t8e H1ri$inal SetupH and t8e H2pdate
SetupH.
#-P<"3=3 / Lou .2S5 fill all t8e data items in t8is area )efore 6ou proceed to t8e
ot8er areas.
=a&e o9 ,PD3$ ProjectA
'nter 8ere a file name 4it8out extension. 58is name 4ill later on )e used to define (
different files. 0f 6ou use t8e name HP8one,oo-2pdateH t8en t8e follo4in$ files 4ill )e
producedD
Phone(oo2,p*ate.$:$ K t8e /uto2pdate /$ent.
Phone(oo2,p*ate.<"#G#=> K / small text file t8at 4ill )e added to t8e 1ri$inal
Setup. 58is file contains information reEuired for t8e /uto 2pdate procedure. 58is
file 4ill )e created 48en 6ou compile t8e 1ri$inal Setup.
Phone(oo2,p*ate.#=F< K / small text file t8at 4ill )e added to t8e 2pdate
SetupI 58is file contains information reEuired for t8e /uto 2pdate procedure. 58is
file 4ill )e created 48en 6ou compile t8e 2pdate Setup. 58is file 4ill )e
do4nloaded from t8e 0nternet to c8ec- if ne4 update is a+aila)le.
Phone(oo2,p*ate.,PD3$ K 58is file 4ill include t8e actual data of t8e updateI
and 4ill also )e do4nloaded from t8e 0nternet.
Downloa* ,"> o9 ,PD3$ Project
58is is t8e 23L 6ou 4ill use to post t8e 0!1 file and t8e 2PD/5' file once a ne4 update
is a+aila)le for do4nload.
58is must )e an H55P url.
'xampleD httpA00www.&icroso9t.co&0*ownloa*
58is 23L can )e t8e same one 6ou are usin$ to 8ost 6our 1ri$inal Setup.
Lou can also specif6 8ere a normal director6 pat8. 58is option is useful if 6ou 4ant
to perform /uto 2pdate from a central file ser+er.
Secret 3o2en
58e secret to-en is a means for added securit6. 0t is encr6pted and em)edded in )ot8
t8e 1ri$inal Setup and t8e 2pdate Setup. 2pdate 4ill onl6 ta-e place if t8e HSecret
5o-enH of )ot8 setups matc8.
'nter 8ere an6 text 6ou 4ant.
#-P<"3=3 K for added securit6I t8e Secret 5o-en is stored in 6our re$istr6 K not t8e
GSP file.
5a-e care to store a cop6 of t8e Secret 5o-en in a safe place 48ere 6ou can reco+er itI
in case 6our re$istr6 is dama$ed.
** 2nown e'tensions to 9iles C##S Ser%erD
58e 00S Ser+er 4ill not allo4 )6 default to do4nload files 4it8 t8e extensions H.0!1HI
H.2PD/5'H 7 H.0!13.H.
0f 6ou are placin$ 6our files on an 00S ser+erI 4e recommend t8at 6ou c8ec- t8is option.
58is option 4ill modif6 t8e extensionD
5uto 7p6ate *(
H.0!1H to H.0!1.5"5H.
H.2PD/5'H to H.2PD/5'.,0H.
H.0!13.H to H.0!13..5"5H.
#-P<"3=3 / t8is option s8ould )e used onl6 on ne4l6 created setups.
+riinal Setup
5o ma-e 6our application H/uto 2pdateH or H/uto 0nformH ena)led 6ou must plan a8ead. 0n
t8is area 6ou 4ill enter t8e information reEuired for 6our application to /uto 2pdate itself
form t8e 0nternet in t8e future.
/ll data 6ou enter 8ere 4ill )e stored in t8e 1ri$inal Setup files.
uto ,p*ate $na)le
C8ec- t8is C8ec-,ox to ma-e 6our application H/uto 2pdateH or H/uto 0nformH ena)led.
Pro)e 9or =ew ,p*ate
Determine 8ere 8o4 often t8e /$ent 4ill test for a ne4 +ersion.
5o reduce 0nternet traffic 4e recommend t8at 6ou use HPro)e !reEuenc6H t8at is not less
t8en 1 8our.
0f 6ou select H1nl6 at /$ent StartH t8en t8e /$ent 4ill pro)e onl6 once K just after it 4as
started.
0f 6ou select H'='3H t8en t8e /$ent 4ill '='3 pro)e automaticall6I t8is option is
a+aila)le for /d+anced users. 5o read a)out /d+anced options $o to H/d+anced /uto
2pdateH.
6ersion o9 <riginal Setup
Set 8ere a num)er t8at 4ill represent t8e current +ersion of 6our Setup. &e su$$est t8at
6ou start 4it8 C1D.
1nl6 /uto2pdates t8at are mar-ed 4it8 H0>H'3 num)er 4ill )e do4nloaded.
&e use 8ere onl6 P23' num)ers M1I #I % etc...N for clarit6 and dependa)ilit6.
"es2 to ,p*ate a9ter
/ user ma6 decline 48en reEuested to confirm /uto 2pdate.
0f 6ou set 8ere a +alue $reater t8en OeroI t8en t8e /$ent 4ill reEuest for permission to
update after t8e set da6s 8a+e passed from t8e pre+ious attempt.
0f 6ou set 8ere a +alue of Oero t8e user 4ill )e prompted to update onl6 1C' for eac8
ne4 update +ersion.
"un uto ,p*ate gent at Start,p
0f 6ou C8ec- t8is option t8en t8e /$ent 4ill start runnin$ as soon as 6our customer )oot
t8eir PC.
/not8er option 4ill )e explained later.
** uto ,p*ate Shortcut
0f 6ou C8ec- t8is option t8en 6our user 4ill 8a+e t8e option to manuall6 c8ec- for ne4
update from t8e Start<Pro$ram menu.
Set Shortcut Fol*er
2sin$ t8is option 6ou can specif6 a su)Kfolder in t8e Start<Pro$ram menu to locate t8e
S8ortcut.
5uto 7p6ate *)
1reate uto ,p*ate >og
0f 6ou C8ec- t8is option t8en t8e /$ent 4ill produce a lo$ file t8at 4ill record all a$ent
acti+ities.
58is lo$ 4ill )e located in t8e same director6 48ere t8e /$ent is located.
&e recommend t8at 6ou ena)le t8is option onl6 48en 6ou de)u$ 6our setup.
Time to ,pdate
Se+eral 4ee-s or mont8s 8a+e passed. Lou alread6 8a+e a ne4 +ersion and 6ou 4ant to
/uto2pdate all 6our customers.
58ere are # options for creatin$ t8e 2pdate fileD
2se t8e same Setup file t8at 6ou use to distri)ute t8e ne4 +ersion MSin$le file or
Split fileN.
Create an 2PD/5' !ile t8at 4ill )e deli+ered onl6 to 6our old customers.
0n )ot8 cases ma-e sure 6ou increment t8e +alue at H=ersion of 1ri$inal SetupHI so t8at
t8e ne4 update )ecomes 130>0/L for t8e next future update.
,pdate Setup
&8en 6ou prepare an 2pdate deli+er6I 6ou actuall6 prepare # files. /ssumin$ 6our .edia
file 8as t8e name HP8one,oo-SetupH and t8e 2PD/5' Project name is
HP8one,oo-2pdateH t8en t8e follo4in$ files 4ill )e createdD
HP8one,oo-2pdate.0!1H K 58is is a small text file t8at 4ill )e do4nloaded first
from t8e 0nternet )6 t8e /$ent. ,ased on t8e information in t8is fileI t8e /$ent 4ill
decide if t8e ne4 update is rele+ant for furt8er processin$.
58e second file is t8e file t8at includes t8e actual data reEuired for t8e update. !or
description of t8is file read t8e next para$rap8.
Select ,PD3$ File
0n t8is Com)o,ox 6ou 4ill 8a+e t8e option to select one out of % files. /ssumin$ 6our
.edia file 8as t8e name HP8one,oo-SetupH and t8e 2PD/5' Project name is
HP8one,oo-2pdateH t8en 6ou 4ill )e presented 4it8 t8e follo4in$ optionsD
P8one,oo-2pdate.2PD/5'
P8one,oo-Setup.'"'
P8one,oo-Setup.SPL05
58e first option is a special file t8at 4ill )e created 48en 6ou clic- t8e ?1o&pile@ )utton.
58e second option is t8e re$ular setup file 6ou created to distri)ute 6our ne4 +ersionI
compiled as S0>L' Self'xtract file.
58e t8ird option is t8e re$ular setup file 6ou created to distri)ute 6our ne4 +ersionI
compiled as SPL05 setup.
"unning Process
'nter 8ere t8e name of t8e pro$ram t8at must )e S51PP'D )efore t8e actual update
)e$ins. ormall6 6ou 4ill enter 8ere t8e name of t8e 5ar$et 'xecuta)le.
0f t8ere is no need to s8ut do4n an6 pro$ramI lea+e t8is text empt6.
Shut Down -etho*
Specif6 8ere 8o4 to S8ut Do4n t8e 3unnin$ Process.
58e follo4in$ options are a+aila)leD
DonJt s8ut do4n.
5uto 7p6ate *5
&ait for process to close on its o4n K 58is is $ood for pro$rams t8at are started
and stopped se+eral times e+er6 da6.
0ssue a .essa$e ,ox K 0n t8is case t8e /$ent 4ill issue a messa$e )ox reEuestin$
t8e user to s8ut do4n t8e application )efore /uto 2pdate starts.
2sin$ &.ACL1S' K t8e /$ent 4ill send &.ACL1S' messa$e to t8e applicationI
orderin$ it to orderl6 s8ut itself do4nI and pro)a)l6 $i+in$ t8e user t8e c8ance to
sa+e all open files )efore s8ut do4n.
2sin$ &.AG205 K t8e /$ent 4ill send &.AG205 messa$e to t8e applicationI
orderin$ it to s8ut itself do4nI pro)a)l6 $i+in$ t8e user 1 c8ance to sa+e all open
files )efore s8ut do4n.
2sin$ 5erminate Process K 58is is t8e )rute force optionI 58is is t8e met8od
&indo4s is usin$ to force a process to s8ut itself do4n.
"e8uest 1on9ir&ation )e9ore Downloa*
0f t8is option is C8ec-edI a messa$e )ox 4ill appear reEuestin$ t8e user to confirm t8e
do4nload.
0f Force is c8ec-ed t8e user 4ill not 8a+e t8e option to a)ort t8e process.
"e8uest 1on9ir&ation )e9ore #nstall
0f t8is option is C8ec-edI a messa$e )ox 4ill appear reEuestin$ t8e user to confirm t8e
installation.
0f Force is c8ec-ed t8e user 4ill not 8a+e t8e option to a)ort t8e process.
Per9or& (ac2groun* ,p*ate
0f t8is option is C8ec-edI t8e 48ole update process 4ill )e performed in t8e )ac-$round.
#n9or& ,ser when ,p*ate is Finishe*
0f t8is option is C8ec-edI t8en once t8e update process is finis8ed t8e /$ent 4ill displa6 a
messa$e.
"estart Process when ,p*ate is Finishe*
0f t8is option is c8ec-edI t8e /$ent 4ill restart t8e 3unnin$ Process at t8e end of t8e
2pdate process. 3estart 4ill ta-e place onl6 if t8e /$ent 8as actuall6 s8ut do4n t8e
process pre+iousl6.
6ersion o9 =ew ,p*ate
'nter 8ere a num)er t8at 4ill represent t8e +ersion of t8e ne4 release. 58e num)er 6ou
enter 8ere .2S5 )e $reater t8en t8e num)er 6ou specified in H6ersion o9 <riginal
SetupL 48en 6ou created t8e 1ri$inal Setup.
&e use 8ere onl6 P23' num)ers M1I #I % etc...N for clarit6 and dependa)ilit6.
6ali* 9or 6ersionsA
Specif6 8ere all t8e old +ersions t8at t8e current deli+er6 can /uto2pdate.
$'a&pleA
K Lour current +ersion is (.
K Lou alread6 released =ersions 1I# 7 % to t8e pu)lic.
K 58e current +ersion can onl6 safel6 update +ersionsD # 7 %.
5uto 7p6ate **
K 0n t8is case enter 2M3 in t8is field.
0f 6ou lea+e t8is field empt6I t8en /LL pre+ious +ersions 4ill )e updated.
3est -o*e
&8en 6ou create an /uto 2pdate deli+er6I 6ou o)+iousl6 4ant to test it )efore 6ou send it
to 6our customers. 5o test it 6ou 4ill 8a+e to run a cop6 of t8e older +ersion on 6our PCI
and t8en upload t8e update deli+er6 to t8e internet. t8e pro)lem 4it8 t8is scenario is t8at
48ile 6ou are still testin$I 6our customers 4ill also do4nload t8e ne4 update and install it
e+en )efore 6ou conclude t8e test.
5o a+oid t8is scenarioI c8ec- t8e H5est .odeH C8ec-,ox.
&8en H5est .odeH is c8ec-ed an6 /$ent runnin$ on 6our computer 4ill loo- for t8e
.0!1 file in t8e HProject Director6H on 6our local HardDis-. 58is 4a6 6ou can test t8e
ne4 setup 4it8out 2ploadin$ it to t8e internet.
1o&pile
Clic- t8is )utton to create t8e 0!1 file. 58e name of t8is file 4ill )e t8e one stated under
Hame of 2PD/5' ProjectH. 0f 6ou selected to deli+er t8e data in a .2PD/5' file t8en t8is
file 4ill also )e compiled.
,ploa*
Clic- t8is )utton to 2PL1/D t8e .0!1 file and t8e selected data file to t8e 4e) usin$
!5P protocol.
6eri9y ,">
2se t8is dialo$ to +erif6 t8at t8e 23Ls 6ou specified for t8e 0!1 7 D/5/ files are
correct.
58is dialo$ 4ill onl6 test 05'3'5 23Ls.
Please remem)er to test t8e 23Ls e+en )efore 6ou release t8e ori$inal +ersion of 6our
soft4are.
-unnin t0e )uto,pdate )ent
/s explained a)o+eI t8e /uto2pdate /$ent must )e set to run on 6our customers PC for
t8e /uto2pdate process to function.
/s explained under "un uto,p*ate at Start,pM 6ou can instruct t8e setup pro$ram to
ma-e t8e a$ent run at &indo4s startup. /not8er 4a6 4ould )e to start it from 6our
pro$ram usin$ t8e &in'xec command under &indo4s.
$'a&pleA
0f t8e Hame of 2PD/5' ProjectH is HP8one,oo-2pdateH t8en t8e /$ent name is
HP8one,oo-2pdate.'"'H. /dd to 6our pro$ram a line similar to t8e follo4in$D
WinExec("Phoneoo!"#$%&e'E(E")*+;
0f t8e /$ent is located in a parent director6 relati+e to 6our applicationI use a line similar
to t8e follo4in$D
WinExec("''\Phoneoo!"#$%&e'E(E")*+;
0f t8e /$ent is located in a c8ild director6 )6 t8e name """ use a line similar to t8e
follo4in$D
WinExec("(((\Phoneoo!"#$%&e'E(E")*+;
5uto 7p6ate *,
Lou can also S51P t8e a$ent from inside 6our pro$ram usin$ a line similar to t8e
follo4in$D
WinExec("Phoneoo!"#$%&e'E(E -STOP.*")*+;
if 6ou use a line similar to t8e follo4in$I t8en t8e /$ent 4ill stop %00 seconds /!5'3
issuin$ t8e commandD
WinExec("Phoneoo!"#$%&e'E(E -STOP./**")*+;
if 6ou use a line similar to t8e follo4in$I t8en t8e /$ent 4ill perform a test in t8e
)ac-$round and exit immediatel6 after t8e test.
WinExec("Phoneoo!"#$%&e'E(E -TEST.0")*+;
if 6ou use a line similar to t8e follo4in$I t8en t8e /$ent 4ill perform a test in t8e
fore$round K displa6in$ +arious dialo$s durin$ t8e process K and exit immediatel6 after
t8e test.
WinExec("Phoneoo!"#$%&e'E(E -TEST.1")*+;
)d#anced )uto ,pdate
GSetup includes a compre8ensi+e /P0 t8at 4ill let 6ou control t8e /uto 2pdate /$ent
from 4it8in 6our 3unnin$ /pplication. 5o read a)out t8is option $o to H/d+anced /uto
2pdateH.
)uto *nform
H/uto 0nformH is Euite similar to H/uto 2pdateH.
58e first # steps are identical. Sust li-e in H/uto 2pdateH 6ou must fill t8e first # areas
H>eneralH 7 H1ri$inal SetupH as explained a)o+e.
&8en 6ou 8a+e a ne4 +ersion a+aila)le 6ou must prepare t8e follo4in$D
1. Create a stand alone setup as an '"' file and upload it to 6our 4e)site.
#. Prepare a special do4nload pa$e on 6our 4e)site 4it8 a lin- to t8e ne4 setup
executa)le.
%. Prepare an 35! or 5"5 file t8at 4ill descri)e t8e ne4 update.
1n t8e H/uto 2pdateH area select t8e H/uto 0nformH ta) and do t8e follo4in$D
1. C8ec- t8e HSelect 0!13. !ileDH option.
#. Clic- t8e Q...R )utton and select t8e 35! or 5"5 file 6ou prepared.
%. Set t8e si9e of t8e messa$e 6our user 4ill see.
(. C8ec- t8e HDo4nload 23LDH option.
*. 'nter t8e full 23L to t8e do4nload pa$e 6ou prepared.
Pre%iew
o4 Clic- t8e QPre+ie4...R )utton.
GSetup 4ill displa6 a special dialo$ displa6in$ t8e 35! or 5"5 file 6ou created.
Clic- t8e QDo4nload...R )utton on t8e dialo$ and t8e )ro4ser 4ill open 4it8 t8e pa$e 6ou
indicated as t8e HDo4nload 23LH.
6ersion o9 =ew ,p*ate
Set t8is +alue as descri)ed a)o+e for H/uto 2pdateH.
6ali* 9or 6ersionsA
Set t8is +alue as descri)ed a)o+e for H/uto 2pdateH.
5uto 7p6ate *3
1o&pile
Clic- t8is )utton to create t8e 0!1 7 0!13. files. 58e names of t8e files 4ill )e t8e one
stated under Hame of 2PD/5' ProjectH.
,ploa*
Clic- t8is )utton to 2PL1/D t8e .0!1 7 .0!13. files to t8e 4e) usin$ !5P protocol.
6eri9y ,">
2se t8is dialo$ to +erif6 t8at t8e 23Ls 6ou specified for t8e 0!1 7 0!13. files are
correct.
58is dialo$ 4ill onl6 test 05'3'5 23Ls.
Please remem)er to test t8e 23Ls e+en )efore 6ou release t8e ori$inal +ersion of 6our
soft4are.
*9
'ere 'odules
/ H.er$e .oduleH M.msm fileN is a sin$le pac-a$e t8at includes all filesI resourcesI re$istr6
entriesI and setup lo$ic to install a s8ared component. / .er$e .odule is intended to )e
em)edded in an .S0 file.
.S0 stands for H.icrosoft 0nstallerH M&8ic8 4as later renamed )6 .icrosoft to H&indo4s
0nstallerHN.
.S0 is a ne4 0nstallation tec8nolo$6 de+eloped )6 .icrosoft.
.S0 is a+aila)le )6 default in t8e follo4in$ &indo4s +ersionsD &in.'I &in#000I &in"PI
&in#00% 7 =ista.
0t is also a+aila)le as a free do4nload from t8e .icrosoft 4e)site for earlier +ersions of
&indo4s.
.icrosoft and ot8er soft4are companies are no4 distri)utin$ s8ared soft4are components as
H.er$e .odulesH
0f 6ou 4ant to distri)ute a H.er$e .oduleH to 6our customers as part of 6our setup fileI t8e
H.er$e .oduleH must )e 4rapped in an .S0 file 48en t8e file.
0.P135/5 K 58e H#er.e #o6u"es: option is a%ai"a&"e on"y in the PR; %ersion.
)dd 'ere 'odule
5o add a H.er$e .oduleH file to 6our setup clic- Q/dd 0tem...R and select t8e .S. file 6ou
4ant M6ou ma6 add more t8en one fileN.
+ptions
#nstall t
58e .S0 file 4ill )e installed durin$ t8e HCop6 !ilesH sta$e of t8e setup. Lou ma6 select
one of t4o optionsD
Cop6 Start K Sust )efore t8e first file is copied to t8e tar$et director6.
Cop6 end K Sust after t8e last file is copied to t8e tar$et director6.
,n#nstall t
Lou ma6 select one of t8ree options for t8e 2n0nstallation of t8e .er$e .oduleMsN.
0$nore K DonJt 2n0nstall t8e .er$e .oduleMsN.
2n0nstall Start K 58e first item to )e uninstalled from t8e PC.
2n0nstall 'nd K 58e last item to )e uninstalled from t8e PC.
Display <ptions
5i**en K DonJt s8o4 an6 .S0 dialo$ durin$ Setup 7 2n0nstall.
Passi%e K S8o4 a limited .S0 Dialo$ durin$ Setup 7 2n0nstall Mpro$ress )ar onl6N.
Full K S8o4 t8e full .S0 dialo$ durin$ Setup 7 2n0nstall
lways "ecreate -S# File
&8en t8is option is c8ec-ed t8e .S0 file 4ill )e recreated e+er6 time 6ou compile t8e
setup.
#er.e #o6u"es ,0
-S# File =a&e
,6 default GSetup 4ill offer a name for t8e .S0 fileI 8o4e+er 6ou ma6 modif6 t8e name
as 6ou 4is8.
/fter 6ou 8a+e selected all t8e options accordin$ to 6our preferencesI clic- t8e QCompileR
)utton.
GSetup 4ill create t8e .S0 file Mif neededN and proceed to compile t8e setup file as usual.
Durin$ compilation GSetup 4ill em)ed t8e .S0 file in t8e setup and later on durin$ setup
GSetup 4ill run t8e .S0 file on t8e tar$et PC.
Set Parameters
Some .er$e .odules introduce parameters t8at 6ou can set )efore 6ou compile 6our
setup.
Hi$8li$8t t8e t8e .er$e .odule name and clic- t8e QSet Parameters...R )utton.
0n t8e dialo$ t8at opens scroll t8rou$8 t8e list of parameters and set e+er6 parameter as
reEuired
Test
1reate -S# File
Clic- t8is )utton to create t8e .S0 file. 58e file 4ill )e stored in t8e Project director6 48ere
t8e Setup file is normall6 created.
#nstall -S# File
Clic- t8is )utton to test t8e ne4l6 created .S0 file. &8en 6ou clic- t8is )uttonI t8e .er$e
.odules 6ou are usin$ 4ill )e actuall6 installed on 6our PC.
,n#nstall -S# File
Clic- t8is )utton to 2n0nstall t8e .S0 file 6ou just install. 0t is al4a6s recommended t8at
after 6ou install t8e .S0 file for testin$I 6ou 4ill also 2n0nstall it. Mormall6 an .S0 file can
not )e installed t4ice 4it8out first )e 2n0nstalledN.
&8en t8e #nstall 7 ,n#nstall operation is completeI a special H3esult .essa$eH 4ill
appear 4it8 t8e operation result.
!or H.S0 'rror CodesH clic- t8e follo4in$ lin-D
444.pantara6.com<msiAerrorAcodes.8tml
,1
,n*nstall
Create ,n*nstall
1reate uto&atic ,n#nstall
0f t8is option is c8ec-ed t8en GSetup 4ill create an 2n0nstall option for t8e pro$ram 6ou
are installin$. ormall6 t8e user 4ill call t8is option from t8e H/dd<3emo+e Pro$ramsH
dialo$ of t8e HControl PanelH.
Lou ma6 also instruct t8e pro$ram to add an 2n0nstall s8ortcut to t8e Start<Pro$ram
menuI )6 c8ec-in$ t8e H/dd 2n0nstall S8ortcutH C8ec-)ox found on t8e HS8ortcutH
pa$e.
Scra&)le Data File
&8en t8e Setup pro$ram is runnin$ it creates a data file t8at is later used for t8e
2n0nstall pro$ram. 0f t8is option is c8ec-edI t8e file 4ill )e scram)led.
5i*e $rror -essage at en* o9 ,n#nstall
0f 'rrors occurs durin$ t8e 2n0nstall processI GSetup 4ill displa6 an error messa$e.
C8ec- t8is option if 6ou 4ant to 8ide t8is 'rror .essa$e.
5i*e >og (utton at en* o9 ,n#nstall
0f 'rrors occurs durin$ t8e 2n0nstall processI GSetup 4ill displa6 Lo$ ,utton on t8e
2n0nstall dialo$. C8ec- t8is option if 6ou 4ant to 8ide t8is Lo$ ,utton.
Per9or& Silent ,n#nstall
&8en t8is option is c8ec-edI t8e 2n0nstall pro$ram 4ill run 4it8out inter+ention of t8e
user.
Lou can ac8ie+e t8e same effect )6 addin$ 0silent parameter on t8e commandKline of
t8e 2n0nstall pro$ram.
Per9or& 5i**en ,n#nstall
&8en t8is option is c8ec-edI t8e 2n0nstall pro$ram 4ill run completel6 in t8e
)ac-$roundI presentin$ no dialo$ durin$ t8e process.
Lou can ac8ie+e t8e same effect )6 addin$ 0hi*e parameter on t8e commandKline of
t8e 2n0nstall pro$ram.
,n#nstall $'e Sta&p
&8en addin$ 2n0nstall optionI GSetup add a file )6 t8e name unA?????A.exe
to t8e setup deli+er6.
58is file is actuall6 t8e 2n0nstallation pro$ram.
58e ????? part is actuall6 t8e H.edia !ile ameH as defined on t8e HProjectH
pa$e.
58e part of t8e name is calculated from t8e tar$et executa)le file
name.
2sin$ t8is s6stem 6ou can install se+eral pro$rams into one director6 and eac8
one 4ill 8a+e its o4n 2n0nstall pro$ram.
58e H2n0nstall 'xe ameH option 4ill let 6ou specif6 manuall6 a specific name.
Set ,n#nstall $'e Dir
,6 default t8e 2n0nstall files M'"' 7 5"5N 4ill )e placed in t8e @/pplication !olderC
durin$ setup.
2se t8is option to set anot8er location for t8e 2n0nstall files.
7n!nsta"" ,2
,n*nstall S0ortcut
** ,n#nstall Shortcut
0f 6ou c8ec- t8is C8ec-)oxI t8e setup pro$ram 4ill add an H2n0nstallation S8ortcutH to
t8e Start<Pro$ram menu. !or t8is item to )e acti+eI 6ou must c8ec- t8e HCreate
/utomatic 2n0nstallH C8ec-)ox in t8e HS4itc8esH pa$e.
Set Shortcut Su) Fol*er
2sin$ t8is option 6ou can specif6 a su)Kfolder in t8e Start<Pro$ram menu to locate t8e
S8ortcut.
Force "e&o%e -ain Shortcut Fol*er
ormall6 t8e 2n0nstall pro$ram 4ill attempt to remo+e t8e main s8ortcut folder.
0f t8e user 8as added manuall6 some more s8ortcuts to t8is !olderI or anot8er
installation pro$ram 8as placed s8ortcuts in t8e same !olderI t8e !older 4ill 15 )e
remo+ed durin$ 2n0nstall.
Lou can !13C' t8e 2n0nstall pro$ram to remo+e t8is folder )6 c8ec-in$ t8is option.
)dd2-emo#e Prorams
** Shortcut to L**0"e&o%e Progra&sL
C8ec- t8is option to add an 2n0nstall s8ortcut to t8e H/dd<3emo+e Pro$ramsH dialo$.
** L1hangeL (utton
C8ec- t8is option to add a 1hange )utton to t8e 2n0nstall entr6 in t8e H/dd<3emo+e
Pro$ramsH dialo$.
Display =a&e
,6 default GSetup 4ill use t8e HPro$ram Descripti+e ameH as t8e Displa6 ame of
t8is s8ortcut.
2se t8is option to specif6 a different name.
Display #con
2se t8is option to set a specific 0con for t8is s8ortcut.
Support #n9or&ation ,">
/dd 8ere a 23L t8at 4ill lead to t8e support information pa$e on 6our 4e)site.
Pro*uct ,p*ates ,">
/dd 8ere a 23L t8at 4ill lead to t8e product updates pa$e on 6our 4e)site.
,(
Directories
0n se+eral places in t8e pro$ram MH!ilesH pa$eI H3e$istr6H pa$eI H0ni!ileH pa$eI H'n+ironmentH
pa$eI H'xecuteH pa$eI etc...N 6ou 4ill find a Com)o,ox 4it8 a list of aliases for some
predefined directories. 58e Com)o,ox is accompanied )6 an adjacent 'dit)ox 4ere 6ou
s8ould enter t8e rest of t8e director6 definition.
58e directories s8ould )e interpreted as follo4sD
H)soluteDirK 3efer to t8e definition in t8e 'dit)ox as an a)solute director6.
H#nstallDirK 58e tar$et installation director6 as defined under H/pplication !olderH in
t8e H!ilesH pa$e of t8e Composer. 0f t8e user selects a different
destination director6I t8e content of t8is alias 4ill c8an$e accordin$l6.
H#nstall1o&&onDirK 58e tar$et installation director6 as defined under HCommon !olderH in t8e
H!ilesH pa$e of t8e Composer.
H#nstallu'DirK 58e tar$et installation director6 as defined under H/uxiliar6 !olderH in t8e
H!ilesH pa$e of t8e Composer.
H;inDirK 58e &indo4s director6 K normall6 HCD;&indo4sH.
H;inSys32DirK 58e S6stem Director6 K normall6 HCD;&indo4s;S6stem%#H.
H;inSys16DirK 58e 1LD S6stem Director6 K normall6 HCD;&indo4s;S6stemH.
HProgra&FilesDirK 58e HPro$ram !ilesH director6 as indicated in t8e 3e$istr6 K normall6
HCD;Pro$ram !ilesH.
H1o&&onFilesDirK 58e HCommon !ilesH director6 as indicated in t8e 3e$istr6 K normall6 HCD;
Pro$ram !iles;Common !ilesH.
HFontDirK 58e director6 48ere &indo4s stores font files K normall6
HCD;&indo4s;!ontsH.
HSrcDirK 58e director6 48ere t8e Setup or 2n0nstall pro$ram is no4 runnin$ from.
H3e&pDirK 58e &indo4s 5'.P director6 K normall6 HCD;&indo4s;5'.PH.
H,serDirK 58e 2ser Home director6 K normall6 HCD;Documents and
Settin$s;2serameH.
H<riginDirK 58e director6 48ere t8e ori$inal setup file 4as runnin$ from K normall6 it
4ill )e t8e CDK31..
HSer%iceDirK 58e director6 48ere Ser+ice !iles for t8e H'xecute 'n$ineH 4ill )e found.
H#nstallDri%eK 58e Dri+e of t8e tar$et installation director6 @0nstallDirC K normall6 HCD;H.
H;inDri%eK 58e Dri+e 48ere &indo4s is installed K normall6 HCD;H.
H;inSysDri%eK 58e Dri+e 48ere t8e S6stem director6 is located K normall6 HCD;H.
H<riginDri%eK 58e Dri+e 48ere t8e ori$inal setup file 4as runnin$ from K normall6 it 4ill
)e t8e CDK31. dri+e M'D;N.
H#nstallDis2K 58e Dis- of t8e tar$et installation director6 @0nstallDirC K normall6 HCDH.
H;inDis2K 58e Dis- 48ere &indo4s is installed K normall6 HCDH.
H;inSysDis2K 58e Dis- 48ere t8e S6stem director6 is located K normall6 HCDH.
H<riginDis2K 58e Dis- 48ere t8e ori$inal setup file 4as runnin$ from K normall6 it 4ill
)e t8e CDK31. dri+e M'DN.
Directories ,)
@2ser/ppDataDirC
@2serLocal/ppDataDirC
@.6DocumentsDirC
@2serStart.enuDirC
@2serStartPro$ram.enuDirC
@2serDes-topDirC
@/ll2sersDirC
@/ll2sers/ppDataDirC
@/ll2sersDocumentsDirC
@/ll2sersStart.enuDirC
@/ll2sersStartPro$ram.enuDirC
@/ll2sersDes-topDirC
@Documents/ndSettin$sDirC
H"un3i&eDirI1K 58e director6 4ill )e located on t8e tar$et PC at runtimeI )ased on its
name or content.
H"un3i&eDirI2K 58e director6 4ill )e located on t8e tar$et PC at runtimeI )ased on its
name or content.
...
H"un3i&eDirI+K 58e director6 4ill )e located on t8e tar$et PC at runtimeI )ased on its
name or content.
<-unTimeDir=>?
2sin$ @3un5imeDirABC 6ou can instruct GSetup to locate a specific director6 at runtime
Mt8at is K 48en t8e setup is runnin$ on 6our customerJs PCN K )ased on files found in t8at
director6 or t8e name of t8e director6 or some 3e$istr6 information.
2pto 8 3un5ime directories ma6 )e defined 4it8 t8e namesD H"un3i&eDirI1KM
H"un3i&eDirI2K ... H"un3i&eDirI+K.
5o define an6 of t8ose directories clic- t8e correspondin$ )utton on t8e Files pa$e.
1nce 6ou define a 3un5ime director6I 6ou can use it in t8e Files pa$e as 4ell as in t8e
$'ecute 7 #niFile pa$es.
GSetup 4ill attempt to find t8e 3un5ime director6 usin$ ( met8odsD
1. Search 9or pplication Directory in the "egistry
&8en t8is met8od is selectedI GSetup 4ill attempt to read t8e director6 from t8e
follo4in$ -e6 in t8e 3e$istr6D
H:'LAL1C/LA./CH0';Soft4are;.icrosoft;&indo4s;Current=ersion;/p
p Pat8s;Pro$'xe
58is met8od is +er6 effecti+e for ,0> applications li-e &in&ord.exe 7 'xcel.exe.
&8en selectin$ t8is option enter t8e executa)le file name 4it8 extension as
parameterD
SampleD winwor*.e'eI e'cel.e'eI etc...
58is searc8 is +er6 fast.
2. "ea* Directory na&e 9ro& the "egistry
Directories ,5
&8en t8is met8od is selectedI GSetup 4ill attempt to read t8e director6 directl6 from
t8e 3e$istr6.
2se t8is met8od to read a +alue t8at 4as entered )6 a pre+ious cop6 of 6our
pro$ram or )6 anot8er pro$ram.
'nter 8ere a Eey=a&e and read its *e9ault +alueI or 'nter 8ere a
Eey=a&eU6alue=a&e com)ination and read its +alue.
58is searc8 is +er6 fast.
3. Search 9or Directory o9 Speci9ic File
&8en t8is met8od is selectedI GSetup 4ill attempt to find t8e director6 usin$ a
normal !ind!irst<!indext searc8 pattern.
&8en selectin$ t8is option enter t8e file name 4it8 extension as parameterD
58is searc8 is +er6 slo4.
4. Search 9or FullPath o9 Speci9ic Directory
&8en t8is met8od is selectedI GSetup 4ill attempt to find t8e director6 usin$ a
normal !ind!irst<!indext searc8 pattern.
&8en selectin$ t8is option enter t8e director6 name. !or added securit6 6ou ma6
add t8e pat8 of t8e parent director6.
!or exampleD
48en searc8in$ for <99ice t8e searc8 ma6 findD
HCD;Pro$ram !iles;.icrosoft 1fficeH.
48en searc8in$ for -icroso9tU<99ice t8e searc8 ma6 findD
HDD;Documents and Settin$s;>uest;/pplication Data;.icrosoft;1fficeH.
58is searc8 is Euite slo4.
Lou can use an6 mixture of t8e a)o+e mentioned searc8es.
58e searc8 4ill )e executed in t8e order of t8e dialo$.
1nce a suita)le director6 is foundI t8e searc8 4ill stop.
Lou ma6 also define a default director6 t8at 4ill )ecome effecti+e if no suita)le director6 is
found.
Show -essage
Scannin$ t8e dri+e for a specified director6 is usuall6 a len$t86 operation.
C8ec- t8is option to displa6 t8e messa$e HSearc8in$ for Director6 KKK Please &aitFH
durin$ t8e searc8.
#9 Directory not Foun*
0f t8e @3un5imeDirABC is not found 6ou can instruct t8e Setup pro$ram to issue an
error messa$e and<or a)ort t8e installation.
58e actual test for t8e existence of t8e @3un5imeDirABC is performed just )efore t8e
director6 is needed for t8e first time.
,*
)liases
&8ere e+er it is le$al to enter a director6 alias 6ou ma6 also enter an6 of t8e follo4in$
to-ensD
H,ser=a&eK
58is 5o-en 4ill )e replaced at runtime 4it8 t8e current user name Mnormall6 t8e name
t8e user used at lo$onN.
H>ogge*,ser=a&eK
58is 5o-en 4ill )e replaced at runtime 4it8 t8e current user name Mnormall6 t8e name
t8e user used at 4indo4s installationN.
H1o&pany=a&eK
58is 5o-en 4ill )e replaced at runtime 4it8 t8e current compan6 name Mnormall6 t8e
name t8e user used at 4indo4s installationN.
H1o&puter=a&eK
58is 5o-en 4ill )e replaced at runtime 4it8 t8e current computer name Mt8e name of
t8e computer t8e user is runnin$ on no4N.
H1urrentDo&ain=a&eK
58is 5o-en 4ill )e replaced at runtime 4it8 t8e current domain name Mt8e domain t8e
user used at lo$onN.
H$ntere*,ser=a&eK
58is 5o-en 4ill )e replaced at runtime 4it8 t8e 2ser ame as entered )6 t8e user in
H2ser 0nformationH dialo$.
H$ntere*1o&pany=a&eK
58is 5o-en 4ill )e replaced at runtime 4it8 t8e Compan6 ame as entered )6 t8e user
in H2ser 0nformationH dialo$.
H$ntere*Serial=u&K
58is 5o-en 4ill )e replaced at runtime 4it8 t8e Serial um)er as entered )6 t8e user in
H2ser 0nformationH dialo$.
HDateVJK
2se t8is to-en to enter t8e current date.
58is to-en s8ould 8a+e an6 of t8e follo4in$ s8apesD
HDateV0K 58e num)er of da6s t8at 8a+e elapsed since 01KS/K#000.
HDateV1K #8K0#K07
HDateV2K 0#K#8K07
HDateV3K 07K0#K#8
HDateV4K #8K0#K#007
HDateV5K 0#K#8K#007
HDateV6K #007K0#K#8
HDateV.K #007K0#K#8 1#D%1D*9
H6en*or1o&pany=a&eK
58is 5o-en 4ill )e replaced at runtime 4it8 t8e name of t8e compan6 t8at produced t8e
setup K as entered on t8e HProjectH pa$e.
5"iases ,,
HProject=a&eK
58is 5o-en 4ill )e replaced at runtime 4it8 t8e HProject ameH K as entered on t8e
HProjectH pa$e.
HProgra&Descripti%e=a&eK
58is 5o-en 4ill )e replaced at runtime 4it8 t8e HPro$ram Descripti+e ameH K as
entered on t8e HProjectH pa$e.
HProgra&6ersionK
58is 5o-en 4ill )e replaced at runtime 4it8 t8e HPro$ram=ersionH K as entered on t8e
HProjectH pa$e.
H,n#nstall$'ePathK
58is 5o-en 4ill )e replaced at runtime 4it8 t8e full pat8 of t8e 2n0nstall executa)le.
H>ast$'ecuta)le$'it1o*eK
58is 5o-en 4ill )e replaced at runtime 4it8 t8e 'xit Code of t8e last H3un 'xecuta)leH
command.

,3
'S*
.S0 is an 0nstallation tec8nolo$6 de+eloped )6 .icrosoft.
.S0 stands for H.icrosoft 0nstallerH M&8ic8 4as later renamed )6 .icrosoft to H&indo4s
0nstallerHN.
.S0 is a+aila)le )6 default in t8e follo4in$ &indo4s +ersionsD &in.'I &in#000I &in"P
&in#00% 7 =ista.
0t is also a+aila)le as a free do4nload from t8e .icrosoft 4e)site for earlier +ersions of
&indo4s.

Startin$ from +ersion 9.0 GSetup is a)le to produce setup files in t8e form of an .S0 file.
1nce 6ou define a setup usin$ t8e Composer 6ou can produce )ot8 a classic HSelf 'xtractH
setup in t8e form of an '"' file or an .S0 file. 5o select '"' or .S0 use t8e Com)o,ox
located at t8e (otto&0"ight side of t8e Composer screen.


!0$ 'S*;
.S0 is mainl6 reEuired )6 05 professionals in lar$e or$ani9ations. !or t8e 05 professional
t8e .S0 format offers t8e follo4in$ )enefitsD
Self 8ealin$ K 0f a pro$ram 4as dama$ed on t8e endKuserJs des-topI t8e user
can rerun t8e ori$inal .S0 setup file to initiate an automatic repair process.
.S0 files can )e distri)uted to man6 des-tops in an or$ani9ation usin$ H/cti+e
Director6H.
.S0 file can )e installed )6 a user 48o does not 8a+e administrati+e pri+ile$es.
/n 05 professional can modif6 an .S0 file and adjust it to 8is or$ani9ationJs
reEuirements )efore distri)ution to end users.
58e .S0 !ormat supports a roll)ac- function 48ic8 4ill restore 6our PC to its
ori$inal state if t8e setup process 4as interrupted.

Producin an 'S* file
5o produce an .S0 file usin$ GSetup use t8e follo4in$ procedure.
Define a setup usin$ some or all of t8e pa$es of t8e composer.
>oto t8e ,ottom<Left of t8e Composer screen and select H.S0H in t8e selection
)ox.
Clic- t8e QCompileR )utton.

/s a result of t8is seEuence of operations 6ou 4ill 8a+e a distri)ution file M.edia !ileN
4it8 an .S0 extension in t8e HProject Director6H.

-S# >og
0f 6ou clic- t8e Q3unR )utton and t8e HDe)u$H option is c8ec-ed on t8e HProjectH pa$eI
GSetup 4ill displa6 t8e .S0 lo$ after runnin$ t8e .S0 setup file.

#-P<"3=3 K usin$ t8e same setup definitions 6ou can easil6 produce a classic HSelf
'xtractH setup in t8e form of an '"' file. Sust select H'"'H in t8e selection )ox and clic-
QCompileR.

#! ,9
&8en in .S0 modeI clic-in$ t8e Q3unR )utton 4ill launc8 t8e .S0 file 6ou just compiled.
&8en in .S0 mode 6ou can upload t8e .S0 file 6ou just compiled to t8e 4e) )6 clic-in$
t8e Q2ploadR )utton.

#-P<"3=3 K 0f 6ou 4ant to reinstall an .S0 setup 6ou must first uninstall it. Lou can
uninstall t8e old setup from t8e &indo4s H/dd<3emo+e pro$ramsH dialo$.


'S* #s "X"
2nfortunatel6 not all of t8e features t8at are currentl6 supported )6 t8e GSetup '"'
format are a+aila)le in t8e .S0 format. &e 8ope to add more functionalit6 to our .S0
implementation in future +ersionsI 8o4e+er some features can not )e implemented since
t8e .S0 format 4ill not allo4 t8em.


'issin Features
58e follo4in$ list summari9es t8e features t8e are not a+aila)le in GSetup .S0
implementationD

Project Page
Lan$ua$e Support
Compression Le+el
Create Split Setup
Span CDs
De)u$

Display Page
Displa6 pa$e is not implemented

Files Page
'xclusi+it6 5a$
0nclude >roup )6 Setup um)er
1+er4rite !iles 7 3emo+e Directories are 8andled accordin$ to .S0 policies.

Dialogs Page
/dd 0ma$e
S8o4 Pro$ress ,ar B#
Perform Silent 7 Hidden Setup
CD Setup
S8o4 Compact Setup /lso
!orce Partial Setup
Custom Dialo$s

Switches Page
Create Setup.lo$ !ile
3eEuest Confirmation ,efore 'xtract
Pre+ious 0nstallation MHandled )6 .S0N.
5est for runnin$ executa)le.
3un<3un 1nce.
/uto 3un 5est.

#! 30
Shortcuts Page
Lan$ua$e Support.
Selected )6 'nd 2ser.

"egistry Page
0nstall 3e$ !iles.

Properties Page
Properties Pa$e is not implemented

$'ecute Page
'xecute 'n$ine is not implemented

(ill)oar* Page
,ill)oard in not implemented

uto ,p*ate
/uto 2pdate is not implemented

,n#nstall Page
2n0nstall is 8andled automaticall6 )6 .S0I as a result onl6 fe4 of t8e
parameters in t8e uninstall pa$e are +alid also for .S0.
5ppen6i9es < 5ppen6i9es < 31
)ppendixes @
)dd2,pdate "xecution *tem
0n t8is dialo$ 6ou 4ill define operations to )e performed durin$ t8e Setup or 2n0nstall
process.
Detailed description of all t8e Condition 7 'xecution commands ma6 )e found atD
444.pantara6.com<execute.8tml
*tem Name4
'+er6 execution item must 8a+e a name. 'nter 8ere a name t8at 4ill descri)e t8e function
of t8e execution item.
Perform )t4
Define 8ere at 48at sta$e of t8e process t8e operation 4ill )e performed )6 selectin$ an6
of t8e follo4in$ optionsD
2ndefined Sta$e
Setup Start
Cop6 Start
Cop6 'nd
Setup 'nd
2n0nstall Start
2n0nstall 'nd

,efore 2ser 0nformation


/fter 2ser 0nformation
,efore Setup 56pe
/fter Setup 56pe
,efore Custom
/fter Custom
,efore Destination
/fter Destination
,efore /ssociate
/fter /ssociate
,efore S8ortcuts
/fter S8ortcuts
,efore Complete
/fter Complete
/fter ,ill)oard
,efore Dialo$s
/fter 3e$ Components
5ppen6i9es < 566=7p6ate 19ecution !tem 32
*tem T$pe4
Select from % different item t6pesD
Conditional K 58e operation 4ill )e performed onl6 if certain condition is meet.
2nConditional K 58e operation 4ill )e performed unconditionall6.
&8ile Loop K 58e operation 4ill )e performed repeatedl6 as lon$ as t8e condition is
meet K /D 5H' optionall6 perform anot8er operation.
>oopsA
58is option is +alid onl6 if 6ou selected H&8ile LoopH.
0f 6ou enter 8ere a Oero t8en t8e &8ile Loop 4ill perform as lon$ as t8e condition is
meet Me+en fore+erN.
/n6 num)er $reater t8en 9ero means K t8e loop 4ill perform upto t8is num)er of loops
and t8en exit t8e loop e+en if t8e condition is not meet.
Delay C-SDA
58is option is +alid onl6 if 6ou selected H&8ile LoopH.
Selectin$ an6 num)er $reater t8en 9ero 4ill add a dela6 Min .illiSecondsN )et4een
e+er6 loop iteration.
+nline Help
2se t8is c8ec-)ox to displa6 an online 8elp t8at 4ill descri)e e+er6 Condition or 'xecution
item 48ile 6ou 8o+er t8e mouse o+er t8is item.
Conditions
&e pro+ide t8e follo4in$ predefined conditionsD
Files G Directories
!ile !ound
Director6 !ound
Dri+e !ound
5ext !ound in !ile
!ile !ound MH55PN
!ile /ttri)ute is in
!ile is Loc-ed
pplication
/pplication !ound
/pplication Pat8 !ound
/pplication =ersion is
/pplication is 3unnin$
-iscellaneous 1
'xe is 3unnin$
Ser+ice is 0nstalled
Ser+ice is 3unnin$
1peratin$ S6stem is in
!ile =ersion is
H&indo4 is !ound K M2sin$ t8e !ind&indo4MN /P0 callN
Local Lan$ua$e is in
Selected Lan$ua$e is in
!ile Si9e is M,6tesN
!ile Date and 5ime is
5ppen6i9es < 566=7p6ate 19ecution !tem 3(
0nternet Connection 1:
Last 'xecuta)le 'xit Code is
Printer 0ntalled
"egistry
3e$istr6 :e6 !ound
3e$istr6 =alue !ound
3e$istr6 =alue is
$n%iron&ent
'n+ironment =aria)le !ound
'n+ironment =aria)le 0s
'n+ironment =aria)le 0s M2pCaseN K M0$nore case 48en performin$ t8e c8ec-N.
5ar*ware
.emor6 Si9e is M.,N
CP2 Speed is M.H9N
Screen 3esolution is
Color Dept8 is
Dis- !ree Space is M.,N
:64
3unnin$ on 6( ,it 1S
6( ,it State is 1
-o*ules
.'5 !rame4or- =ersion is in
=isual ,asic 3untime !ound
/D1M.D/CN =ersion is
.SK/CC'SS =ersion is
SGLM.SD'N =ersion is
1D,C 0nstalled
,D' 0nstalled
Direct" =ersion is
.edia Pla6er =ersion is
SD: =ersion is
S3' =ersion is
D/1 0nstalled
=isual SB =ersion is
0nternet 'xplorer =ersion is
!las8 Pla6er =ersion is
/cro)at 3eader =ersion is
SGL 'xpress =ersion is
.S S'5 %.* =ersion is
.S S'5 (.0 =ersion is
00S =ersion is
-iscellaneous 2
/s- Les<o
/s- 1:<Cancel
Setup 56pe is
>roup Selected
/uto 2pdate is 3unnin$
5ppen6i9es < 566=7p6ate 19ecution !tem 3)
,ill)oard is 3unnin$
*&in
2ser ame is K M/s entered in t8e 2ser 0nformation dialo$N.
Compan6 ame is K M/s entered in t8e 2ser 0nformation dialo$N.
Serial um)er is K M/s entered in t8e 2ser 0nformation dialo$N.
2ser is /D.00S53/513
2ser Pri+ile$e is in
1usto& Dialogs
Control 5ext is
Control 5ext is 'mpt6
Control 0tem 0ndex is
Control is C8ec-ed
6aria)les
Compare 1 =aria)le
Compare # =aria)les
5ext !ound in =aria)le
=aria)le !ound in 5ext
=aria)le !ound in =aria)le
=aria)le is 'mpt6
=aria)le Len$t8 is
.ost of t8e conditions accept one ar$umentI some accept # or % ar$uments.
/fter 6ou select a conditionI clic- t8e ,ro4se )utton next to /r$umentK1 or /r$umentK# to
select from t8e a+aila)le ar$uments.
=<3$
pplication / refers to all exe files re$istered in t8e re$istr6 under t8e follo4in$ -e6D
H:'LAL1C/LA./CH0';Soft4are;.icrosoft;&indo4s;Current=ersion;/pp Pat8s
Ser%ice K refers to special pro$rams t8at are installed on 5 class mac8ines and
are automaticall6 started durin$ t8e startup process of t8e computer.
Stop2)nd2+r2Xor
0f 6ou 4ant to com)ine # or % conditions 6ou must define t8e relation )et4een t8em.
0f 6ou are usin$ % conditionsI t8e first t4o 4ill e+aluate first and t8e result 4ill )e e+aluated
a$ainst t8e t8ird condition.
3esultPMM1on*ition/1 /nd<1r<"or 1on*ition/2N /nd<1r<"or 1on*ition/3N
Lou can ne$ate an6 condition )6 c8ec-in$ t8e =ot C8ec-)ox t8at precede it.
0f 6ou 4ant to use onl6 one condition Clic- Stop after t8e first condition.
0f 6ou 4ant to use t4o conditions Clic- Stop after t8e second condition.
Partial 1hec2
&8en 6ou com)ine # or % conditionsI /LL conditions are e+aluated first and 1LL
t8en are related to eac8 ot8er.
,6 C8ec-in$ Partial 1hec2 6ou can a+oid some e+aluations 48en not needed K for
instanceD
0f 6ou 8a+e # conditions 4it8 an <" relation and t8e !irst condition e+aluated to
532'I t8ere is no need to perform t8e second condition )ecause no matter 48at
4ill )e t8e outcome of t8is condition t8e end result 4ill )e 532'.
0f Partial 1hec2 is C8ec-ed K onl6 t8e first condition 4ill )e e+aluated.
5ppen6i9es < 566=7p6ate 19ecution !tem 35
0f Partial 1hec2 is 2nC8ec-ed K )ot8 conditions 4ill )e e+aluated.
"xecutions
&e pro+ide t8e follo4in$ predefined executionsD
Files
Delete !ileMsN
Cop6 !ileMsN
.o+e !ileMsN
3ename !ileMsN
Set !ileMsN /ttri)utes
/llo4 !ull /ccess !ileMsN
Do4nload !ile MH55PN
1pen C/, !ile
Cop6 !ile Dela6ed
>et S8ort Pat8ame
>et 'xpanded Pat8ame
>et et4or- Pat8ame
Directories
Create Director6
3emo+e Director6 K M4ill )e remo+ed onl6 if empt6N.
!orce 3emo+e Director6 K Mfirst 4ill erase all t8e files and t8en remo+e t8e
director6N.
Set &or-in$ Director6
Cop6 Director6 5ree
3ename Director6
Set !older to
Set Setup 56pe
/llo4 !ull /ccess Director6
pplication
Delete /pplication 'xecuta)le
3emo+e /pplication Director6
2n0nstall application
3un /pplication
3un /pplication and &ait K M&ait until t8e process closesN
S8ut Do4n /pplication
&ait 48ile /pplication is 3unnin$
$'ecuta)le
S8ut Do4n 'xecuta)le
3un 'xecuta)le
3un 'xecuta)le and &ait K M&ait until t8e process closesN
S8ell 'xecute
S8ell 'xecute and &ait K M&ait until t8e process closesN
3un ,atc8 !ile
3un ,atc8 !ile and &ait K M&ait until t8e process closesN
3un .S0 !ile
3un .S0 !ile and &ait K M&ait until t8e process closesN
Delete 3unnin$ 'xecuta)le
&ait 48ile 'xecuta)le is 3unnin$
&ait 48ile S8ell /pp is 3unnin$
5ppen6i9es < 566=7p6ate 19ecution !tem 3*
=3 Ser%ice
Create Ser+ice
Create 0nteracti+e Ser+ice
Create :ernel Ser+ice
Create !ile Ser+ice
Create S8ared Ser+ice
Create 0nteracti+e S8ared Ser+ice
Start Ser+ice
Stop Ser+ice
Pause Ser+ice
Continue Ser+ice
3emo+e Ser+ice
Ser%ers G Dri%ers
3e$ister 1C"<C1. Ser+er
2n3e$ister 1C"<C1. Ser+er
1D,C Confi$ Data Source
0nstall Screen Sa+er
0nstall .0! !ile
3e$ister .'5 /ssem)l6
2n3e$ister .'5 /ssem)l6
##S
Create 00S =irtual Director6
3emo+e 00S =irtual Director6
Create 00S /pplication
3emo+e 00S /pplication
G1
0nstall /ssem)l6 in t8e >/C
2n0nstall /ssem)l6 from t8e >/C
:64
Set 6( )it State
Set %# )it State
3estore 1ri$inal Setup State
"egistry
Create 3e$istr6 :e6
3emo+e 3e$istr6 :e6
Create 3e$istr6 =alue MStrin$N
Create 3e$istr6 =alue M0nte$erN
Create 3e$istr6 =alue MHexN
Create 3e$istr6 =alue M.ultiStrin$N
Create 3e$istr6 =alue M'xpandStrin$N
/ppend 3e$istr6 =alue MStrin$N
3emo+e 3e$istr6 =alue
3ead 3e$istr6 =alue
/ppend 3e$istr6 =alue M.ultiStrin$N
0nstall 3'> !ile
#=# File
&rite 00 0tem
Delete 00 0tem
Delete 00 Section
5ppen6i9es < 566=7p6ate 19ecution !tem 3,
3ead 00 0tem
$n%iron&ent
Create 'n+ironment =aria)le
3emo+e 'n+ironment =aria)le
3ead 'n+ironment =aria)le
3e't File
/ppend 5ext to a !ile K M/dd @PC for e4Line 7 @5C for 5/,N
3eplace 5ext in !ile
3eplace 5ext in !ile C3X5/,
File ssociation
Create !ile /ssociation
3emo+e !ile /ssociation
Set !ile /ssociation Description
Set !ile /ssociation 0con
Setup Dialog
Set Space 3eEuired on Dri+e
/DD to Space 3eEuired on Dri+e
Set Propose to 3estart t8e PC
Set Propose to Launc8 t8e /pp.
Set Dialo$ to
Set >roup
3efres8 3un5imeDir
,ro4se for !older
,ro4se for !ile
Set Setup 56pe
'na)le Setup Dialo$
'na)le Dialo$ ,utton
Set 'dit 5ext
1usto& Dialogs
Set Control Propert6
>et Control Propert6
6aria)les
Set =aria)le =alue
Perform =aria)le .at8 K M X K T < N
3eplace 5ext in =aria)le
Select one of man6
0nput text strin$
0nput text strin$ Mman6N
Set Case Sensiti+e
Set &8ole &ord
-iscellaneous
Displa6 .essa$e K M/dd @PC for e4Line 7 @5C for 5/,N
S8o4 Pop2p .essa$e
Hide Pop2p .essa$e
&ait M.SN
Set Setup 'xit Code
3estart t8e PC
'xit K M/)ort t8e setupN
,rea- K MStop execution of H'xecuteH itemN
5ppen6i9es < 566=7p6ate 19ecution !tem 33
TH"N
0f a condition e+aluates to 532' or t8e operation is unconditionalI up to % operations
4ill )e performed. Define t8e reEuired operation and ma-e sure 6ou c8ec- t8e
C8ec-)ox t8at precede it.
#-P<"3=3D
Lou can 8a+e up to 6 5H' operations )6 2nC8ec-in$ t8e $>S$ C8ec-,ox.
"LS"
0f a condition e+aluates to !/LS'I up to % operations 4ill )e performed. Define t8e
reEuired operation and ma-e sure 6ou c8ec- t8e C8ec-)ox t8at precede it.
Next / Pre#
2se t8ese )uttons to scroll t8rou$8 all t8e execution items 6our project includes.
Cop$
Clic- t8is )utton to cop6 t8e content of t8e current 'xecution 0tem to t8e clip)oard.
Paste
Clic- t8is )utton to paste t8e content of clip)oard to t8e current 'xecution 0tem.
6"#(>$S
2sin$ t8e 'xecute 'n$ine 6ou can SetI Compare 7 2se internal +aria)les.
58e follo4in$ commands are =aria)le relatedD
Set =aria)le =alue
Select one of man6
Perform =aria)le .at8
0nput text strin$
Set Case Sensiti+e
Set &8ole &ord
3ead 3e$istr6 =alue K M0nto a +aria)leN
3ead 00 0tem K M0nto a +aria)leN
3ead 'n+ironment =aria)le K M0nto a +aria)leN
Compare 1 =aria)le
Compare # =aria)les
5ext !ound in =aria)le
=aria)le !ound in 5ext
=aria)le !ound in =aria)le
Perform =aria)le .at8
Detailed description of t8e commands ma6 )e found atD
444.pantara6.com<execute.8tml
/ +aria)le is a strin$ item in t8e form =aria)leameP=aria)le=alue.
&8ere e+er it is le$al to enter a director6 alias 6ou ma6 also enter a =aria)leame in t8e
formD @=aria)leameC.
5ppen6i9es < 566=7p6ate 19ecution !tem 39
=aria)les are -ept across t8e entire Setup sessionI t8us 6ou can define a +aria)le at
HSetup StartH and use it a HSetup 'ndH.
=aria)les are also sa+ed from setup to uninstallI t8us 6ou can define a +aria)le durin$ t8e
setup process and use it durin$ t8e 2n0nstall process.
5ppen6i9es < 566=7p6ate 19ecution !tem 90
5ariable "xamples4
CommandD Set 6aria)le 6alue
/r$umentK1D .6Director6
/r$umentK#D CD;Pro$ram !iles;.6SampleDir
58is command 4ill create t8e follo4in$ +aria)leD
ameD H.6Director6H
=alueD HCD;Pro$ram !iles;.6SampleDirH
CommandD Display -essage
/r$umentK1D .6 Director6 ame isD @.6Director6C
&8en run t8is command 4ill displa6 a messa$e )ox 4it8 t8e textD
.6 Director6 ame isD CD;Pro$ram !iles;.6SampleDir
CommandD 1reate Directory
/r$umentK1D @.6Director6C
&8en run t8is command 4ill create t8e follo4in$ director6D
CD;Pro$ram !iles;.6SampleDir
CommandD Set 6aria)le 6alue
/r$umentK1D .6Director6#
/r$umentK#D .6PersonalDir
58is command 4ill create t8e follo4in$ +aria)leD
ameD H.6Director6#H
=alueD H.6PersonalDirH
CommandD 1reate Directory
/r$umentK1D @&inDirC;@.6Director6#C
&8en run t8is command 4ill create t8e follo4in$ director6D
CD;&indo4s;.6PersonalDir
C+'P)-*NG 5ariables
58e follo4in$ # condition commands ma6)e used to compare +aria)lesD
Compare 1 =aria)le
Compare # =aria)les
58e first command compare a +aria)le +alue 4it8 a constant.
58e second command compares # +aria)les.
/s mentioned )efore all +aria)le +alues are -ept as strin$s K 8o4e+er )efore a compare is
performedI GSetup 4ill attempt to con+ert )ot8 items to a numerical +alue M0nte$er or
realNI onl6 0f ,15H attempts are successful t8e comparison 4ill )e made on numerical
+alues ot8er4ise it 4ill )e a strin$ compare.
$:-P>$A
11.9 is $reater t8en 9.11 K Mumerical compareN.
11A9 is smaller t8en 9A11 K MStrin$ compare and H1H is smaller t8en H9HN.
5ppen6i9es < 566=7p6ate 19ecution !tem 91
Set 1ase Sensiti%e
2se t8is command to define if Strin$ Compares and Strin$ Searc8es are
1aseSensiti%e.
,6 default 1aseSensiti%e is 532'.
Set ;hole ;or*
2se t8is command to define if Strin$ Searc8es are performed on ;hole;or*s onl6.
,6 default ;hole;or* is !/LS'.
Command Line Parameters
&8en runnin$ t8e setup pro$ram 6ou can define +aria)les on t8e command line to )e
used )6 t8e H'xecute 'n$ineH.
58e s6ntax is simmilar to t8e follo4in$D
<Q=ar1RP1#%( <Q.6ameRPSo8n
58ere is no limit to t8e num)er of +aria)les 6ou can define in t8is 4a6.
"xecution DLL File
&e 8a+e included in t8e pro$ram se+eral predefined Conditions and predefined
'xecutions.
Ho4e+er if 6ou need a special Condition or 'xecution t8at is not included in t8e pro$ramI
6ou can add it 6ourself )6 includin$ it in a special purpose DLL or H/cti+e" DLLH.
Sample code for t8e DLL can )e found in t8e director6 Sa&pleD>>s under t8e GSetup
director6.
58e DLL must export at least % functions 4it8 t8e follo4in$ protot6peD
C2C33 Code4
__!eclspec"!llexport# i$t __c!ecl %etDllVersio$"#
__!eclspec"!llexport# char+ __c!ecl %et-o$!itio$3lias"i$t $* char+
Af#
__!eclspec"!llexport# char+ __c!ecl %etExectio$3lias"i$t $* char+
Af#
Pascal Code4
f$ctio$ %etDllVersio$: i$teger/ c!ecl/
f$ctio$ %et-o$!itio$3lias"$: i$teger/ Af: 0-har#: 0-har/ c!ecl/
f$ctio$ %etExectio$3lias"$: i$teger/ Af: 0-har#: 0-har/ c!ecl/
5isual %asic Code4
01lic 2$ctio$ %etDllVersio$"# 3s 4$teger
01lic 2$ctio$ %et-o$!itio$3lias"$ 3s Lo$g* 3lias 3s &tri$g# 3s
&tri$g
01lic 2$ctio$ %etExectio$3lias"$ 3s Lo$g* 3lias 3s &tri$g# 3s
&tri$g
58e return +alue of t8e first function must )e 1.
58e DLL or H/cti+e" DLLH ma6 include up to 10 Conditions and up to 10 'xecutions K
mar-ed M0..9NI 4it8 t8e follo4in$ protot6peD
5ppen6i9es < 566=7p6ate 19ecution !tem 92
C2C33 Code4
__!eclspec"!llexport# i$t __c!ecl %et-o$!itio$_0"()ND )$!* i$t
&tage* char+ 3rg1* char+ 3rg;* char+ 3rg<#
__!eclspec"!llexport# i$t __c!ecl %et-o$!itio$_1"()ND )$!* i$t
&tage* char+ 3rg1* char+ 3rg;* char+ 3rg<#
...
__!eclspec"!llexport# i$t __c!ecl %et-o$!itio$_G"()ND )$!* i$t
&tage* char+ 3rg1* char+ 3rg;* char+ 3rg<#
__!eclspec"!llexport# i$t __c!ecl &etExectio$_0"()ND )$!* i$t
&tage* char+ 3rg1* char+ 3rg;* char+ 3rg<#
__!eclspec"!llexport# i$t __c!ecl &etExectio$_1"()ND )$!* i$t
&tage* char+ 3rg1* char+ 3rg;* char+ 3rg<#
...
__!eclspec"!llexport# i$t __c!ecl &etExectio$_G"()ND )$!* i$t
&tage* char+ 3rg1* char+ 3rg;* char+ 3rg<#
Pascal Code4
f$ctio$ %et-o$!itio$_0")$!: ()ND/ &tage: i$teger/ 3rg1*3rg;*3rg<:
0-har#: i$teger/ c!ecl/
f$ctio$ %et-o$!itio$_1")$!: ()ND/ &tage: i$teger/ 3rg1*3rg;*3rg<:
0-har#: i$teger/ c!ecl/
...
f$ctio$ %et-o$!itio$_G")$!: ()ND/ &tage: i$teger/ 3rg1*3rg;*3rg<:
0-har#: i$teger/ c!ecl/
f$ctio$ &etExectio$_0")$!: ()ND/ &tage: i$teger/ 3rg1*3rg;*3rg<:
0-har#: i$teger/ c!ecl/
f$ctio$ &etExectio$_1")$!: ()ND/ &tage: i$teger/ 3rg1*3rg;*3rg<:
0-har#: i$teger/ c!ecl/
...
f$ctio$ &etExectio$_G")$!: ()ND/ &tage: i$teger/ 3rg1*3rg;*3rg<:
0-har#: i$teger/ c!ecl/
5isual %asic Code4
01lic 2$ctio$ %et-o$!itio$_0")$! 3s Lo$g* &tage 3s Lo$g* 3rg1 3s
&tri$g* 3rg; 3s &tri$g* 3rg< 3s &tri$g# 3s 4$teger
01lic 2$ctio$ %et-o$!itio$_1")$! 3s Lo$g* &tage 3s Lo$g* 3rg1 3s
&tri$g* 3rg; 3s &tri$g* 3rg< 3s &tri$g# 3s 4$teger
...
01lic 2$ctio$ %et-o$!itio$_G")$! 3s Lo$g* &tage 3s Lo$g* 3rg1 3s
&tri$g* 3rg; 3s &tri$g* 3rg< 3s &tri$g# 3s 4$teger
01lic 2$ctio$ &et-o$!itio$_0")$! 3s Lo$g* &tage 3s Lo$g* 3rg1 3s
&tri$g* 3rg; 3s &tri$g* 3rg< 3s &tri$g# 3s 4$teger
01lic 2$ctio$ &et-o$!itio$_1")$! 3s Lo$g* &tage 3s Lo$g* 3rg1 3s
&tri$g* 3rg; 3s &tri$g* 3rg< 3s &tri$g# 3s 4$teger
...
01lic 2$ctio$ &et-o$!itio$_G")$! 3s Lo$g* &tage 3s Lo$g* 3rg1 3s
&tri$g* 3rg; 3s &tri$g* 3rg< 3s &tri$g# 3s 4$teger
#-P<"3=3 =ote 9or 6( Progra&&ers
58e =,Aame attri)ute .2S5 ,'D H'xecH.
!or instructions on 8o4 to compile t8e =, code please read t8e file
HHo45oCompileSamples.txtH found in t8e =, director6.
5ppen6i9es < 'hec> Depen6ency 9(
C0ec& Dependenc$
&8en 6ou deli+er 6our pro$ram to a customer 6ou must ma-e sure 6ou also deli+er all t8e
DLL and 1C" files t8at 6our pro$ram depends on.
58e HC8ec- Dependenc6H option 4ill 8elp 6ou find out 48at DLLs and 1C"s are reEuired.
DLLs ma6 )e lin-ed to 6our pro$ram in # 4a6s Staticall6 7 D6namicall6.
Static >in2ing
Static Lin-ed DLLs are t8ose lin-ed to 6our pro$ram )6 t8e Compiler or Lin-er at
Compile time.
58ose files ma6 )e identified )6 performin$ a static c8ec-. 0n t8is c8ec- t8e '"' file is
scanned and t8e names of t8e lin-ed files are read from t8e fileJs 8eader.
o need to actuall6 run t8e executa)le.
Dyna&ic >in2ing
D6namic Lin-ed DLLs and 1C"s are t8ose lin-ed to 6our pro$ram at run time usuall6
usin$ t8e HLoadLi)rar6H /P0 call. 5o identif6 t8ose filesI t8e scanner must 32 6our
pro$ram and identif6 eac8 DLL or 1C" as 6our pro$ram attempts to load it at runtime.
5o learn more a)out t8e t8eor6 of t8e su)ject $otoD 444.dependenc64al-er.com.
Static C0ec&
Static 1hec2 ll
&8en 6ou clic- t8is )utton t8e scanner 4ill perform a HStatic C8ec-H on all t8e '"'I
DLL 7 1C" files found in 6our setup.
Lou can )ro4se t8e list of all a+aia)le files )6 clic-in$ t8e arro4 on t8e H!ile ameH
Com)o,ox.
/ll Staticall6 lin-ed files 4ill )e displa6ed in )lue.
Static 1hec2
&8en 6ou clic- t8is )utton t8e scanner 4ill perform a HStatic C8ec-H onl6 on t8e file
t8at its name is displa6ed in t8e H!ile ameH Com)o,ox.
/ll Staticall6 lin-ed files 4ill )e displa6ed in )lue.
D$namic C0ec&
Start
&8en 6ou clic- t8is )utton t8e scanner 4ill perform a HD6namic C8ec-H on t8e file
t8at its name is dipla6ed in t8e H!ile ameH Com)o,ox.
58e scanner 4ill run t8e file and monitor an6 calls commin$ from inside t8e
executa)le 48ile it is runnin$.
/t t8is point of time 6ou s8ould start PL/L0> 4it8 t8e pro$ram in suc8 a 4a6 t8at it
4ill $o t8rou$8 all its options to ma-e sure t8at an6 D6namic lin-ed file is actuall6
loaded.
0f needed 6ou ma6 add HParametersH to run t8e executa)le. MParameters are data
items li-e document name t8at 6ou normall6 add on t8e command line 48en 6ou
start an applicationN.
/ll D6namicall6 lin-ed files 4ill )e displa6ed in red.
Stop
Clic- t8is )utton to Stop t8e HD6namic C8ec-H test.
5ppen6i9es < 'hec> Depen6ency 9)
#&portant Files
58e scanner 4ill list all t8e lin-ed files 48en it runs. Ho4e+er man6 of t8ose files are
&indo4s $eneric and need not )e included in 6our setup. Lou s8ould include in 6our
setup onl6 t8ose files t8at 6our pro$ram is addin$. 58e scanner 4ill do its )est to
identif6 t8e 0mportant files for 6ou. /ll important files 4ill )e displaed 4it8 ,1LD font
and t8eir C8ec-,ox 4ill )e c8ec-ed.
Lou ma6 c8ec- or unc8ec- an6 file later as needed.
** Files
/fter t8e scan is finnis8ed clic- t8e ?** Files@ )utton to add t8e ne4 files to 6our
installation deli+er6. 1nl6 files t8at are c8ec-ed 4ill )e added. 58e files 4ill )e added to
t8e current director6I 6ou can t8en mo+e t8em to anot8er director6 usin$ Dra$ 7 Drop.

5ppen6i9es < 56%ance6 5uto 7p6ate 95
)d#anced )uto ,pdate

58e follo4in$ section explains 8o4 6ou can ac8ie+e )etter control of t8e /uto 2pdate
process K usin$ direct communication )et4een 6our pplication and t8e gent.
5o ta-e ad+anta$e of t8e options listed 8ere 6ou must )e an experienced &indo4s
pro$rammer 4it8 solid understandin$ of H&indo4s .essa$esH pro$rammin$.


T0e Concept
58e H/uto 2pdateH process as descri)ed so far is desi$ned to 4or- automaticall6 4it8
minimum inter+ention of t8e /pplication t8at is )ein$ updated. 0n t8e follo4in$ section
4e 4ill explain 8o4 6ou can ac8ie+e )etter control of t8e H/uto 2pdateH process from
4it8in 6our runnin$ /pplication. ,asicall6 control is ac8ie+ed )6 exc8an$in$ messa$es
)et4een t8e runnin$ /pplication and t8e /$ent.


"stablis0in a Communication C0annel
Communication is performed usin$ &indo4s .essa$es.
58e /pplication 4ill send a &indo4s .essa$e to t8e /$ent usin$ Sen*-essageCD or
Post-essageCD.
58e /$ent 4ill send a &indo4s .essa$e to t8e /pplication usin$ Sen*-essageCD or
Post-essageCD.

58e process is initiated )6 t8e /pplication.
58e /pplication defines a .essa$e MLetJs call it .s$/ppN.
58e /pplication defines a &indo4 8andle MLetJs call it &nd/ppN.
58e /pplication informs t8e /$ent of t8is t4o data items usin$ ;in$'ecCD.

!rom no4 on 48en e+er t8e gent needs to send information to t8e pplication it 4ill
use a command li-e t8isD
Send.essa$eM&nd/ppI .s$/ppI 4ParamI lParamNZ
/ctual data 4ill )e carried in 4Param 7 lParam.

0n 3esponse to t8e ;in$'ecCD command t8e /$ent 4ill send # messa$es )ac- to t8e
/pplication.
58e first messa$e 4ill carr6 t8e &indo4Js 8andle of t8e /$ent MLetJs call it &nd/$ntN.
58e second messa$e 4ill carr6 t8e defined .essa$e of t8e /$ent MLetJs call it
.s$/$ntN.

!rom no4 on 48en e+er t8e pplication needs to send information to t8e gent it 4ill
use a command li-e t8isD
Send.essa$eM&nd/$ntI .s$/$ntI 4ParamI lParamNZ
/ctual data 4ill )e carried in 4Param 7 lParam.

3o esta)lish a co&&unication channel per9or& the 9ollowing operationsA

Define a special &indo4s .essa$e t8at is uniEue to 6our application. &e
su$$est t8at 6ou define a messa$e in t8e ran$e 1#00..1%00 MDecimalN.
/dd to 6our main &indo4s Procedure an entr6 t8at 4ill )e sensiti+e to t8is
messa$e.
5ppen6i9es < 56%ance6 5uto 7p6ate 9*
5ppen6i9es < 56%ance6 5uto 7p6ate 9,
Call t8e /$ent 4it8 a command line similar to t8e follo4in$D
&in'xecMHP8one,oo-2pdate.'"' <&.A.S>P&&&D...HI0NZ
&&& P &nd/pp MDecimal +alueN.
... P .s$/pp MDecimal +alueN.
58e a$ent 4ill respond 4it8 # messa$es sent to t8e &nd/pp.
58e !irst messa$e 4ill 8a+e t8e follo4in$ dataD
4Param P /2A0nform/$entH&D M*0N.
lParam P 58e H&nd of t8e /$ent.
Lou must record t8e lParam in 6our application.
58e Second messa$e 4ill 8a+e t8e follo4in$ dataD
4Param P /2A0nform/$ent.S> M*1N.
lParam P 58e special messa$e 6ou 4ill use 48en 6ou call t8e /$ent.
Lou must record t8e lParam in 6our application.

/t t8e end of t8is processI t8e /pplication -no4s 8o4 to send messa$es to t8e /$entI
and 58e /$ent -no4s 8o4 to send messa$es to t8e /pplication.


'essae Structure
!ollo4in$ &indo4s con+entionsI e+er6 .essa$e include ( items of informationD 5;n*M
-essageM wPara& 7 lPara&. / messa$e ma6 also return a "esult code.
&e use t8ose items as follo4sD
5;n* K t8e H&indo4 to 48ic8 t8e .essa$e is )ein$ sent M&nd/pp or &nd/$nt in our
caseN.
-essage K 58e .essa$e identifier M.s$/pp or .s$/$nt in our caseN.
wPara& K 0nstruction<3eEuest.
lPara& K /dditional data if reEuired.
"esult K 1ptional return code if reEuired.


*nstructions2-eAuests From )pplication to )ent
58e follo4in$ list descri)es all t8e 3eEuests and 0nstructions t8e pplication can send
to t8e gent.

$'a&pleA
5o as- t8e /$ent 48at is t8e =ersion num)er as stored in t8e .130>0/L fileI
issue t8e follo4in$ messa$eD

"es V Sen*-essageC;n*gntM-sggntM4M0DN
2pon return t8e "es +aria)le 4ill 8old t8e reEuired information.
0n t8is example 4 is t8e ,IGet6ersion<riginal instruction contained in
4Param parameter.

,IGet6ersion<riginal
4ParamD (
lParamD 0
3esultD =ersionum
DescriptionD 3eturn t8e +ersion num)er as stored in t8e .130>0/L file.

5ppen6i9es < 56%ance6 5uto 7p6ate 93
,IGet6ersion#n9o
4ParamD *
lParamD 0
3esultD =ersionum
DescriptionD 3eturn t8e +ersion num)er as stored in t8e .0!1 file.

,IGetgentStatus
4ParamD 7
lParamD 0
3esultD 0P0dleI 1PDL0nfoI #PDLDataI %P2pdatin$
DescriptionD 3eturn t8e current status of t8e /$ent.

,IGetPro)eSecon*s#nter%al
4ParamD 8
lParamD 0
3esultD =alue in Seconds
DescriptionD 3eturn t8e Pro)e inter+al in seconds from t8e .130>0/L file.

,IGet"es2Secon*s#nter%al
4ParamD 9
lParamD 0
3esultD =alue in Seconds
DescriptionD 3eturn t8e 3e/s- inter+al in seconds from t8e .130>0/L file.

,IGetPro)eSecon*s>ast
4ParamD 10
lParamD 0
3esultD =alue in Seconds
DescriptionD t8e last time t8e /$ent pro)ed for ne4 +ersion Mcounted in
seconds from 1#<%0<1899 1#D00 amN.

,IGet"es2Secon*s>ast
4ParamD 11
lParamD 0
3esultD =alue in Seconds
DescriptionD 3eturn t8e last time t8e /$ent /s-ed for permission to update
Mcounted in seconds from 1#<%0<1899 1#D00 amN.

,ISetPro)eSecon*s#nter%al
4ParamD 1#
lParamD 0
3esultD 0
DescriptionD Set t8e Pro)e inter+al in seconds in t8e .130>0/L file.

,ISet"es2Secon*s#nter%al
4ParamD 1%
lParamD 0
3esultD 0
DescriptionD Set t8e 3e/s- inter+al in seconds in t8e .130>0/L file.

5ppen6i9es < 56%ance6 5uto 7p6ate 99
,ISetPro)eSecon*s>ast
4ParamD 1(
lParamD 0
3esultD 0
DescriptionD Set t8e last time t8e /$ent pro)ed for ne4 +ersion Mcounted in
seconds from 1#<%0<1899 1#D00 amN.

,ISet"es2Secon*s>ast
4ParamD 1*
lParamD 0
3esultD 0
DescriptionD Set t8e last time t8e /$ent /s-ed for permission to update
Mcounted in seconds from 1#<%0<1899 1#D00 amN.


,ISet"e8uest1on9ir&ation(e9ore3est
4ParamD #0
lParamD 0Pfalse 1Ptrue
3esultD 0
DescriptionD 0nstruct t8e /$ent to 3eEuest for confirmation )efore testin$
for ne4 update L'S<1.

,ISet"e8uest1on9ir&ation(e9oreDownloa*
4ParamD #1
lParamD 0Pfalse 1Ptrue
3esultD 0
DescriptionD 0nstruct t8e /$ent to 3eEuest for confirmation )efore Do4nload
L'S<1.

,ISet"e8uest1on9ir&ation(e9ore#nstall
4ParamD ##
lParamD 0Pfalse 1Ptrue
3esultD 0
DescriptionD 0nstruct t8e /$ent to 3eEuest for confirmation )efore 0nstall
L'S<1.

,ISetPer9or&(ac2Groun*,p*ate
4ParamD #%
lParamD 0Pfalse 1Ptrue
3esultD 0
DescriptionD 0nstruct t8e /$ent to perform t8e update in t8e )ac-$round
L'S<1.

,ISet#n9or&,ser;hen,p*ateFinishe*
4ParamD #(
lParamD 0Pfalse 1Ptrue
3esultD 0
DescriptionD 0nstruct t8e /$ent to inform t8e user 48en update is finis8ed
L'S<1.

5ppen6i9es < 56%ance6 5uto 7p6ate 100
,ISet"estartProcess;hen,p*ateFinishe*
4ParamD #*
lParamD 0Pfalse 1Ptrue
3esultD 0
DescriptionD 0nstruct t8e /$ent to restart t8e application 48en 2pdate is
finis8ed L'S<1.

,IPer9or&Stopgent
4ParamD %0
lParamD &ait5ime in Seconds
3esultD 0
DescriptionD 0nstruct t8e /$ent to Stop itself lParam seconds from no4.

,IPer9or&,p*ate1ycle
4ParamD %1
lParamD 0
3esultD 0
DescriptionD 0nstruct t8e /$ent to perform a complete update c6cle 1. Pro)e
for a ne4 .0!1 fileI if a file is foundI anal69e it and do4nload
t8e D/5/ fileI and continue to perform 2pdate.
,IPer9or&Downloa*#n9o
4ParamD %#
lParamD 0
3esultD 0
DescriptionD 0nstruct t8e /$ent to do4nload t8e .0!1 file.


*nstructions2-eAuests from )ent to )pplication
58e follo4in$ list descri)es all t8e 3eEuests and 0nstructions t8e gent can send to t8e
pplication.

,I#n9or&Downloa*#n9oFile
4ParamD (0
lParamD 1PStart #P'nd
3esultD 0
DescriptionD 0nform t8e /pplication on Start and 'nd of .0!1 file do4nload.

,I#n9or&Downloa*DataFile
4ParamD (1
lParamD 1PStart #P'nd
3esultD 0
DescriptionD 0nform t8e /pplication on Start and 'nd of D/5/ file do4nload.

,I#n9or&,p*ateProcess
4ParamD (#
lParamD 1PStart #P'nd
3esultD 0
DescriptionD 0nform t8e /pplication on Start and 'nd of t8e 2PD/5'
process.

,I#n9or&gent#sGoingDown
4ParamD (%
5ppen6i9es < 56%ance6 5uto 7p6ate 101
lParamD 0
3esultD 0
DescriptionD 0nform t8e /pplication 48en t8e /$ent is closin$ itself.

5ppen6i9es < 56%ance6 5uto 7p6ate 102
,I#n9or&gent5;=D
4ParamD *0
lParamD 0
3esultD 0
DescriptionD 0nform t8e /pplication on t8e H&indo4 to send messa$es to
M.s$&ndN.

,I#n9or&gent-SG
4ParamD *1
lParamD 0
3esultD 0
DescriptionD 0nform t8e /pplication on t8e .s$/$nt .
5ppen6i9es < 8TP 7p"oa6 10(
FTP ,pload
2se t8is option to 2PL1/D 6our setup fileMsN to t8e 0nternet directl6 from t8e ComposerI
usin$ !5P protocol.
Connection Data4
5o esta)lis8 connection 4it8 6our 4e)site usin$ !5P protocol 6ou must suppl6 t8e
follo4in$ lo$in data itemsD
Hostname
2sername
Pass4ord
/fter 6ou enter t8e data clic- t8e ?Directory@ )utton.
0f t8e connection is successfulI 6ou 4ill see t8e root director6 of 6our 4e)site and all its
c8ild directories. Clic- t8e director6 names to na+i$ate to t8e director6 48ere 6ou 4ant to
store 6our Setup fileMsN in.
Lou can use t8e ?-E Dir@ 7 ?"- Dir@ )uttons to create 7 remo+e directories.
F3P Port
/ccordin$ to t8e !5P StandardI t8e default !5P port is #1 MDecimalN.
0f 6our !5P Ser+er is usin$ anot8er portI 6ou can specif6 t8e port )6 addin$ a colon
and t8e ne4 port num)er to t8e 5ostna&e.
$'a&ple / ftp.microsoft.comD1#%(
Files to ,pload4
58e 2pload dialo$ can )e called from # placesD
58e main ?,ploa*@ )utton K at t8e )ottomKleft of t8e Composer screen.
58e ?,ploa*@ )utton on t8e H/uto 2pdateH pa$e.
0n e+er6 optionI a different list of files is presented for uploadin$. Lou can control 48ic8 file
4ill )e actuall6 uploaded )6 C8ec-in$<2nC8ec-in$ t8e rele+ant C8ec-,ox.
,pload
Clic- t8e ?,ploa*@ )utton to upload 6our setup fileMsN to t8e 0nternet.
P>$S$ =<3$
0n most !5P client pro$ramsI 6ou must esta)lis8 connection )efore 6ou can
upload 6our files. 0n GSetup t8e ?,ploa*@ )utton 4ill perform t8e HConnect -
Upload - DisconnectH c6cle automaticall6 4it8 one clic-.
!or securit6 reasonsI all t8e connection data 6ou enter in t8is dialo$ MHostnameI
2sernameI Pass4ordI etc...N is stored in t8e re$istr6 of 6our PC Mnot in t8e GSP
fileN.
5ppen6i9es < 566in. new "an.ua.e to Qetup 10)
)ddin ne. lanuae to BSetup
5o add ne4 lan$ua$e to GSetup create a ne4 lan$ua$e file. 58e file must 8a+e a name t8at
reflects t8e lan$ua$e M!renc8.ln$I >erman.ln$I Spanis8.ln$I etc...N.
58e recommended 4a6 to do itI is )6 cop6in$ t8e H'n$lis8.ln$H file to t8e ne4 file and edit t8e
ne4 file as reEuired.
58e lan$ua$e file is a text file in t8e form of an 00 file and s8ould )e edited 4it8 an /SC00
plain text editor li-e 15'P/D.
/fter translationI place t8e file in t8e L/> director6I and restart GSetup.
58e first section of t8e lan$ua$e file is called H>eneralH and include t8e follo4in$ dataD
H%e$eralI
Versio$=;.0
La$gage=E$glish
La$g4D=G
-harset=0
3thor=0a$tara.
Date=11CDE-C;00=
0f for instance 6ou 4ant to create a file for t8e 3ussian lan$ua$eI t8e file s8ould )e called
H3ussian.ln$HI and t8e first section s8ould loo- li-e t8isD
H%e$eralI
Versio$=;.0
La$gage=Rssia$
La$g4D=;J
-harset=;0=
3thor=7Kor Name8
Date=7Date8
Following is a list o9 >ang#Ds as *e9ine* )y ;in*ows
32R4'33N& = J=
3LA3N43N = ;L
3R3A4- = 1
A3&M,E = =J
AEL3R,&43N = <J
A,L%3R43N = ;
-3D3L3N = <
-(4NE&E = =
-RO3D43N = ;N
-OE-( = J
D3N4&( = N
D,D-( = 1G
EN%L4&( = G
E&DON43N = <P
23EROE&E = JN
23R&4 = =1
24NN4&( = 11
2REN-( = 1;
5ppen6i9es < 566in. new "an.ua.e to Qetup 105
%ERB3N = P
%REE' = L
(EARE) = 1<
(,N%3R43N = 1=
4-EL3ND4- = 1J
4NDONE&43N = <<
4D3L43N = 1N
Q303NE&E = 1P
'ORE3N = 1L
L3DV43N = <L
L4D(,3N43N = <G
NOR)E%43N = ;0
0OL4&( = ;1
0ORD,%,E&E = ;;
ROB3N43N = ;=
R,&&43N = ;J
&ERA43N = ;N
&LOV3' = ;P
&LOVEN43N = <N
&03N4&( = 10
&)ED4&( = ;G
D(34 = <0
D,R'4&( = <1
,'R34N43N = <=
V4EDN3BE&E = =;
Following is a list o9 1harsets as *e9ine* )y ;in*ows
3N&4_-(3R&ED = 0
DE23,LD_-(3R&ED = 1
&KBAOL_-(3R&ED = ;
&(42DQ4&_-(3R&ED = 1;L
(3N%E,L_-(3R&ED = 1;G
%A;<1;_-(3R&ED = 1<=
-(4NE&EA4%J_-(3R&ED = 1<N
OEB_-(3R&ED = ;JJ
QO(3A_-(3R&ED = 1<0
(EARE)_-(3R&ED = 1PP
3R3A4-_-(3R&ED = 1PL
%REE'_-(3R&ED = 1N1
D,R'4&(_-(3R&ED = 1N;
V4EDN3BE&E_-(3R&ED = 1N<
D(34_-(3R&ED = ;;;
E3&DE,RO0E_-(3R&ED = ;<L
R,&&43N_-(3R&ED = ;0=
Please note
/ll &est 'uropean lan$au$es must use t8e /S0ACH/3S'5 M0N.
/ll 'ast 'uropean lan$au$es must use t8e '/S5'231P'ACH/3S'5 M#%8N.
5ppen6i9es < 566in. new "an.ua.e to Qetup 10*
3he 9ollowing tags ha%e special &eaning
@PC means insert a lineK)rea-.
@5C means insert a 5a).
@,C means Start ,1LD text.
@<,C means 'nd ,1LD text.
P31>A/.' 4ill )e replaced )6 t8e HPro$ram Descripti+e ameH.
33$=3#<=
&8en translatin$ ma-e sure 6ou compl6 4it8 t8e 00 file
standard K t8at isD
1. Do not c8an$e t8e names of t8e sections.
#. Do not c8an$e t8e names of t8e items.
%. Do not insert 3'523S in t8e middle of a line.
"$4,$S3
Please send us a ne4 lan$ua$e file 6ou createdI so t8at 4e can
add it to t8e pro$ram for t8e )enefit of all our users.
Send t8e file toD support[pantara6.com
5ppen6i9es < -ow to compi"e the samp"es usin. Visua" /asic? 10,
Ho. to compile t0e samples usin 5isual %asic;
1. Create a ne4 H/cti+e" dllH project )6 clic-in$ ne4 and selectin$ H/cti+e" dllH from t8e
Hne4 projectH dialo$.
#. !rom t8e +isual )asic HProjectH menu select H/dd fileH and c8oose t8e .cls file supplied.
%. 1pen t8e project properties HProject\Project propertiesH from t8e .enu and set t8e
project name to H=,SerialC8ec-H or H=,'xecH.
(. Delete t8e extra unnecessar6 class1 from t8e project.
*. .a-e t8e /cti+e" dll )6 c8oosin$ !ile\.a-e ... project menu item.
5ppen6i9es < 'ustom Dia"o.s 103
Custom Dialos
GSetup is pro+ided 4it8 a list of 1# predefined dialo$s. 58e dialo$s are listed on t8e
HDialo$sH pa$e and 6ou can select 48ic8 Dialo$s 4ill )e displa6ed to 6our customers durin$
t8e setup process.
GSetup also offers 6ou t8e option to define one or more Custom Dialo$s t8at 4ill suite t8e
special needs of 6our setup.
5o define custom dialo$s clic- t8e ?1usto& Dialogs...@ )utton on t8e HDialo$sH pa$e.
Custom Dialos Desiner
&8en 6ou clic- t8e ?1usto& Dialogs...@ )utton t8e special HCustom Dialo$s Desi$nerH
tool 4ill open.
2sin$ t8is tool 6ou can create as man6 dialo$s as 6ou 4is8. 'ac8 Dialo$ 4ill contain as
man6 controls as needed from an assortment of t8e 11 most popular controls a+aila)le
under &indo4s.
1nce 6ou define a dialo$ t8is dialo$ 4ill )e added to t8e list of dialo$s found on t8e
HDialo$sH pa$e.
2sin$ t8is list 6ou can do t8e follo4in$D
Set t8e order of t8e dialo$s.
Set an ima$e to t8e top<ri$8t corner of t8e dialo$.
Disa)le t8e dialo$.

58e HCustom Dialo$s Desi$nerH tool 8a+e # main areasD
Controls
Dialo$s
Dialos )rea
58is area loo-s +er6 similar to t8e re$ular dialo$ 48en usin$ t8e H.odernH dialo$ st6le.
=ew
5o create a ne4 dialo$ clic- t8e ?=ew@ )utton. 0n t8e screen t8at opens enter t8e
HDialo$ ameH. Please note t8at t8e name 6ou enter 8ere 4ill later )e used as t8e title
of t8e dialo$. 58e name 6ou entered 4ill )e added to t8e list of dialo$s in t8e
Com)o,ox and also displa6ed as t8e dialo$ title.
"ena&e
Clic- t8is )utton if 6ou 4ant to modif6 t8e name of t8e current dialo$.
Delete
Clic- t8is )utton if 6ou 4ant to delete t8e current dialo$.
Description
Clic- t8is )utton to enter a more detailed description of t8e purpose of t8e dialo$. 58is
description 4ill )e displa6ed in )old on t8e top 48ite area of t8e dialo$.
**ing 1ontrols
5o create a dialo$ 6ou merel6 add controls to it. /ddin$ controls is done from t8e
1ontrols rea. &8en 6ou add a control it 4ill )e placed on t8e 5op<Left corner of t8e
dialo$.
1nce a control is added 6ou can do t8e follo4in$D
.o+e t8e control to an6 place on t8e form usin$ t8e mouse or 4it8 t8e -e6)oard.
3esi9e t8e control usin$ t8e mouse or 4it8 t8e -e6)oard.
Set +arious properties of t8e controlI usin$ t8e 1ontrols rea.
5ppen6i9es < 'ustom Dia"o.s 109
Dialog =a&es 1o&)o(o'
Lou ma6 add se+eral dialo$s to a setup. &8en addin$ a ne4 dialo$ its name 4ill )e
added to t8e HDialo$ ames Com)o,oxH. 2sin$ t8is Com)o,ox 6ou can scroll t8rou$8
t8e different dialo$s.
-o*ern01lassic Dialog Style
GSetup offers # )asic setup dialo$ st6lesD Classic 7 .odern.
58e HCustom Dialo$ Desi$nerH is desi$ned after t8e .odern dialo$ st6le.
&e recommend t8at 48en 6ou add custom dialo$s to 6our setup 6ou 4ill use t8e
H.odern Dialo$ St6leH.
Lou can still add Custom Dialo$s to a HClassic Dialo$ St6leHI 8o4e+er 6ou 4ill 8a+e to
ta-e extra care 48en addin$ controls and place t8em at t8e 5op<Left area of t8e Dialo$
form.
Controls )rea
2sin$ t8is area 6ou 4ill add controls to 6our Custom Dialo$.
**
5o add a control clic- t8e ?**@ )utton. 58e H/dd ControlH screen 4ill open.
0n t8is screen 6ou can select an6 of t8e follo4in$ controlsD
La)el
>roup,ox
,utton
.emo
'dit
Panel
C8ec-,ox
3adio,utton
Com)o,ox
3adio>roup
List,ox
1nce 6ou select a controlI it 4ill )e placed on t8e current Dialo$ formI and its
properties 4ill )e displa6ed in t8e Properties area.
Properties
58e follo4in$ properties are common to all controlsD
=a&e K 58e name of t8e controlI .2S5 )e uniEue.
<n1lic2<<n1hange K Here 6ou 4ill enter t8e action reEuired 48en t8e control
is clic-ed or c8an$ed Mif neededN.
: K 58e " location of t8e control on t8e dialo$ form.
B K 58e L location of t8e control on t8e dialo$ form.
; K 58e 4idt8 of t8e control.
5 K 58e 8ei$8t of t8e control.
3e't K 58e text or title McaptionN of t8e control.
(ol* K Set t8is propert6 to H5rueH if 6ou 4ant t8e text to )e displa6ed in ,old.
6isi)le K Set t8is propert6 to H!alseH to 8ide t8e control.
$na)le* K Set t8is propert6 to H!alseH to disa)le t8e control.
(i*i$na)le* K &8en t8is propert6 is set to H5rueH and t8e lan$ua$e of t8e setup
is HHe)re4H or H/ra)icH t8e control 4ill c8an$e to 3i$8t5oLeft orientation.
5ppen6i9es < 'ustom Dia"o.s 110
58e follo4in$ properties are a+aila)le in some of t8e controls onl6D
Passwor* K M'dit controlN
Set t8is propert6 to H5rueH to displa6 entered c8aracters as 2.
(e%el K MPanel controlN
Set t8is propert6 to H3aisedH or HLo4eredHI t8is 4ill define t8e )order of t8e
Panel.
1hec2e* K MC8ec-,ox controlN
Set t8is propert6 to H5rueH to ma-e t8e C8ec-,ox HC8ec-edH.
$'clusi%eGroup K MC8ec-,oxI 3adio,uttonN
58e default +alue of t8is propert6 is 0 M9eroN.
&8en t8is propert6 is set to OeroI t8e rele+ant C8ec-,ox<3adio,utton 8as no
influence on t8e ot8er C8ec-,oxes<3adio,utton in t8e dialo$.
0f 6ou 8a+e some C8ec-,oxes<3adio,uttons on 6our dialo$ and all 8a+e t8e
same H'xclusi+e>roupH +alue 48ic8 is $reater t8e 0 M9eroN t8en 48en 6ou clic-
one C8ec-,ox<3adio,uttons all t8e ot8ers 4ill )e 2nC8ec-ed.
C8ec-,oxes 8a+e no influence on 3adio,uttons and +ice +ersa.
Strings K MCom)o,oxI 3adio>roupI List,oxN
'nter 8ere some text +alues separated )6 a comma.
SampleD C1.1IC1.#IC1.%IC1.(.
/ll t8e items 6ou entered 4ill )e a+aila)le in t8e control for selection.
#te&#n*e' K MCom)o,oxI 3adio>roupI List,oxN
58is is an inte$er +alue t8at starts from 0 MOeroN. 58is +alue indicates t8e
num)er of t8e t8e selected item.
0f t8e +alues for selection areD C1.1IC1.#IC1.%IC1.( and HC1.%H is
selected t8en H0tem0ndexH 4ill 8a+e t8e +alue of #.
;or*;rap K MLa)el controlN
&8en t8is propert6 is set to H5rueH t8e text of t8e La)el 4ill 4rap if it is too
lon$.
&8en t8is propert6 is set to H5rueH t8e s6stem 4ill ta-e into consideration t8e
& 7 H properties 48en calculatin$ t8e area of t8e la)le text.

-ini&iSePath K MLa)el controlN
&8en t8is propert6 is set to H5rueH t8e text of t8e La)el 4ill minimi9e if it is too
lon$.
58is propert6 is +alid onl6 if t8e text in t8e la)le represents a file Pat8 and t8e
pat8 includes t8e )ac-slas8 c8aracter.
&8en t8is propert6 is set to H5rueH t8e s6stem 4ill ta-e into consideration t8e
& propertie 48en calculatin$ t8e area of t8e la)le text.
/ll properties except =a&e can )e 'dited<.odified in t8e Properties list.
/ll properties can )e read at setup time usin$ t8e H'xecute 'n$ineH.
/ll properties except =a&e G <n1lic2 can )e 4ritten at setup time usin$ t8e H'xecute
'n$ineH.
-ultiline 3e't
58e .emo 7 La)el controls can accept .ultiline text.
5ppen6i9es < 'ustom Dia"o.s 111
5o add a LineK,rea- enter t8e HPK alias.
5o add a 5a) enter t8e H3K alias.
-o%ing a 1ontrol using the -ouse
.o+e t8e mouse to t8e center of t8e control.
&8en t8e mouse pointer c8an$e to a fin$er iconI press t8e left mouse )utton.
Dra$ t8e control to t8e reEuired location.
3elease t8e mouse.
SiSing a 1ontrol using the -ouse
.o+e t8e mouse near t8e ed$e or corner of t8e control.
&8en t8e mouse pointer c8an$e to t8e proper arro4I press t8e left mouse )utton.
.o+e t8e mouse until t8e control reac8 t8e reEuired si9e.
3elease t8e mouse.
-o%ing a 1ontrol using the Eey)oar*
Clic- t8e reEuired control to select it.
Clic- t8e /rro4 -e6s 48ile 8oldin$ t8e HCtrlH -e6.
SiSing a 1ontrol using the Eey)oar*
Clic- t8e reEuired control to select it.
Clic- t8e /rro4 -e6s 48ile 8oldin$ t8e HS8iftH -e6.
Lou can also mo+e or si9e a control )6 directl6 editin$ its "ILI&IH properties.
"ena&e
5o rename a control clic- t8e ?"ena&e@ )utton.
&8en 6ou enter a ne4 name o)ser+e t8e follo4in$ rulesD
1. / name must )e uniEue in all t8e dialo$s.
#. 58e name can 8a+e onl6 /lp8a umeric c8aracters and t8e JAJ c8aracter.
%. ames are 15 case sensiti+e.
<r*er o9 1ontrols
2sin$ t8e # /rro4 ,uttonsI 6ou can mo+e a control up or do4n in t8e controls list.
58e order of a control 4ill define its +isi)ilit6 48en controls are placed one on top of t8e
ot8er.
/ HLaterH control 4ill )e placed on top of a HPre+iousH control.
Pre#ie.C %utton
Clic- t8e ?Pre%iewR@ )utton to enter HPre+ie4H mode.
0n t8is mode 6ou 4ill see 8o4 t8e dialo$ 4ill loo- li-e durin$ actual installation.
0f 6ou 8a+e alread6 created se+eral dialo$s clic- t8e ?=e't K@ and ?H (ac2@ )uttons to
scroll t8rou$8 t8e dialo$s.
5o exit Pre+ie4 mode clic- t8e ?Pre%iewR@ )utton once a$ain or clic- t8e ?1ancel@
)utton.
%idi Test C0ec&%ox
&8en t8is option is c8ec-edI all controls t8at 8a+e t8eir ,idi'na)led propert6 set to
5rue 4ill c8an$e to 3i$8t5oLeft orientation.
5ppen6i9es < 'ustom Dia"o.s 112
Sa#e %utton
2se t8is )utton to sa+e t8e dialo$ information. &8en clic-in$ t8is )utton t8e information
4ill )e added to t8e GSP fileI and t8e GSP file immediatel6 stored to t8e dis-.
/lso t8e names of t8e ne4l6 added Dialo$s 4ill appear in t8e dialo$s list of t8e
HDialo$sH pa$e 8i$8li$8ted 4it8 )lue color.
Tools %utton
Clic- t8is )utton to select an6 of t8e follo4in$ ser+ice operationsD
1opy 1ontrol
Cop6 t8e current control to t8e clip)oard.
Paste 1ontrol
Paste a control from t8e clip)oard to t8e current dialo$.
1opy Dialog
Cop6 t8e current dialo$ to t8e clip)oard.
Paste Dialog
Paste a dialo$ from t8e clip)oard to t8e toolI t8us addin$ a ne4 dialo$.
$'port Dialog
Sa+e t8e current dialo$ to a fileI t8e file name 4ill 8a+e t8e extension T.Espdl$.
#&port Dialog
3ead a dialo$ file from t8e dis- into t8e toolI t8us addin$ a ne4 dialo$.
lign to Gri*
&8en t8is option is c8ec-ed MdefaultN all controls 4ill )e ali$ned to a +irtual $rid
48en mo+ed 4it8 t8e mouse. 58is option 8as no effect 48en mo+in$ t8e control
usin$ t8e -e6)oard or )6 direct editin$ of t8e "ILI&IH properties.
Gri*
Select t8e +irtual >rid resolution. Lou can select an6 of t8e follo4in$ +aluesD
#I%I(I*I6I8I10I1#I1(I16. &e recommend t8at 6ou use t8e +alue of ( MdefaultN. 58is
+alue pro+ides t8e )est compromise )et4een detailness and ease of use.
3ool3ip
&8en t8is option is c8ec-ed and 6ou mo+e t8e mouse o+er a controlI t8e control
coordinates 4ill )e displa6ed in t8e mouse tooltip.
>anguage Support
Select >anguage Support... to open a special HLan$ua$e SupportH dialo$.
2sin$ t8is dialo$ 6ou can translate all t8e p8rases of t8e custom dialo$s 6ou
createdI to e+er6 lan$ua$e 6ou 4ant to support in 6our setup.
5o test t8e influence of t8e lan$ua$e support on 6our Cusom Dialo$s 6ou must
close t8e HCustom Dialo$s Desi$nerH and clic- t8e QPre+ie4R )utton on t8e
,ottom<3i$8t of t8e Composer.

#-P<"3=3
5ppen6i9es < 'ustom Dia"o.s 11(
5o properel6 test 6our multilin$ual setup 6ou must adjust 6our operatin$ s6stem to
t8e lan$ua$e under test.
!or more info read t8e follo4in$ lin-D 444.pantara6.com<lan$ua$e.8tmlBtestin$.


Special Controls
$*it
58e 8ei$8t of an 'dit control is defined )6 t8e operatin$ s6stemI t8us t8e H propert6
of t8e 'dit control 4ill )e set initiall6 to Oero.
Lou can manuall6 c8an$e t8is +alue )ut it 4ill 8a+e no effect on t8e control
)e8a+ior.

>a)el
58e 8ei$8t 7 4idt8 of a La)el control are automaticall6 defined at runtimeI t8us t8e
H 7 & propert6 of t8e La)el control 4ill )e set initiall6 to Oero.
Lou can manuall6 c8an$e t8e H +alue )ut it 4ill 8a+e no effect on t8e control
)e8a+ior.
0f 6ou set t8e & +alue of a La)el to a +alue $reater t8e Oero and 6ou set t8e propert6
(i*i$na)le* to 5rue t8en 48en H,idi 5estH is C8ec-ed t8e text in t8e la)el 4ill flip to t8e
ri$8t accordin$ to t8e & +alue of t8e control.
*nteractin .it0 t0e Custom Dialo
0nteractin$ 4it8 a Custom Dialo$ at setup time is done usin$ t8e H'xecute 'n$ineH.
+nClic&
'+er6 Control can )e lin-ed to an H'xecute 0temH usin$ t8e 1nClic- e+ent.
Lets sa6 6ou 8a+e a )utton on 6our Custom dialo$.
&8en t8e user clic- t8is )utton at setup time 6ou 4ant some action to ta-e place.
5o pro$ram t8is operation do t8e follo4in$D
1. >o to t8e H'xecuteH pa$e and clic- ?** #te&...@.
#. Select H2ndefined Sta$eH in t8e HPerform /tH selection )ox.
%. Pro$ram t8e execute item accordin$ to 6our needs.
(. Clic- ?pply@ and close t8e He4 'xecution 0temH dialo$.
*. >o to t8e HDialo$sH pa$e and clic- ?1usto& Dialogs...@.
6. /dd t8e reEuired )utton.
7. Clic- t8e selection )ox of t8e H1nClic-H propert6.
8. Select t8e H'xecute 0temH 6ou just created.
9. Clic- t8e ?Sa%e@ )utton.
5o test t8is operation do t8e follo4in$D
1. Close t8e HCustom Dialo$H screen.
#. Compile 6our setup )6 clic-in$ t8e ?1o&pile@ )utton.
5ppen6i9es < 'ustom Dia"o.s 11)
%. 3un 6our setup )6 clic-in$ t8e ?"un@ )utton.
(. Clic- t8e ?=e't K@ )utton until 6ou reac8 t8e Custom dialo$.
*. Clic- t8e reEuired )utton on t8e custom dialo$.
%efore2)fter Dialo
2sin$ t8is option 6ou can define operations t8at 4ill ta-e place just )efore and<or
just after a Custom Dialo$ is displa6ed.
Lets sa6 6ou created a Custom Dialo$ )6 t8e name HDialo$ um)er 1H.
>o to t8e H'xecuteH pa$e and clic- ?** #te&...@.
>i+e t8e ne4 0tem a name and clic- t8e HPerform /tH selection )ox.
/t t8e end of t8e list 6ou 4ill see t8e follo4in$ # lines on 6ello4 )ac-$roundD
1. H,efore Dialo$ um)er 1H
#. H/fter Dialo$ um)er 1H.
0f 6ou select t8e first optionI t8e 'xecute 0tem 4ill )e preformed just )efore t8e
Custom Dialo$ is displa6ed.
0f 6ou select t8e second optionI t8e 'xecute 0tem 4ill )e preformed just after t8e
Custom Dialo$ is displa6ed.
-ead2!rite Control Properties
3eadin$ and &ritin$ control properties at setup time can )e done 4it8 special
commands from t8e H'xecute 'n$ineH.
58e follo4in$ HConditionsH are a+aila)leD
Control 5ext is
Control 0tem 0ndex is
Control is C8ec-ed
58e follo4in$ H'xecutionsH are a+aila)leD
Set Control Propert6
>et Control Propert6
1on*ition Sa&plesA
1ontrol 3e't is
/r$umentK1D 'dit#
ComparisonD P
/r$umentK#D ,ill >ates
1ontrol #te& #n*e' is
/r$umentK1D Com)o,ox%
ComparisonD CP
/r$umentK#D #
1ontrol is 1hec2e*
/r$umentK1D C8ec-,ox1
$'ecution Sa&plesA
5ppen6i9es < 'ustom Dia"o.s 115
Set 1ontrol Property
/r$umentK1D 'dit#
/r$umentK#D 5ext
/r$umentK%D ,ill >ates
Get 1ontrol Property
/r$umentK1D 'dit#
/r$umentK#D 5ext
/r$umentK%D @2serameC

Das könnte Ihnen auch gefallen