Share via

System.AppUserModel.RelaunchIconResource

  • Artikel

Menentukan ikon yang digunakan untuk pintasan yang dibuat pada taskbar ketika pengguna memilih untuk menyematkan aplikasi ke taskbar atau meluncurkan instans baru melalui Jump List tombolnya. Ini adalah ikon yang digunakan untuk grup taskbar dan ditampilkan untuk aplikasi yang disematkan apakah aplikasi tersebut berjalan atau tidak. Ini harus ditentukan dalam salah satu format berikut:

  • Format sumber daya standar, seperti "%systemdir%\system32\shell32.dll,-128". Karakter '-' sebelum ID sumber daya diperlukan. Jangan gunakan karakter '@' di bagian depan string jalur.
  • Jalur langsung ke file ikon, seperti "%programfiles%\Microsoft\Notepad\Notepad.ico,0". Perhatikan bahwa karena file .ico dapat berisi beberapa sumber daya ikon, ID sumber daya diperlukan dalam string. Jika file .ico adalah gambar tunggal, gunakan "0" (tanpa karakter '-') sebagai ID sumber daya.

System.AppUserModel.RelaunchIconResource adalah properti opsional. Jika tidak diatur, ikon target perintah peluncuran ulang (System.AppUserModel.RelaunchCommand) digunakan. Namun, karena itu dapat menyebabkan hasil yang tidak diinginkan, kami sangat mendorong Anda untuk memberikan ikon secara eksplisit melalui properti ini.

Properti ini hanya digunakan jika jendela memiliki ID Model Pengguna Aplikasi eksplisit (AppUserModelID) (System.AppUserModel.ID, diatur melalui SHGetPropertyStoreForWindow). Jika jendela tidak memiliki AppUserModelID (System.AppUserModel.ID) eksplisit, properti ini diabaikan dan jendela dikelompokkan dan disematkan seolah-olah itu adalah bagian dari proses pemilikannya. Untuk informasi selengkapnya tentang penerapan AppUserModelIDs eksplisit dan efeknya pada penyematan taskbar, lihat ID Model Pengguna Aplikasi (AppUserModelIDs). Properti ini dimaksudkan untuk digunakan oleh aplikasi atau jendela yang ingin memberikan informasi pelafalan ulang non-default. Untuk informasi selengkapnya, lihat System.AppUserModel.RelaunchCommand.

Jika AppUserModelID eksplisit diatur pada jendela, tetapi properti ini tidak diatur, sistem mencoba menemukan pintasan dengan AppUserModelID yang sama, dan menyematkan pintasan tersebut ke taskbar untuk mewakili jendela. Jika tidak ada pintasan seperti itu yang dapat ditemukan, maka executable backing dari proses yang memilikinya digunakan.

Catatan

Properti ini diabaikan jika System.AppUserModel.PreventPinning diatur. Ini memungkinkan aplikasi untuk mengontrol pengelompokan jendelanya dengan menetapkan appUserModelIDs eksplisit tetapi mencegah jendela tersebut disematkan.

 

Untuk mengatur properti ini pada jendela, gunakan SHGetPropertyStoreForWindow untuk mengambil penyimpanan properti jendela, dan gunakan metode objek IPropertyStore yang diambil untuk mengatur properti System.AppUserModel.RelaunchIconResource dari jendela tersebut.

Windows 10, versi 1703, Windows 10, versi 1607, Windows 10, versi 1511, Windows 10, versi 1507, Windows 8.1

propertyDescription
   name = System.AppUserModel.RelaunchIconResource
   shellPKey = PKEY_AppUserModel_RelaunchIconResource
   formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
   propID = 3
   SearchInfo
      InInvertedIndex = false
      IsColumn = true
   typeInfo
      type = String
      IsInnate = false

Windows 8, Windows 7

propertyDescription
   name = System.AppUserModel.RelaunchIconResource
   shellPKey = PKEY_AppUserModel_RelaunchIconResource
   formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
   propID = 3
   SearchInfo
      InInvertedIndex = false
      IsColumn = false
   typeInfo
      type = String
      IsInnate = false

ID Model Pengguna Aplikasi (AppUserModelIDs)

System.AppUserModel.ID

propertyDescriptionList

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

aliasInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

enum

enumRange

gambar

drawControl

editKontrol

filterControl

queryControl

relatedPropertyInfo

relatedProperty