共用方式為

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擴展名。 這個值可以是字串或 %strkey% 標記，該標記定義於 INF 檔案的 Strings 區段中。 如果未指定 DisplayResource 專案， 則連結名稱 也是顯示字串。

選擇性 的 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 會指定子目錄。 如果未指定 subdir ，程式會位於 dirid 所參考的目錄中。

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

SubDir=path
這個選擇性專案會指定子目錄 (子功能表) 功能選單項位於功能表項所在的 Start\Programs 底下。 如果省略此專案，路徑預設為 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。

如果存在， 則icon-subdir 值表示 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
這個選擇性專案會指定功能表項的資訊提示。

這個值可以是字串或 %strkey% 標記，該標記定義於 INF 檔案的 Strings 區段中。

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

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

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

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

ResDllPath 和 ResDll 會指定資源 DLL 的路徑和檔名，而 resID 是代表資源標識碼的正值。 範例如下：

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

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

備註

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

每個 profile-items-section 都包含建立或移除一個 [開始] 功能表項或群組的詳細資訊。 若要從 INF 操作多個功能表項或群組，請建立多個 profile-items-section， 並列出 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