InstallShield6.22 AddFolderIcon使用注意事项

InstallShield6.22 AddFolderIcon使用注意事项



AddFolderIcon

语法：AddFolderIcon (szProgramFolder, szItemName,
szCommandLine, szWorkingDir,

szIconPath, nIcon, szShortCutKey, nFlag);

说明：AddFolderIcon函数插入或置换由szProgramFolder指定的程序文件夹中的一个图标。如果程序文件夹不存在，AddFolderIcon创建它。SzProgramFolder可以在一个多级级联式菜单中指定一个子文件夹。如果子文件夹不存在，AddFolderIcon将创建该子文件夹，并且在必要时创建它的父文件夹。

当添加图标到Windows NT下的组时，首先调用ProgDefGroupType来确定组为公用还是专用。缺省时，文件夹图标添加为公用。

参数：

szProgramFolder

指定将图标添加至的文件夹的名称。如果该文件夹不存在，InstallShield创建它。

为添加图标到具体的文件夹，指定全限定路径，如：

"C:\\WINDOWS\\STARTMENU\\PROGRAMS\\ACCESSORIES\\GAMES".

为添加一个快捷方式图标到Windows 95及更高版本的开始程序菜单，给该参数传递一个空字符串(“”)。

注意你也可以在该参数位置传递下列InstallShield系统变量之一：

FOLDER_DESKTOP：将图标添加到桌面文件夹。

FOLDER_STARTUP：将图标添加到启动菜单文件夹。

FOLDER_STARTMENU：将图标添加到开始菜单文件夹。

FOLDER_PROGRAMS：将图标添加到开始菜单\程序文件夹。

你也可以指定一个相对于一个由InstallShield系统变量标识的文件夹的路径，例如，

FOLDER_PROGRAMS ^ "ACCESSORIES\\GAMES"

指定要添加到文件夹的图标名。该名将显示在图标下面。在Windows 95及更高版本下，调用AddFolderIcon添加一个图标到一个程序文件夹时，也在由szCommandLine指定的链接目录中创建一个链接文件。注意开发人员外壳不允许在项目名中有下列字符：/, \, :, ?, <, >, 或 |。

szCommandLine

指定下列情况之一：

和图标相联系的可执行文件的全限定名，包括任何命令行参数。为添加一个快捷方式图标到Windows
95及更高版本的开始程序菜单，输入一个链接目录的全限定路径，在那儿你的应用程序存放了它的图标链接文件。

全限定路径，如果szItemName是一个子文件夹 。（仅对Windows 95及更高版本、Windows NT 4.0）。

如果命令行包含一个长文件名，它必须由引号包围（括起）。更多信息请查看下面的注解部分。

szWorkingDir

指定应用程序文件所在的目录。（如果szItemName是一个子文件夹则不适用）。为使得包含程序文件的目录为工作目录，给该参数传递一个空字符串(“”)。不要调用LongPathToQuote来把该路径包围（括）在引号中。更多信息请查看下面的注解部分。

szIconPath

定要显示的图标的全限定文件名。（如果szItemName是一个子文件夹则不适用）。不要调用LongPathToQuote来把该路径包围（括）在引号中。更多信息请查看下面的注解部分。

nIcon

指定Windows中由szIconPath指定的可执行文件的的图标序号。（如果szItemName是一个子文件夹则不适用）。图标序号数从0开始，因此为显示可执行文件的第一个图标，指定0；为显示第二个，指定1，如此继续。如果你不使用一个Windows图标，给该参数指定0。

szShortCutKey

指定快捷键（以字符串形式），允许最终用户迅速启动应用程序。例如，如果你想要能通过按下”Ctrl”,”Alt”然后”1”键来打开应用程序，则给该参数传递”Ctrl+Alt+1”。 如果szItemName是一个子文件夹则不适用）。

nFlag

指定图标表现形式。在该参数位置传递下列预定义常量之一或多个。为给该参数传递两个或更多预定义常量，用按位或操作符(|)将那些常量进行组合：

REPLACE：表明文件夹中的当前图标或项目被置换。

RUN_MAXIMIZED：表明程序被装入时必须被最大化。

RUN_MINIMIZED：表明程序被装入时必须被最小化。

NULL：表明没有选项。

返回值：

0：表明函数成功添加或置换指定文件夹中的图标并使可执行文件和图标相关联。

< 0：表明函数没有能添加或置换指定文件夹中的图标并使可执行文件和图标相关联。

注解：

·如果到你的应用程序可执行文件的路径包含长路径名，你必须把该全限定文件名用单引号或双引号括起来。（如果文件名已经被赋给一个变量，传递该变量给LongPathToQuote来插入引号。）注意命令行参数必须不被引号包围。因此，建议从两个分隔的字符串来建立一个szCommandLine字符串。

·不要调用LongPathToQuote来得到作为参数szWorkingDir 和 szIconPath的表达式。InstallShield自动将这些路径括在引号中。

图标路径szIconPath却不需要用引号括起来；