Dyrektywa INF ProfileItems

Dyrektywa ProfileItems jest używana w sekcji INF DDInstall, aby wyświetlić listę co najmniej jednej sekcji elementów profilu, które zawierają elementy lub grupy do dodania lub usunięcia z menu Start.

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

Każda nazwana sekcja, do którego odwołuje się dyrektywa ProfileItems , ma następującą postać:

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

Ta dyrektywa jest obsługiwana w Windows XP i nowszych wersjach Windows.

Wpisy

Name=link-name[,name-attributes]
Nazwa łącza określa nazwę łącza dla elementu menu lub grupy bez rozszerzenia .lnk . Ta wartość może być ciągiem lub tokenem %strkey% zdefiniowanym w sekcji Ciągi pliku INF. Jeśli wpis DisplayResource nie jest określony, nazwa-łącza jest również ciągiem wyświetlanym.

Opcjonalna wartość name-attributes określa co najmniej jedną flagę, która ma wpływ na operację w elemencie menu. Ta wartość jest wyrażona jako maska bitów ORed wartości flag zdefiniowanych przez system. Możliwe flagi obejmują następujące elementy:

0x00000001 (FLG_PROFITEM_CURRENTUSER)
Kieruje Windows, aby utworzyć lub usunąć element menu Start w profilu bieżącego użytkownika. Jeśli ta flaga nie zostanie określona, Windows przetworzy element dla wszystkich użytkowników.

0x00000002 (FLG_PROFITEM_DELETE)
Przekierowuje Windows, aby usunąć element menu. Jeśli ta flaga nie zostanie określona, element zostanie utworzony.

0x00000004 (FLG_PROFITEM_GROUP)
Przekierowuje Windows, aby utworzyć lub usunąć grupę menu Start w obszarze Start\Programs. Jeśli ta flaga nie jest określona, Windows tworzy lub usuwa element menu, a nie grupę menu.

Jeśli nie określono flagi, Windows tworzy element menu dla wszystkich użytkowników.

CmdLine=dirid,[subdir],nazwa pliku
Dirid określa wartość, która identyfikuje katalog, w którym znajduje się program poleceń. Na przykład dirid 11 wskazuje katalog systemowy. Możliwe wartości dirid są wymienione w opisie wartości dirid w sekcji DestinationDirs .

Jeśli ciąg subdir jest obecny, program poleceń znajduje się w podkatalogu katalogu, do których odwołuje się dirid. Podkatalog określa podkatalog. Jeśli nie określono żadnego poddiru , program znajduje się w katalogu, do których odwołuje się dirid.

Nazwa pliku określa nazwę programu skojarzonego z elementem menu.

SubDir=path
Ten opcjonalny wpis określa podkatalog (podmenu) w obszarze Start\Programs, w którym znajduje się element menu. Jeśli ten wpis zostanie pominięty, ścieżka zostanie domyślnie ustawiona na Start\Programs.

Jeśli na przykład sekcja profile-items-section zawiera wpis "Subdir=Accessories\Games", element menu jest tworzony lub usuwany w podmenu Start\Programs\Accessories\Games.

WorkingDir=wd-dirid[,wd-subdir]
Ten opcjonalny wpis określa katalog roboczy dla programu poleceń. Jeśli ten wpis zostanie pominięty, katalog roboczy domyślnie zostanie wyświetlony w katalogu, w którym znajduje się program poleceń.

Wartość wd-dirid identyfikuje katalog roboczy. Aby uzyskać listę możliwych wartości dirid, zobacz Using Dirids (Używanie dirids).

Ciąg wd-subdir , jeśli istnieje, określa podkatalog wd-dirid jako katalog roboczy. Użyj tego parametru, aby określić katalog, który nie ma zdefiniowanego przez system dirid. Jeśli ten parametr zostanie pominięty, sama wartość wd-dirid określa katalog roboczy.

IconPath=icon-dirid,[icon-subdir],icon-filename
Ten opcjonalny wpis określa lokalizację pliku zawierającego ikonę elementu menu.

Ciąg ikony-dirid identyfikuje katalog dla biblioteki DLL, która zawiera ikonę. Aby uzyskać listę możliwych wartości dirid, zobacz Using Dirids (Używanie dirids).

Jeśli wartość subdir ikony jest obecna, wskazuje, że biblioteka DLL znajduje się w podkatalogu ikony-dirid. Wartość icon-subdir określa podkatalog.

Wartość icon-filename określa bibliotekę DLL zawierającą ikonę.

Jeśli ten wpis zostanie pominięty, Windows szuka ikony w pliku określonym we wpisie CmdLine.

IconIndex=index-value
Ten opcjonalny wpis określa, która ikona w dll ma być używana dla elementu menu. Aby uzyskać informacje na temat indeksowania ikon w dll, zobacz dokumentację zestawu SDK Microsoft Windows.

Jeśli określono wpis IconPath , indeks indeksuje wartość indeksu do tej biblioteki DLL. W przeciwnym razie ta wartość indeksuje do pliku określonego we wpisie CmdLine .

HotKey=hotkey-value
Ten opcjonalny wpis określa akcelerator klawiatury dla elementu menu.

Aby uzyskać więcej informacji na temat kluczy dostępu, zobacz dokumentację zestawu SDK Windows.

Infotip=info-tip
Ten opcjonalny wpis określa poradę informacyjną dla elementu menu.

Ta wartość może być ciągiem lub tokenem %strkey% zdefiniowanym w sekcji Ciągi pliku INF.

Wartość info-tip można również określić jako "@ResDllPath ResDll,-ResID", gdzie ResDllPath\ i ResDll określają ścieżkę i nazwę pliku zasobu DLL, a -resID jest wartością ujemną reprezentującą identyfikator zasobu.

Ten format umożliwia obsługę wielojęzycznego interfejsu użytkownika (MUI) Windows. Przykład wygląda następująco:

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

DisplayResource="ResDllPath\ResDll",ResID
Ten opcjonalny wpis określa zasób ciągu, który identyfikuje ciąg lokalizowalny, który ma być używany w menu Start jako nazwa wyświetlana skrótu lub grupy.

ResDllPath i ResDll określają ścieżkę i nazwę pliku zasobu DLL, a resID jest wartością dodatnią reprezentującą identyfikator zasobu. Przykład wygląda następująco:

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

Użyj tego wpisu, aby obsługiwać Windows wielojęzyczny interfejs użytkownika (MUI). Jeśli ten wpis nie jest używany, zostanie wyświetlony ciąg określony przez wpis Nazwa .

Remarks

Dana nazwa sekcji elementów profilu musi być unikatowa w pliku INF i musi być zgodna z ogólnymi regułami definiowania nazw sekcji. Aby uzyskać więcej informacji na temat tych reguł, zobacz Ogólne reguły składni dla plików INF.

Każda sekcja elementów profilu zawiera szczegółowe informacje dotyczące tworzenia lub usuwania jednego elementu menu Start lub grupy. Aby manipulować więcej niż jednym elementem menu lub grupą z inF, utwórz więcej niż jedną sekcję elementów profilu i wyświetl sekcje w dyrektywie ProfileItems .

Dowolny z parametrów ciągu określonych w wpisach sekcji profile-items można określić przy użyciu tokenu %strkey%, zgodnie z opisem w ogólnych regułach składni dla plików INF.

Examples

Poniższy fragment pliku INF pokazuje, jak używać sekcji profile-items-do dodawania kalkulatora do 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"

Poniższy fragment pliku INF pokazuje, jak zainstalować to samo oprogramowanie przy użyciu wpisu DisplayResource w celu utworzenia zlokalizowanych elementów menu.

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

Informacje dodatkowe

DDInstall