安装程序事件函数

安装程序支持下列事件函数:

• function InitializeSetup(): Boolean;
  在安装程序初始化期间调用。返回 False 以中止 Setup，否则返回 True。

• procedure InitializeWizard();
  在启动时使用该事件函数来改变向导或向导页面。你不能在它被触发时使用 InitializeSetup 事件函数，因为向导窗体尚不存在。

• procedure DeinitializeSetup();
  仅在安装程序终止前调用。注意这个函数在即使用户在任何内容安装之前退出安装程序时也会调用。

• procedure CurStepChanged(CurStep: TSetupStep);
  你可以用这个事件函数执行你自己的预安装和安装后任务。
  在实际安装开始之前用 CurStep=ssInstall 调用，或在实际安装完成之后用 CurStep=ssPostInstall 调用，或在安装程序终止之前和安装完成之后用 CurStep=ssDone 调用。

• procedure CurInstallProgressChanged(CurProgress, MaxProgress: Integer);
  在安装程序提取文件、创建快捷方式、创建 INI 条目和创建注册表项时，你可以使用该事件函数来监测进程。

• function NextButtonClick(CurPageID: Integer): Boolean;
  当用户单击下一步按钮时调用。如果你返回 True，向导将移到下一页面；如果返回 False，它仍保留在当前页面(用 CurPageID 指定)。
  注意，该函数在静默安装时也会调用，即使没有下一步按钮让用户单击。安装程序会模拟单击下一步按钮。在静默安装中，如果你的 NextButtonClick 函数在安装之前返回 False，安装程序将自动退出。

• function BackButtonClick(CurPageID: Integer): Boolean;
  当用户单击上一步按钮时调用。如果你返回 True，向导将移到上一页面；如果返回 False，它仍保留在当前页面(用 CurPageID 指定)。

• procedure CancelButtonClick(CurPageID: Integer; var Cancel, Confirm: Boolean);
  当用户单击取消按钮或单击窗口中的关闭按钮时调用。Cancel 参数指定是否是一般的取消进程；默认为 True。Confirm 参数指定是否显示“退出安装程序吗？”的消息框；一般它默认为 True。如果 Cancel 设为 False，那么 Confirm 值被忽略。

• function ShouldSkipPage(PageID: Integer): Boolean;
  向导调用这个事件函数确定是否在所有页面或不在一个特殊页面(用 PageID 指定)显示。如果返回 True，将跳过该页面；如果你返回 False，该页面被显示。
  注意：这个事件函数不被 wpWelcome、wpPreparing 和 wpInstalling 页面调用，还有安装程序已经确定要跳过的页面也不会调用(例如，没有包含组件安装程序的 wpSelectComponents)。

• procedure CurPageChanged(CurPageID: Integer);
  在新向导页面(用 CurPageID 指定)显示后调用。

• function CheckPassword(Password: String): Boolean;
  如果安装程序在 Pascal 脚本中发现 CheckPassword 事件函数，它自动显示密码页面并调用 CheckPassword 检查密码。返回 True 表示接受密码，返回 False 拒绝。
  要避免在编译的安装程序的 [Code] 区段内部贮存真实的密码，你应该用其它无用的信息进行比较: 计算你自己密码的 SHA1 的无用信息，然后编译到 GetSHA1OfString(Password)。通过这种方法保护实际密码值。
  注意：如果安装程序带一个 /PASSWORD= 命令行参数运行，则你的 CheckPassword 函数将在任何其他事件函数之前被调用，包括 InitializeSetup。

• function NeedRestart(): Boolean;
  返回 True 告诉安装程序提示用户在安装结束时重新启动系统，False 则反之。

• function UpdateReadyMemo(Space, NewLine, MemoUserInfoInfo, MemoDirInfo, MemoTypeInfo, MemoComponentsInfo, MemoGroupInfo, MemoTasksInfo: String): String;
  如果安装程序在 Pascal 脚本中发现 UpdateReadyMemo 事件函数，当准备安装向导页面变为活动页面时自动调用。它返回的文字显示在准备安装向导页面的设置备注中，作为由 NewLine 参数分隔行的单个字串。参数 Space 包含一个带空格的字串。安装程序使用该字串来进行缩进设置。其它参数将包含安装程序用于设置区段的字串(可能是空的)。例如 MemoDirInfo 参数包含象选择目录区段的字串。

• procedure RegisterPreviousData(PreviousDataKey: Integer);
  要在自定义向导页面中贮存用户输入的设置，在 Pascal 脚本中放入一个 RegisterPreviousData 事件函数，并调用 SetPreviousData(PreviousDataKey, ...) 替换它，每个设置一次。

• function CheckSerial(Serial: String): Boolean;
  如果安装程序在 Pascal 脚本中发现 CheckSerial 事件函数，将在用户信息向导页面中自动出现一个序列号对象(必须在你的 [Setup] 区段中使用 UserInfoPage=yes !)。返回 True 表示接受序列号，返回 False 拒绝。当使用序列号时，请一定要记住，这个软件无加密可言，况且 Inno Setup 源代码是免费获取的，它对于有经验的人从安装程序中删除序列号保护并不是很困难的事。使用这个只是方便用户在你的应用程序中仔细检查输入的序列号(贮存在 {userinfoserial} 常量)。

• function GetCustomSetupExitCode: Integer;
  返回一个非零值命令安装程序返回一个自定义退出代码。这个函数只在安装程序运行完成并且退出代码已是零时调用。同时请参见安装退出代码。

• function PrepareToInstall(var NeedsRestart: Boolean): String;
  你可以使用该事件函数来监测并安装丢失的先决条件和/或关闭任何有关被更新的应用程序。
  返回非空字串以指示安装程序停止在准备安装向导页面，将返回的字串显示为错误消息。如果需要重新启动，请将 NeedsRestart 设置为 True（并返回非空字串）。如果以这种方式停止安装程序，它将使用安装程序退出代码中所述的专用退出代码退出。在这种情况下，不会使用由 /RESTARTEXITCODE= 命令行参数设置的任何自定义退出代码。
  如果 CloseApplications 设置为 yes，则在安装程序对正在使用的文件检查前，该事件函数被调用。
  仅当安装程序尚未确定无法继续时才会调用此函数，因为 [Files] 和 [InstallDelete] 区段中指定的一个或多个文件已队列（通过某些其他安装），以便在下次重新启动时进行替换或删除。

• procedure RegisterExtraCloseApplicationsResources;
  如果 CloseApplications 被设置为 yes，则要注册安装程序会检查正在使用的那个额外文件，在 Pascal 脚本中放置一个 RegisterExtraCloseApplicationsResources 事件函数，并在其内部调用 RegisterExtraCloseApplicationsResource，每次一个文件。

卸载事件函数

卸载支持下列函数:

• function InitializeUninstall(): Boolean;
  返回 False 中止卸载，True 则反之。

• procedure InitializeUninstallProgressForm();
  使用该事件函数对进度窗体在启动时进行更改。你不能使用 InitializeUninstall 事件函数，因为在它被触发时该进度窗体尚不存在。

• procedure DeinitializeUninstall();

• procedure CurUninstallStepChanged(CurUninstallStep: TUninstallStep);

• function UninstallNeedRestart(): Boolean;
  返回 True 以指示卸载程序在成功卸载结束时，提示用户重新启动系统，False 则反之。