Share via

System.AppUserModel.RelaunchCommand

  • Artikel

Menentukan perintah yang dapat dijalankan melalui ShellExecute untuk meluncurkan aplikasi saat disematkan ke taskbar atau ketika instans baru aplikasi diluncurkan melalui Jump List aplikasi.

Contohnya termasuk berikut ini:

shell:::{ED228FDF-9EA8-4870-83B1-96B02CFE0D52}

virtualhost.exe /virtualapp:12345

notepad.exe

Properti ini hanya digunakan jika jendela memiliki ID Model Pengguna Aplikasi eksplisit (AppUserModelID) (System.AppUserModel.ID, diatur melalui SHGetPropertyStoreForWindow). Jika jendela tidak memiliki AppUserModelID eksplisit, properti ini diabaikan dan jendela dikelompokkan dan disematkan seolah-olah itu adalah bagian dari proses yang memilikinya. 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 relaunch non-default.

Catatan

System.AppUserModel.RelaunchCommand dan System.AppUserModel.RelaunchDisplayNameResource harus selalu diatur bersama- sama. Jika salah satu properti tersebut tidak diatur, maka tidak ada yang digunakan.

 

Properti ini, bersama dengan System.AppUserModel.RelaunchDisplayNameResource dan System.AppUserModel.RelaunchIconResource dapat digunakan untuk menentukan jendela secara visual sebagai aplikasi kepada pengguna. Ini berguna untuk skenario aplikasi host, di mana satu instans host menjalankan beberapa aplikasi anak. Misalnya, komputer virtual yang menghosting beberapa aplikasi virtual mungkin ingin aplikasi virtual tersebut muncul sebagai aplikasi individual kepada pengguna. Komputer virtual dapat melabeli setiap jendela dengan AppUserModelID eksplisit dan properti peluncuran ulang yang sesuai untuk membuatnya muncul sebagai aplikasi. Pengguna kemudian dapat menyematkannya ke taskbar dan "meluncurkan kembali" instans yang disematkan.

Catatan

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

 

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

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

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

Keterangan

Nilai PKEY ditentukan dalam Propkey.h.

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