INF ProfileItems-direktiv

Caution

Från och med Windows 11 version 22H2 är ett drivrutinspaket som använder det här direktivet inte längre berättigat till en signatur från Hardware Developer Center.

Universella drivrutinspaket och Windows Drivrutiner kan inte använda det här direktivet.

Ett ProfileItems-direktiv används i ett INF DDInstall-avsnitt för att visa en eller flera profilobjektavsnitt som innehåller objekt eller grupper som ska läggas till eller tas bort från Start-menyn.

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

Varje namngivet avsnitt som refereras till av ett ProfileItems-direktiv har följande formulär:

[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]

Det här direktivet stöds i Windows XP och senare versioner av Windows.

Inlägg

Name=link-name[,name-attributes]
Länknamnet anger namnet på länken för menyalternativet eller gruppen, utan .lnk-tillägget. Det här värdet kan vara en sträng eller en %strkey -% token som definieras i avsnittet Strängar i INF-filen. Om en DisplayResource-post inte har angetts är länknamnet också visningssträngen.

Det valfria värdet för namnattribut anger en eller flera flaggor som påverkar åtgärden i menyalternativet. Det här värdet uttrycks som en ORed-bitmask av systemdefinierade flaggvärden. Möjliga flaggor omfattar följande:

0x00000001 (FLG_PROFITEM_CURRENTUSER)
Instruerar Windows att skapa eller ta bort ett Start-menyalternativ i den aktuella användarens profil. Om den här flaggan inte har angetts bearbetar Windows objektet för alla användare.

0x00000002 (FLG_PROFITEM_DELETE)
Dirigerar Windows att ta bort menyalternativet. Om den här flaggan inte har angetts skapas objektet.

0x00000004 (FLG_PROFITEM_GROUP)
Dirigerar Windows att skapa eller ta bort en Start-menygrupp under Start\Program. Om den här flaggan inte har angetts skapar eller tar Windows bort ett menyalternativ, inte en menygrupp.

Om ingen flagga anges skapar Windows ett menyalternativ för alla användare.

CmdLine=dirid,[subdir],filename
Dirid anger ett värde som identifierar katalogen där kommandoprogrammet finns. Ett dirid av 11 anger till exempel systemkatalogen. Möjliga diridvärden visas i beskrivningen av dirid-värdet i avsnittet DestinationDirs .

Om det finns en underordnad sträng finns kommandoprogrammet i en underkatalog till katalogen som refereras till av dirid. Undermappen anger underkatalogen. Om inget underordnat objekt har angetts finns programmet i katalogen som refereras till av dirid.

Filnamnet anger namnet på programmet som är associerat med menyalternativet.

SubDir=path
Den här valfria posten anger en underkatalog (undermeny) under Start\Program där menyalternativet finns. Om den här posten utelämnas är sökvägen som standard Start\Programs.

Om avsnittet profile-items-har posten "Subdir=Accessories\Games" skapas eller tas menyalternativet bort i undermenyn Start\Programs\Accessories\Games.

Note

Om FLG_PROFITEM_GROUP anges för namnattribut ignorerasposten SubDir .

WorkingDir=wd-dirid[,wd-subdir]
Den här valfria posten anger en arbetskatalog för kommandoprogrammet. Om den här posten utelämnas används arbetskatalogen som standard i den katalog där kommandoprogrammet finns.

Värdet wd-dirid identifierar arbetskatalogen. Listor över möjliga diridvärden finns i Använda Dirids.

Om det finns en wd-subdir-sträng anger den en underkatalog med wd-dirid som arbetskatalog. Använd den här parametern för att ange en katalog som inte har ett systemdefinierat dirid. Om den här parametern utelämnas anger enbart wd-dirid-värdet arbetskatalogen.

IconPath=icon-dirid,[icon-subdir],icon-filename
Den här valfria posten anger platsen för en fil som innehåller en ikon för menyalternativet.

Strängen icon-dirid identifierar katalogen för den DLL som innehåller ikonen. Listor över möjliga diridvärden finns i Använda Dirids.

Värdet icon-subdir anger, om det finns, att DLL:en finns i en underkatalog till icon-dirid. Värdet icon-subdir anger underkatalogen.

Värdet icon-filename anger den DLL som innehåller ikonen.

Om den här posten utelämnas letar Windows efter en ikon i filen som anges i posten CmdLine.

IconIndex=index-value
Den här valfria posten anger vilken ikon i en DLL som ska användas för menyalternativet. Information om hur du indexar ikonerna i en DLL finns i dokumentationen om Microsoft Windows SDK.

Om en IconPath-post har angetts, index-värde index i den DLL. Annars indexerar det här värdet i filen som anges i posten CmdLine .

HotKey=hotkey-value
Den här valfria posten anger en tangentbordsaccelerator för menyalternativet.

Mer information om snabbnycklar finns i dokumentationen om Windows SDK.

Infotip=info-tip
Den här valfria posten anger ett informationstips för menyalternativet.

Det här värdet kan vara en sträng eller en %strkey -% token som definieras i avsnittet Strängar i INF-filen.

Info-tip-värdet kan också anges som "@ResDllPath\ResDll,-ResID", där ResDllPath och ResDll anger sökvägen och filnamnet för en resurs-DLL och -resID är ett negativt värde som representerar ett resurs-ID.

Använd det här formatet för att stödja Windows MUI (Multilingual User Interface). Ett exempel är följande:

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

DisplayResource="ResDllPath\ResDll",ResID
Den här valfria posten anger en strängresurs som identifierar en localizable-sträng som ska användas på Start-menyn som visningsnamn för genväg eller grupp.

ResDllPath och ResDll anger sökvägen och filnamnet för en resurs-DLL och resID är ett positivt värde som representerar ett resurs-ID. Ett exempel är följande:

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

Använd den här posten för att stödja Windows MUI (Multilingual User Interface). Om den här posten inte används visas strängen som anges av posten Namn .

Remarks

Ett angivet profilobjektavsnittsnamn måste vara unikt i INF-filen och måste följa de allmänna reglerna för att definiera avsnittsnamn. Mer information om dessa regler finns i Allmänna syntaxregler för INF-filer.

Varje avsnitt för profilobjekt innehåller detaljerad information för att skapa eller ta bort ett Start-menyalternativ eller en grupp. Om du vill ändra fler än ett menyobjekt eller en grupp från en INF skapar du mer än ett profilobjektavsnitt och listar avsnitten i ProfileItems-direktivet .

Alla strängparametrar som anges i profilobjektavsnittsposterna kan anges med hjälp av en %strkey -% token, enligt beskrivningen i Allmänna syntaxregler för INF-filer.

Examples

Följande INF-filutdrag visar hur du använder avsnittet profile-items-för att lägga till Kalkylatorn på Start-menyn.

[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"

Följande INF-filutdrag visar hur du installerar samma programvara med hjälp av posten DisplayResource för att skapa lokaliserade menyalternativ.

[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"

Se även

DDInstall