共用方式為


INF ProfileItems 指示詞

警告

從 Windows 11 版本 22H2 開始, 使用此指示詞的驅動程式套件 已不再有資格從 硬體開發人員中心簽章。

通用驅動程式套件Windows 驅動程式 無法使用這個指示詞。

ProfileItems 指示詞用於 INF DDInstall 區段中,列出一或多個配置檔專案區段,其中包含要加入或移除之專案或群組的 [開始] 功能表。

[DDInstall] 
 
ProfileItems=profile-items-section[,profile-items-section]...
...

ProfileItems 指示詞所參考的每個具名區段都有下列形式:

[profile-items-section]
 
Name=link-name[,name-attributes]
CmdLine=dirid,[subdir],filename
[SubDir=path]
[WorkingDir=wd-dirid,wd-subdir]
[IconPath=icon-dirid,[icon-subdir],icon-filename]
[IconIndex=index-value]
[HotKey=hotkey-value]
[Infotip=info-tip]
[DisplayResource="ResDllPath\ResDll",ResID]

Windows XP 和更新版本的 Windows 支援此指示詞。

項目

Name=link-name[name-attributes]
link-name 會指定功能表項或群組的連結名稱,而不需要.lnk擴展名。 這個值可以是 INF 檔案之 Strings 區段中定義的字串或 %strkey% 令牌。 如果未指定 DisplayResource 專案,則 link-name 也是顯示字串。

選擇性 的 name-attributes 值會指定一或多個旗標,影響功能表項上的作業。 此值會以系統定義旗標值的 ORed 位掩碼表示。 可能的旗標包括下列專案:

0x00000001 (FLG_PROFITEM_CURRENTUSER)
指示 Windows 在目前使用者配置檔中建立或刪除 [開始] 功能表 專案。 如果未指定此旗標,Windows 會處理所有用戶的專案。

0x00000002 (FLG_PROFITEM_DELETE)
指示 Windows 刪除功能表項。 如果未指定此旗標,則會建立專案。

0x00000004 (FLG_PROFITEM_GROUP)
指示 Windows 在 \[開始\程式\] 底下建立或刪除 [開始] 功能表 群組。 如果未指定此旗標,Windows 會建立或刪除功能表項,而不是功能表群組。

如果未指定旗標,Windows 會為所有使用者建立功能表項。

CmdLine=dirid[subdir]filename
dirid 會指定值,識別命令程式所在的目錄。 例如, 11 的 dirid 表示系統目錄。 可能的 dirid 值列在 DestinationDirs 區段中的 dirid 值描述

如果子字串存在,命令程式會位於 dirid參考目錄的子目錄中。 子 目錄 會指定子目錄。 如果未指定 subdir,則程式位於 dirid參考的目錄中。

檔名會指定與功能表項相關聯的程式名稱。

SubDir=path
這個選擇性專案會在功能表項所在的 Start\Programs 下指定子目錄 (submenu)。 如果省略這個專案,路徑預設為 Start\Programs。

例如,如果 profile-items-section 有專案 “Subdir=Accessories\Games”,則會在 Start\Programs\Accessories\Games 子功能表中建立或刪除功能表。

注意

如果為 name-attributes 指定FLG_PROFITEM_GROUP, 則會忽略 SubDir 專案。

WorkingDir=wd-dirid[wd-subdir]
這個選擇性專案會指定命令程式的工作目錄。 如果省略這個專案,工作目錄會預設為命令程式所在的目錄。

wd-dirid 值會識別工作目錄。 如需可能的 dirid 值清單,請參閱 使用 Dirids

如果存在,則 wd-subdir 字串會指定要做為工作目錄的 wd-dirid 子目錄。 使用此參數來指定沒有系統定義 dirid 的目錄。 如果省略此參數, 則 wd-dirid 值會單獨指定工作目錄。

IconPath=icon-dirid[icon-subdir]icon-filename
這個選擇性專案會指定包含功能表項圖示的檔案位置。

icon-dirid 字串會識別包含圖示之 DLL 的目錄。 如需可能的 dirid 值清單,請參閱 使用 Dirids

圖示子值,如果存在,表示 DLL 位於 icon-dirid子目錄中。 icon-subdir 值會指定子目錄。

icon-filename 值會指定包含圖示的 DLL。

如果省略這個專案,Windows 會在 CmdLine 專案中指定的檔案中尋找圖示。

IconIndex=index-value
這個選擇性專案會指定要用於功能表項之 DLL 中的圖示。 如需如何在 DLL 中編製圖示索引的資訊,請參閱Microsoft Windows SDK 檔。

如果指定 IconPath 專案,索引會索引到該 DLL。 否則,這個值會索引到 CmdLine 專案中指定的檔案。

HotKey=hotkey-value
這個選擇性專案會指定功能表項的鍵盤快速鍵。

如需熱鍵的詳細資訊,請參閱 Windows SDK 檔。

Infotip=info-tip
這個選擇性專案會指定功能表項的資訊提示。

這個值可以是 INF 檔案之 Strings 區段中定義的字串或 %strkey% 令牌。

資訊提示值也可以指定為 “@ResDllPath\ResDll,-ResID,其中 ResDllPathResDll 指定資源 DLL 的路徑和檔名,而 -resID 是代表資源標識符的負值。

使用此格式來支援 Windows 多語系使用者介面 (MUI)。 範例如下:

InfoTip = "@%11%\shell32.dll,-22531"

DisplayResource=“ResDllPath\ResDll”,ResID
這個選擇性專案會指定字串資源,以識別可本地化的字串,以用於 [開始] 功能表 做為快捷方式或群組的顯示名稱。

ResDllPathResDll 會指定資源 DLL 的路徑和檔名,而 resID 是代表資源標識碼的正值。 範例如下:

DisplayResource="%11%\shell32.dll",22019

使用這個項目來支援 Windows 多語系使用者介面 (MUI)。 如果未使用此專案,則會顯示 Name 專案指定的字串。

備註

指定的 profile-items-section 名稱在 INF 檔案中必須是唯一的,而且必須遵循定義區段名稱的一般規則。 如需這些規則的詳細資訊,請參閱 INF 檔案的一般語法規則。

每個 profile-items-section 都包含建立或移除一個 [開始] 功能表 專案或群組的詳細資訊。 若要從 INF 操作多個功能表項或群組,請建立多個配置檔專案區段,並列出 ProfileItems 指示詞中的區段

您可以使用 %strkey% 標記來指定 profile-items-section 專案中指定的任何字串參數,如 INF 檔案的一般語法規則中所述

範例

下列 INF 檔案摘錄顯示如何使用 profile-items-section 將計算機新增至 [開始] 功能表。

[CalcInstallItems]
Name = %Calc_DESC%
CmdLine = 11,, calc.exe
SubDir = %Access_GROUP%
WorkingDir = 11
InfoTip = %Calc_TIP%
:
:
[Strings]
AccessGroup = "Accessories"
Calc_DESC = "Calculator"
Calc_TIP = "Performs basic arithmetic tasks with an on-screen calculator"

下列 INF 檔案摘錄顯示如何使用 DisplayResource 專案來建立當地語系化功能表項來安裝相同的軟體

[CalcInstallItems]
Name = %Calc_DESC%
CmdLine = 11,, calc.exe
SubDir = %Access_GROUP%
WorkingDir = 11
InfoTip = "@%11%\shell32.dll,-22531"
DisplayResource="%11%\shell32.dll",22019
:
:
[Strings]
Access_GROUP = "Accessories"
Calc_DESC = "Calculator"

另請參閱

DDInstall