INF ProfileItems-instructie

Een ProfileItems-instructie wordt gebruikt in een SECTIE INF DDInstall om een of meer profielitems-secties weer te geven die items of groepen bevatten die moeten worden toegevoegd aan of verwijderd uit het menu Start.

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

Elke benoemde sectie waarnaar wordt verwezen door een ProfileItems-instructie heeft de volgende vorm:

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

Deze richtlijn wordt ondersteund in Windows XP en latere versies van Windows.

Invoer

Name=link-name[,name-attributes]
De koppelingsnaam geeft de naam op van de koppeling voor het menu-item of de groep, zonder de .lnk extensie. Deze waarde kan een tekenreeks of een %strkey% token zijn dat is gedefinieerd in een sectie Tekenreeksen van het INF-bestand. Als er geen DisplayResource-vermelding is opgegeven, is de koppelingsnaam ook de weergavetekenreeks.

De optionele waarde voor naamkenmerken geeft een of meer vlaggen op die van invloed zijn op de bewerking in het menu-item. Deze waarde wordt uitgedrukt als een ORed-bitmasker van door het systeem gedefinieerde vlagwaarden. Mogelijke vlaggen zijn onder andere:

0x00000001 (FLG_PROFITEM_CURRENTUSER)
Hiermee wordt Windows om een menu-item Start in het profiel van de huidige gebruiker te maken of te verwijderen. Als deze vlag niet is opgegeven, Windows het item voor alle gebruikers verwerkt.

0x00000002 (FLG_PROFITEM_DELETE)
Hiermee wordt Windows om het menu-item te verwijderen. Als deze vlag niet is opgegeven, wordt het item gemaakt.

0x00000004 (FLG_PROFITEM_GROUP)
Hiermee wordt Windows om een startmenugroep onder Start\Programma's te maken of te verwijderen. Als deze vlag niet is opgegeven, Windows een menu-item maakt of verwijdert, niet een menugroep.

Als er geen vlag is opgegeven, maakt Windows een menu-item voor alle gebruikers.

CmdLine=dirid,[subdir],bestandsnaam
De dirid geeft een waarde op die de map identificeert waarin het opdrachtprogramma zich bevindt. Een dirid van 11 geeft bijvoorbeeld de systeemmap aan. De mogelijke diridwaarden worden vermeld in de beschrijving van de diridwaarde in de sectie DestinationDirs .

Als er een subdir-tekenreeks aanwezig is, bevindt het opdrachtprogramma zich in een submap van de map waarnaar wordt verwezen door dirid. De subdir geeft de submap op. Als er geen subdir is opgegeven, bevindt het programma zich in de map waarnaar wordt verwezen door dirid.

De bestandsnaam geeft de naam op van het programma dat is gekoppeld aan het menu-item.

SubDir=pad
Met deze optionele vermelding geeft u een submap (submenu) onder Start\Programma's waarin het menu-item zich bevindt. Als deze vermelding wordt weggelaten, wordt het pad standaard ingesteld op Start\Programs.

Als de profiel-items-sectie bijvoorbeeld de vermelding Subdir=Accessoires\Games heeft, wordt het menu-item gemaakt of verwijderd in het submenu Start\Programs\Accessories\Games.

WorkingDir=wd-dirid[,wd-subdir]
Met deze optionele vermelding wordt een werkmap voor het opdrachtprogramma opgegeven. Als deze vermelding wordt weggelaten, wordt de werkmap standaard ingesteld op de map waarin het opdrachtprogramma zich bevindt.

De wd-dirid-waarde identificeert de werkmap. Zie Diriden gebruiken voor lijsten met mogelijke diriden.

De wd-subdir-tekenreeks , indien aanwezig, geeft een submap van wd-dirid aan als de werkmap. Gebruik deze parameter om een map op te geven die geen door het systeem gedefinieerde map heeft. Als deze parameter wordt weggelaten, geeft de wd-dirid-waarde alleen de werkmap aan.

IconPath=icon-dirid,[icon-subdir],icon-bestandsnaam
Met deze optionele vermelding geeft u de locatie op van een bestand dat een pictogram voor het menu-item bevat.

De pictogram-dirid-tekenreeks identificeert de map voor het DLL-bestand dat het pictogram bevat. Zie Diriden gebruiken voor lijsten met mogelijke diriden.

De waarde van het pictogram-subdir , indien aanwezig, geeft aan dat het DLL-bestand zich in een submap van icon-dirid bevindt. De waarde van het pictogram-subdir geeft de submap aan.

De waarde voor de bestandsnaam van het pictogram geeft het DLL-bestand op dat het pictogram bevat.

Als deze vermelding wordt weggelaten, zoekt Windows naar een pictogram in het bestand dat is opgegeven in de cmdLine-vermelding.

IconIndex=index-value
Deze optionele vermelding geeft aan welk pictogram in een DLL moet worden gebruikt voor het menu-item. Zie de documentatie van de Microsoft Windows SDK voor informatie over het indexeren van de pictogrammen in een DLL.

Als er een IconPath-vermelding is opgegeven, wordt de indexwaarde geïndexeerd in die DLL. Anders wordt deze waarde geïndexeerd in het bestand dat is opgegeven in de vermelding CmdLine .

Sneltoets=sneltoets-waarde
Met deze optionele vermelding geeft u een toetsenbordversneller op voor het menu-item.

Zie de Windows SDK-documentatie voor meer informatie over sneltoetsen.

Infotip=info-tip
Met deze optionele vermelding geeft u een informatieve tip op voor het menu-item.

Deze waarde kan een tekenreeks of een %strkey% token zijn dat is gedefinieerd in een sectie Tekenreeksen van het INF-bestand.

De waarde van de info-tip kan ook worden opgegeven als @ResDllPath\ResDll,-ResID, waarbijResDllPath en ResDll het pad en de bestandsnaam van een resource-DLL opgeven en -resID een negatieve waarde is die een resource-id vertegenwoordigt.

Gebruik deze indeling ter ondersteuning van Windows Mui (Meertalige gebruikersinterface). Een voorbeeld is als volgt:

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

DisplayResource="ResDllPath\ResDll",ResID
Met deze optionele vermelding geeft u een tekenreeksresource op die een lokaliseerbare tekenreeks identificeert, die moet worden gebruikt in het menu Start als weergavenaam voor snelkoppeling of groep.

ResDllPath en ResDll geven het pad en de bestandsnaam van een resource-DLL op en resID is een positieve waarde die een resource-id vertegenwoordigt. Een voorbeeld is als volgt:

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

Gebruik deze vermelding om ondersteuning te bieden voor Windows MUI (Meertalige gebruikersinterface). Als deze vermelding niet wordt gebruikt, wordt de tekenreeks weergegeven die is opgegeven door de naamvermelding .

Remarks

Een bepaalde profiel-items-sectienaam moet uniek zijn binnen het INF-bestand en moet voldoen aan de algemene regels voor het definiëren van sectienamen. Zie Algemene syntaxisregels voor INF-bestanden voor meer informatie over deze regels.

Elke sectie met profielitems bevat gedetailleerde informatie voor het maken of verwijderen van één menu-item of groep start. Als u meer dan één menu-item of groep wilt bewerken vanuit een INF, maakt u meer dan één profielitems-sectie en vermeldt u de secties in de ProfileItems-instructie .

Een van de tekenreeksparameters die zijn opgegeven in de vermeldingen in de sectie profile-items , kunnen worden opgegeven met behulp van een %strkey% token, zoals beschreven in algemene syntaxisregels voor INF-bestanden.

Examples

In het volgende INF-bestandsfragment ziet u hoe u de sectie profielitems gebruikt om rekenmachine toe te voegen aan het menu Start.

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

In het volgende FRAGMENT van het INF-bestand ziet u hoe u dezelfde software installeert met behulp van de Vermelding DisplayResource om gelokaliseerde menu-items te maken.

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

Zie ook

DDInstall