InstallShield2010学习笔记 - 界面定义.doc

IDE的基本使用界面定义Revision HistoryDATEREVISIONAUTHORDESCRIPTIONTable of Contents1.给Dialog关联指定的Skin（皮肤）文件31.1.右击鼠标，然后选择 Select。31.2.在右边面板中，点击 Select 按钮。选中后的 skin 被红钩标记。32.自定义Dialog和其内含的控件32.1.Welcome dialog:42.2.License Agreement Dialog:43.在IDE和Script中设置Dialog各项属性53.1.如下是在视图中直接设置属性值：53.1.1.在InstallScript视图处，添加这个dialog的方法73.1.2.根据需求修改这个dialog的参数73.1.3.在脚本中添加处理这个dialog的流程73.2.如下是在脚本中设置属性值：73.2.1.定义一个dialog:73.2.2.设置欢迎对话框：83.2.3.设置维护安装开始时使用的对话框83.2.4.设置对话框字体:83.2.5.设置对话框信息：83.2.6.设置目标路径：83.2.7.设置安装选项：83.2.8.设置自定义安装组件列表：83.2.9.设置对话框中显示位图：83.2.10.设置新文件夹的确认提示：83.2.11.设置用户信息输入界面：93.2.12.设置硬盘空间要求：93.2.13.设置显示主题资料数据：93.2.14.设置功能安装对话框：93.2.15.设置安装完成对话框：103.2.16.设置Sd对话框函数的安装：103.2.17.设置安装雅虎工具栏：103.2.18.设置许可协议对话框：113.2.19.设置目的磁盘空间不够警告对话框：113.2.20.为系统变量IFX_PRODUCT_DISPLAY_NAME设置产品名称：113.2.21.设置一个可输入用户名和公司名的对话框：113.2.22.设置可输入用户姓名、公司名称和应用程序序列号的对话框：113.2.23.设置选择文件夹对话框：113.2.24.设置标准安装类型选择对话框：113.2.25.设置标准或自定义安装类型选择对话框：123.2.26.设置行编辑区对话框：123.2.27.设置显示文件更改对话框：123.2.28.设置显示可滚动的消息列表对话框：123.2.29.设置在一个小窗口中显示一个消息：133.2.30.设置一个多行编辑区来显示安装过程中的设置和选项：134.在Script中动态获取Dialog返回值，设置控件属性134.1.动态获取Dialog返回值134.1.1.对于返回值为0或者小于0，如下：134.1.2.对于返回值为按钮标志，如下：134.1.3.对于返回值传给函数参数，如下：134.2.设置控件属性：144.2.1.如设置背景颜色为深蓝色：144.2.2.设置对话框标题如下：144.2.3.设置运行状态的静态文本：144.2.4.设置警告信息对话框：14141. 给Dialog关联指定的Skin（皮肤）文件选择视图User Interface Dialogs Skins，选择一个 skin，在右边面板里面预览该 skin 的显示。有两种方法可以选中一个 skin：1.1. 右击鼠标，然后选择 Select。如下图：1.2. 在右边面板中，点击 Select 按钮。选中后的 skin 被红钩标记。注意：所有的skin都是使用的.gif文件，除了Blue skin 是使用的.bmp文件外。对于.gif文件，在16-bit 的颜色系统上显示不清楚，这种情况下只能用Blue skin，但是Blue skin 使用的.bmp 文件较大，如果你对文件大小有限制，建议使用支持.gif 文件的BlueTC skin。2. 自定义Dialog和其内含的控件在All Dialogs 上右击鼠标，选择New Dialog，如下图：然后弹出Dialog Wizard向导，跟着向导一直往下进行，一直到成功创建dialog。如下图：选中该dialog的一种语言进行编辑，然后在其右边窗口可以配置其内含的控件。对于具体的dialog 设置，如下：2.1. Welcome dialog:它是在安装过程中最先显示的，该dialog有两个目的：1，让用户知道该安装程序正在运行，并显示给用户公司名称。2，显示copyright的信息。为了在welcome dialog 显示公司名称可以做如下操作：Welcome dialog 显示如下：2.2. License Agreement Dialog:在此向最终用户显示许可协议，只有当最终用户同意该协议时，安装程序才会继续运行。为将你的协议文件放置此处，可以进行如下操作：在 Project Assistant 的 Installation Interview page, 选择 “Do you want to display a License Agreement Dialog?” 为 Yes, 然后点击 Browse 按钮，将你自己的许可协议文件添加。注意：该文件必须是以.rtf 结尾的 rich 文件。如下图：在Project Assistant 的 Installation Interview page，还可以为你的安装程序设置其它的Dialogs.如：可以让最终用户输入他们的用户信息，允许最终用户更改安装路径，弹出对话框让用户选择是否安装完成后启动程序，以及在安装完成后是否打开 readme 文件。如下图：3. 在IDE和Script中设置Dialog各项属性3.1. 如下是在视图中直接设置属性值：选中一个Dialog 后，在右边窗口中选择 Edit dialog layout，进入该 dialog 的设计窗口。直接手动拖放可以更改该 dialog 的显示，此外，还可以通过修改该窗口右边的dialog 属性窗口中属性的值，达到更改dialog 的显示。操作如下图：还可以通过选中dialog 后，右击鼠标来编辑它，如果对更改后的dialog不满意，想回滚到先前状态，可以选则Revert Dialog to Default，如下图：下图是dialog 的编辑窗口：下图是与之相对应的属性窗口：当添加或者修改一个dialog后不会直接将这些修改显示到最终用户界面，只有添加OnFirstUIBefore and OnFirstUIAfter 的事件处理后才会显示。以下是步骤：3.1.1. 在InstallScript视图处，添加这个dialog的方法3.1.2. 根据需求修改这个dialog的参数3.1.3. 在脚本中添加处理这个dialog的流程3.2. 如下是在脚本中设置属性值：该处只是对每个方法做简单介绍，具体的请参照文档“InstallShield学习笔记 脚本语言（Script Language）.doc”。另如下所有函数中，参数nReserved是保留为将来使用，它的值只能是0。3.2.1. 定义一个dialog:1. DefineDialog ( szDialogName, hInstance, szDLLName, nDialogID, szDialogID, nReserved, hwndOwner, lMsgLevel );其中参数nDialogID 和szDialogID 是用来唯一标志该 dialog的。该函数定义一个自定义对话框。当你需要指定一个其属性不能由EzDefineDialog指定的对话框的属性时，调用该函数而不是EzDefineDialog。2. EzDefineDialog ( szDialogName, szDLLName, szDialogID, nDialogID ); 该函数定义一个自定义对话框。注意：在调用这两个参数后，该自定义的dialog 不会被显示，WaitOnDialog( szDlgName );才能显示该dialog。3.2.2. 设置欢迎对话框：SdWelcome ( szTitle, szMsg );设置一个对话框来向最终用户显示欢迎信息。3.2.3. 设置维护安装开始时使用的对话框SdWelcomeMaint (szTitle, szMsg, nType);该函数显示一个对话框 ，在一个维护型安装（也就是，一个已经被运行的安装的重运行）的开始时使用。该对话框包含修改、修复、删除选项按钮。3.2.4. 设置对话框字体:DialogSetFont ( szFontName, nFontSize, nReserved );注意：该函数对于调用Windows API显示的窗口无效，对于所有对话框中的标题栏文本无3.2.5. 设置对话框信息：DialogSetInfo ( nInfoType, szInfoString, nParameter );该函数可以设置对话框的如下信息：显示的图象，得到最终用户选择的复选框的风格，指示有效和所需磁盘空间值的精度。注意：通过调用DialogSetInfo产生的修改对安装的剩余部分保持为有效或直到它们又被随后的对DialogSetInfo的调用修改。如果你的脚本在调用任何Sd对话框函数前调用DialogSetInfo，在 DialogSetInfo的调用前必须先调用SdInit。否则，对DialogSetInfo的调用无效。3.2.6. 设置目标路径：SdAskDestPath ( szTitle, szMsg, svDir, nReserved );该函数创建一个对话框，允许最终用户选择一个候选目标路径。当你单击对话框中的浏览按钮，SelectDir函数被调用来打开一个二次对话框使最终用户可以选择一个存在的文件夹或输入一个新的文件夹名。3.2.7. 设置安装选项：SdAskOptions ( szTitle, szMsg1, szMsg2, szId, szFeatures, nExclusiveFlag );该函数创建一个对话框，提供安装选项。你可以使用复选框或单选钮作为选择按钮。显示在按钮旁边的信息从一组选项中检索得到。选项的缺省数目是4。必要时你可以增加或减去组中选项的数目。3.2.8. 设置自定义安装组件列表：SdAskOptionsList ( szTitle, szMsg, szFeatures, nStyle );如果你的安装不使用一个安装类型对话框，你必须在调用SdAskOptionsList前调用ComponentSetupTypeSet来指定一个已经在IDE安装类型窗格中定义的安装类型。3.2.9. 设置对话框中显示位图：SdBitmap ( szTitle, szMsg, szBitmap );该函数在一个对话框中显示一个位图。位图所允许的最大大小是宽440个像素点、高275个像素点。仅当你使用一个资源编辑器来修改SdBitmap对话框资源使得显示消息的控件成为可见时，你才可以在SdBitmap对话框中显示一个消息。3.2.10. 设置新文件夹的确认提示：SdConfirmNewDir ( szTitle, szDir, nReserved );该函数创建一个对话框，显示一个文件夹名和一个确认的提示。如果最终用户单击Yes按钮，则一个新文件夹自动由该函数创建。3.2.11. 设置用户信息输入界面：1. SdCustomerInformation ( szTitle, svName, svCompany, bvAllUsers );该函数显示一个对话框允许最终用户输入用户名和公司名称，以及选择目标机器上的该应用程序是只对当前用户，还是对所有使用该机器的用户。只有当用户名称和公司名称不为空时，Next 按钮才可用。2. SdCustomerInformationEx ( szTitle, svName, svCompany, svSerial, bvAllUsers );该函数的使用基本同上一个函数，只是该函数设置的对话框需要用户输入序列号，并且序列号是必须的，不许为空。3.2.12. 设置硬盘空间要求：SdDiskSpaceRequirements ( szTitle, szMsg );该函数显示一个列表视图，该视图包含容量，需要空间，可用空间，以及需要空间与可用空间的差别。3.2.13. 设置显示主题资料数据：SdDisplayTopics ( szTitle, szMsg, listTopics, listDetails, nReserved );该函数创建一个对话框，显示基于主题数据（资料）的信息。对话框提供一个标题然后是标题的主题和说明。你可以修改说明文本的字体风格以让它和标题（主题）文本想区别。消息和主题标题通常是粗体。可使用该对话框显示帮助主题、例子等。3.2.14. 设置功能安装对话框：1. SdFeatureDialog ( szTitle, szMsg, svDir, szFeatures );该函数创建一个对话框来显示可安装的功能列表和每个功能所需的磁盘空间。这个函数与SdFeatureDialogAdv类似。2. SdFeatureDialog2 ( szTitle, szMsg, szDir, szFeatures );该函数创建一个对话框来显示可安装的功能列表，每个被选功能安装所需的空间和该目标路径可用的空间，以及被选中功能的描述。如果被选中的功能包含子功能，则 Change 按钮被激活。通过点击 Change 按钮来启动Select Subfeatures 对话框，以供最终用户做出更多选择3. SdFeatureDialogAdv ( szTitle, szMsg, svDir, szFeatures );与上面的函数SdDisplayTopics ( szTitle, szMsg, listTopics, listDetails, nReserved ); 相同。4. SdFeatureMult ( szTitle, szMsg, svDir, szFeatures );该函数创建一个对话框来显示如下信息：一个可被最终用户安装的功能和子功能列表。该对话框包含两个功能列表，如果第一个列表中被选中的功能包含子功能，则它的子功能显示在第二个列表里。被选中功能所需的磁盘空间和该目标路径可用的磁盘空间。一个功能的大小在被选择前显示为0，被选中后才显示实际大小。当一个功能被点击时，该功能的描述将显示给最终用户。5. SdFeatureTree ( szTitle, szMsg, szDir, szFeatures, nLevel );该函数与上面所述的函数功能相似，只是它所创建的对话框显示成树形。3.2.15. 设置安装完成对话框：1. SdFinish ( szTitle, szMsg1, szMsg2, szOpt1, szOpt2, bvOpt1, bvOpt2 );该函数显示一个对话框，通知最终用户安装已完成并给用户信息或选择。SdFinish对话框显示两个消息和两个复选框选择选项。例如，你可能想要提供给用户查看README文件或运行应用程序的选择。为在消息中或复选框说明中插入产品名称，在szMsg1, szMsg2, szOpt1, 和szOpt2传递的字符串中使用位置夹%P。2. SdFinishEx (szTitle, szMsg1, szMsg2, szOpt1, szOpt2, bvOpt1, bvOpt2);该函数调用SdFinish或SdFinishReboot来显示一个对话框，通知最终用户安装已完成并给用户信息或选择。如果系统变量BATCH_INSTALL等于FALSE（表明安装过程中没有遇到锁定文件），SdFinishEx调用SdFinish来显示对话框。如果BATCH_INSTALL的值为非0，SdFinishEx调用SdFinishReboot来显示对话框。为在消息中或复选框说明中插入产品名称，在szMsg1, szMsg2, szOpt1, 和szOpt2传递的字符串中使用位置夹%P。3. SdFinishReboot ( szTitle, szMsg1, nDefOption, szMsg2, nReserved );该函数在你的安装结尾宣告安装完成并提供给用户重启系统的选项。重启系统允许修改Autoexec.bat,Config.sys和一些.ini文件使其起作用。SdFinishReboot对话框在静态文本区中显示两个消息。用参数szMsg1和szMsg2来设置这些区域的值。为在消息中或复选框说明中插入产品名称，在szMsg1和szMsg2传递的字符串中使用位置夹%P。4. SdFinishUpdate ( szTitle, szMsg1, szMsg2, bDefOption );该函数只用于InstallScript MSI类型的安装。该函数在安装完成的时候通知用户安装已经完成，并给用户一个选项来选择是否更新应用程序。5. SdFinishUpdateReboot ( szTitle, szMsg1, nDefOption, szMsg2, nChkUpdate, nReserved );该函数也只针对InstallScript MSI类型的安装。该函数在安装完成的时候通知用户安装已经完成，并给用户一个选项来选择是否重启系统，以及是否更新应用程序。3.2.16. 设置Sd对话框函数的安装：SdInit ( );该函数准备一个调用Sd对话框函数的安装：装入所需的资源字符串，还原最小化的InstallShield窗口，并指定在Sd对话框中Windows 95风格的复选框。注意：该函数由每个Sd函数自动调用。没有必要显式调用SdInit，除非你的脚本在调用任何Sd对话框函数前调用了DialogSetInfo。这种情况下，你的脚本必须在调用DialogSetInfo前调用SdInit；否则对DialogSetInfo的调用不起任何作用。3.2.17. 设置安装雅虎工具栏：SdInstallYahooToolbar( byval number nDirection );该函数显示一个或多个对话框来允许最终用户是否安装雅虎工具栏，接受雅虎许可协议，以及是否设置雅虎搜索引擎为默认搜索引擎。3.2.18. 设置许可协议对话框：SdLicense ( szTitle, szMsg, szQuestion, szLicenseFile );该函数显示一个对话框，包含一个在多行编辑区的许可证协议。许可证协议保存在一个由参数szLicenseFile指定的文本文件中。用户可以上下滚动来阅读协议，然后必须选择Yes、No或Enable、Back按钮。因为这可能是你将显示的第一个对话框，你可能要禁止Back按钮。如果用户选择了Yes，安装将继续。如果用户选择了No,InstallShield将显示退出安装对话框。3.2.19. 设置目的磁盘空间不够警告对话框：SdOutOfDiskSpace ( szTitle, szMsg );该函数显示一个对话框来警告最终用户所选目的系统的可用空间不够大来安装该应用程序。该对话框还显示一个视图列表来包含容量，所需空间，可用空间，以及所需空间与可用空间之间的差。3.2.20. 为系统变量IFX_PRODUCT_DISPLAY_NAME设置产品名称：SdProductName ( szProductName );该函数使得你的产品名对所有的%P位置夹都有效。%P位置夹在一些Sd对话框中的静态文本区中找到。另外，一些Sd对话框函数，如SdFinish，允许你在作为函数参数的字符串中包含%P。3.2.21. 设置一个可输入用户名和公司名的对话框：SdRegisterUser ( szTitle, szMsg, svName, svCompany );该函数创建一个对话框，检索用户姓名和公司名称。如果svName和svCompany都包含空字符串，InstallShield将从注册表中得到用户姓名和公司名称。注意：仅当两个编辑区都存在数据时Next按钮才被激活。如果InstallShield可以从系统查找缺省姓名和公司名称，Next按钮被自动激活。完成时，SdRegisteruser调用RegDBSetDefaultRoot来将注册表开关键设置给HKEY_CLASSES_ROOT。3.2.22. 设置可输入用户姓名、公司名称和应用程序序列号的对话框：SdRegisterUserEx ( szTitle, szMsg, svName, svCompany, svSerial );该函数创建一个对话框，检索用户姓名、公司名称和序列号。如果svName和svCompany都包含空字符串，InstallShield将从注册表得到用户姓名和公司名称。注意：仅当三个编辑区都存在数据时Next按钮才被激活。你不能让任何区域空白。完成时，SdRegisteruser调用RegDBSetDefaultRoot来将注册表开关键设置给HKEY_CLASSES_ROOT。3.2.23. 设置选择文件夹对话框：SdSelectFolder ( szTitle, szMsg, svDefGroup );该函数显示供选择的程序文件夹。SdSelectFolder允许你提供一个缺省选择。用户也可以输入一个新的文件夹名。SdSelectFolder将仅返回被选择的或输入的文件夹名。它不能创建文件夹。3.2.24. 设置标准安装类型选择对话框：SdSetupType ( szTitle, szMsg, svDir, nReserved );该函数显示一个对话框允许最终用户选择三种标准安装类型之一：典型、简易或自定义。这些安装选项显示时有标准描述文本。如果你想加入其它安装类型或改变显示的安装类型名或描述，调用SdSetupTypeEx来替代。对话框也显示一个缺省的目标路径。一个Browse按钮装入一个对话框，允许最终用户通过输入一个新文件夹名或从一个列表中选择存在的文件夹来修改目标路径。如果最终用户输入一个不存在的文件夹名，将显示一个消息框来询问是否要创建该文件夹。如果最终用户单击Yes，该函数自动创建指定文件夹。指定文件夹的全限定路径在svDir返回。注意：如果最终用户在使用组件对话框来选定和撤消选定与已选安装类型相联系的组件后，返回到安装类型对话框，那么那些选择将丢失。这种情况发生是因为SdSetupType函数每次被调用时自动根据选中的安装类型复位缺省组件选项。3.2.25. 设置标准或自定义安装类型选择对话框：SdSetupTypeEx ( szTitle, szMsg, szReserved, svSetupType, nReserved );该函数只用于InstallScript MSI类型的安装程序。该函数显示一个对话框，当你指定除典型、简易和自定义之外的安装类型时，允许最终用户选择安装类型。3.2.26. 设置行编辑区对话框：1. SdShowDlgEdit1 ( szTitle, szMsg, szField1, svEdit1 );该函数创建一个对话框来包含一个消息和一个单行编辑区。例子：nResult = SdShowDlgEdit1 (szTitle, szMsg, szField1, svDBServer);2. SdShowDlgEdit2 ( szTitle, szMsg, szField1, szField2, svEdit1, svEdit2 );该函数创建一个对话框来包含一个消息和两个单行编辑区。3. SdShowDlgEdit3 ( szTitle, szMsg, szField1, szField2, szField3, svEdit1, svEdit2, svEdit3 );该函数创建一个对话框来包含一个消息和三个单行编辑区。例子：nResult = SdShowDlgEdit3 (szTitle, szMsg, szField1, szField2, szField3, svUserName, svPassword, svDatabase);3.2.27. 设置显示文件更改对话框：SdShowFileMods ( szTitle, szMsg, szTargetFile, szAltFile, listChanges, nvSelection );该函数创建一个对话框，显示你想要对一个文件进行的修改。下面这些选择是有效的：修改目标文件。修改替代文件，它是目标文件的拷贝，但非联合修改。不作任何修改。SdShowFileMods不对文件作修改。你必须使用适当的文件函数把那些修改写入你的脚本。3.2.28. 设置显示可滚动的消息列表对话框：SdShowInfoList ( szTitle, szMsg, listID );该函数创建一个对话框，显示一个可滚动的消息列表。该函数可显示一个包括将近57,200字节的列表。3.2.29. 设置在一个小窗口中显示一个消息：SdShowMsg ( szMsg, bShow );该函数打开或关闭一个小的非模态窗口，显示由szMsg指定的消息。当bShow为TRUE，窗口被打开，消息显示在窗口中，并且继续脚本中下一个语句的处理。注意SdShowMsg窗口被置于安装窗口的中央。当bShow为FALSE时，szMsg被忽略并且关闭SdShowMsg窗口。注意：当SdShowMsg窗口是打开的，随后的对SdShowMsg（第二个参数为TRUE）的调用被忽略。为改变消息，你必须首先以第二个参数为FALSE调用SdShowMsg来关闭窗口，然后以第二个参数为TRUE，szMsg为新的消息再次调用SdShowMsg。3.2.30. 设置一个多行编辑区来显示安装过程中的设置和选项：SdStartCopy (szTitle, szMsg, listData);该函数创建一个多行编辑区，显示安装过程中所作的设置和选择。为按需改变设置，用户可以单击对话框的Back按钮来返回到以前的对话框。在检索用户的选择后，开始文件传输处理之前调用SdStartCopy。使用一个字符串列表来收集安装过程中得到的信息。然后你可以将该字符串列表