共用方式為

System.AppUserModel.RelaunchIconResource

  • 發行項

指定當使用者選擇將應用程式釘選到工作列，或透過其按鈕的快捷方式跳躍清單啟動新實例時，用於工作列上建立的快捷方式圖示。 這是用於工作列群組的圖示，並針對釘選的應用程式顯示該應用程式是否正在執行。 這應該以下列其中一種格式指定：

  • 標準資源格式，例如 「%systemdir%\system32\shell32.dll，-128」。 需要資源識別碼之前的 '-' 字元。 請勿在路徑字串前面使用 '@' 字元。
  • 圖示檔案的直接路徑，例如 「%programfiles%\Microsoft\Notepad\Notepad.ico，0」。 請注意，因為 .ico 檔案可以包含多個圖示資源，所以字串中需要資源識別碼。 如果 .ico 檔案是單一映射，請使用 「0」 (而不使用 '-' 字元) 作為資源識別碼。

System.AppUserModel.RelaunchIconResource 是選擇性屬性。 如果未設定，則會使用 relaunch 命令的靶心圖表標， (System.AppUserModel.RelaunchCommand) 。 不過，由於這可能會導致不想要的結果，因此強烈建議您透過此屬性明確提供圖示。

只有當視窗具有明確的應用程式使用者模型識別碼 (AppUserModelID) (System.AppUserModel.ID時，才會使用此屬性，並透過 SHGetPropertyStoreForWindow) 設定。 如果視窗沒有明確的 AppUserModelID (System.AppUserModel.ID) ，則會忽略此屬性，而且視窗會分組並釘選，就像是其擁有程式的一部分一樣。 如需明確 AppUserModelID 的應用程式及其對工作列釘選效果的詳細資訊，請參閱 應用程式使用者模型識別碼 (AppUserModelIDs) 。 此屬性旨在供想要提供非預設重新開機資訊的應用程式或視窗使用。 如需詳細資訊，請參閱 System.AppUserModel.RelaunchCommand。

如果在視窗上設定明確的 AppUserModelID，但未設定此屬性，系統會嘗試尋找具有相同 AppUserModelID 的快捷方式，並將該快捷方式釘選到工作列來代表視窗。 如果找不到這類快捷方式，則會使用擁有它之進程的備份可執行檔。

注意

如果已設定 System.AppUserModel.PreventPinning ，則會忽略此屬性。 這可讓應用程式藉由指派明確的 AppUserModelID 來控制其視窗的群組，但防止這些視窗被釘選。

 

若要在視窗上設定此屬性，請使用 SHGetPropertyStoreForWindow 來擷取視窗的屬性存放區，並使用擷取 IPropertyStore 物件的 方法來設定該視窗的 System.AppUserModel.RelaunchIconResource 屬性。

Windows 10版本 1703、Windows 10版本 1607、Windows 10、版本 1511、Windows 10版本 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

應用程式使用者模型識別碼 (AppUserModelIDs)

System.AppUserModel.ID

propertyDescriptionList

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

aliasInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

enum

enumRange

image

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty