Direktif INF ProfileItems
Perhatian
Mulai Windows 11 versi 22H2, paket driver yang menggunakan arahan ini tidak lagi memenuhi syarat untuk tanda tangan dari Pusat Pengembang Perangkat Keras.
Paket pengandar universal dan Driver Windows tidak dapat menggunakan direktif ini.
Direktif ProfileItems digunakan di bagian INF DDInstall untuk mencantumkan satu atau beberapa bagian item profil yang berisi item atau grup yang akan ditambahkan, atau dihapus dari, menu Mulai.
[DDInstall]
ProfileItems=profile-items-section[,profile-items-section]...
...
Setiap bagian bernama yang direferensikan oleh direktif ProfileItems memiliki formulir berikut:
[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]
Arahan ini didukung di Windows XP dan versi Windows yang lebih baru.
Entri
Name=link-name[,name-attributes]
Nama tautan menentukan nama tautan untuk item menu atau grup, tanpa ekstensi .lnk. Nilai ini bisa berupa string atau token %strkey% yang ditentukan di bagian String dari file INF. Jika entri DisplayResource tidak ditentukan, nama tautan juga merupakan string tampilan.
Nilai atribut nama opsional menentukan satu atau beberapa bendera yang memengaruhi operasi pada item menu. Nilai ini dinyatakan sebagai bitmask ORed dari nilai bendera yang ditentukan sistem. Bendera yang mungkin mencakup yang berikut ini:
0x00000001 (FLG_PROFITEM_CURRENTUSER)
Mengarahkan Windows untuk membuat atau menghapus item menu Mulai di profil pengguna saat ini. Jika bendera ini tidak ditentukan, Windows memproses item untuk semua pengguna.
0x00000002 (FLG_PROFITEM_DELETE)
Mengarahkan Windows untuk menghapus item menu. Jika bendera ini tidak ditentukan, item akan dibuat.
0x00000004 (FLG_PROFITEM_GROUP)
Mengarahkan Windows untuk membuat atau menghapus grup menu Mulai di bawah Mulai\Program. Jika bendera ini tidak ditentukan, Windows membuat atau menghapus item menu, bukan grup menu.
Jika tidak ada bendera yang ditentukan, Windows membuat item menu untuk semua pengguna.
CmdLine=dirid,[subdir],nama file
Dirid menentukan nilai yang mengidentifikasi direktori tempat program perintah berada. Misalnya, 11 diri menunjukkan direktori sistem. Nilai dirid yang mungkin tercantum dalam deskripsi nilai dirid di bagian DestinationDirs.
Jika string subdir ada, program perintah berada dalam subdirektori direktori yang direferensikan oleh dirid. Subdir menentukan subdirektori. Jika tidak ada subdir yang ditentukan, program berada dalam direktori yang direferensikan oleh dirid.
Nama file menentukan nama program yang terkait dengan item menu.
SubDir=jalur
Entri opsional ini menentukan subdirektori (submenu) di bawah Start\Programs tempat item menu berada. Jika entri ini dihilangkan, jalur default ke Start\Programs.
Misalnya, jika bagian profile-items memiliki entri "Subdir=Accessories\Games", maka item menu sedang dibuat atau dihapus di submenu Start\Programs\Accessories\Games.
Catatan
Jika FLG_PROFITEM_GROUP ditentukan untuk atribut-nama, entri SubDir diabaikan.
WorkingDir=wd-dirid[,wd-subdir]
Entri opsional ini menentukan direktori kerja untuk program perintah. Jika entri ini dihilangkan, direktori kerja default ke direktori tempat program perintah berada.
Nilai wd-dirid mengidentifikasi direktori kerja. Untuk daftar nilai yang memungkinkan, lihat Menggunakan Dirids.
String wd-subdir , jika ada, menentukan subdirektori wd-dirid untuk menjadi direktori kerja. Gunakan parameter ini untuk menentukan direktori yang tidak memiliki dirid yang ditentukan sistem. Jika parameter ini dihilangkan, nilai wd-dirid saja menentukan direktori kerja.
IconPath=icon-dirid,[icon-subdir],icon-filename
Entri opsional ini menentukan lokasi file yang berisi ikon untuk item menu.
String yang di-dirid ikon mengidentifikasi direktori untuk DLL yang berisi ikon . Untuk daftar nilai yang memungkinkan, lihat Menggunakan Dirids.
Nilai subdir ikon, jika ada, menunjukkan bahwa DLL berada dalam subdirektori dari icon-dirid. Nilai subdir ikon menentukan subdirektori.
Nilai icon-filename menentukan DLL yang berisi ikon .
Jika entri ini dihilangkan, Windows mencari ikon dalam file yang ditentukan dalam entri CmdLine .
IconIndex=index-value
Entri opsional ini menentukan ikon mana dalam DLL yang akan digunakan untuk item menu. Untuk informasi tentang cara mengindeks ikon di DLL, lihat dokumentasi Microsoft Windows SDK.
Jika entri IconPath ditentukan, indeks nilai indeks ke dll tersebut. Jika tidak, nilai ini mengindeks ke dalam file yang ditentukan dalam entri CmdLine .
HotKey=hotkey-value
Entri opsional ini menentukan akselerator keyboard untuk item menu.
Untuk informasi selengkapnya tentang hot key, lihat dokumentasi Windows SDK.
Infotip=info-tip
Entri opsional ini menentukan tip informasi untuk item menu.
Nilai ini bisa berupa string atau token %strkey% yang ditentukan di bagian String dari file INF.
Nilai info-tip juga dapat ditentukan sebagai "@ResDllPath\ResDll,-ResID", di mana ResDllPath dan ResDll menentukan jalur dan nama file DLL sumber daya, dan -resID adalah nilai negatif yang mewakili ID sumber daya.
Gunakan format ini untuk mendukung Windows Antarmuka Pengguna Multibahasa (MUI). Contohnya adalah sebagai berikut:
InfoTip = "@%11%\shell32.dll,-22531"
DisplayResource="ResDllPath\ResDll",ResID
Entri opsional ini menentukan sumber daya string yang mengidentifikasi string yang dapat dilokalkan, yang akan digunakan dalam menu Mulai sebagai nama tampilan untuk pintasan atau grup.
ResDllPath dan ResDll menentukan jalur dan nama file DLL sumber daya, dan resID adalah nilai positif yang mewakili ID sumber daya. Contohnya adalah sebagai berikut:
DisplayResource="%11%\shell32.dll",22019
Gunakan entri ini untuk mendukung Windows Antarmuka Pengguna Multibahasa (MUI). Jika entri ini tidak digunakan, string yang ditentukan oleh entri Nama ditampilkan.
Keterangan
Nama bagian item profil tertentu harus unik dalam file INF dan harus mengikuti aturan umum untuk menentukan nama bagian. Untuk informasi selengkapnya tentang aturan ini, lihat Aturan Sintaks Umum untuk File INF.
Setiap bagian item profil berisi informasi terperinci untuk membuat atau menghapus satu item atau grup menu Mulai. Untuk memanipulasi lebih dari satu item menu atau grup dari INF, buat lebih dari satu bagian item profil dan cantumkan bagian di direktif ProfileItems .
Salah satu parameter string yang ditentukan dalam entri bagian item profil dapat ditentukan dengan menggunakan token %strkey%, seperti yang dijelaskan dalam Aturan Sintaks Umum untuk File INF.
Contoh
Kutipan file INF berikut menunjukkan cara menggunakan bagian item profil untuk menambahkan Kalkulator ke Menu Mulai.
[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"
Kutipan file INF berikut menunjukkan cara menginstal perangkat lunak yang sama dengan menggunakan entri DisplayResource untuk membuat item menu yang dilokalkan.
[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"