Поделиться через


System.AppUserModel.RelaunchIconResource

Указывает значок, используемый для ярлыка, созданного на панели задач, когда пользователь выбирает закрепление приложения на панели задач или запуск нового экземпляра с помощью списка переходов кнопки. Это значок, используемый для группы панели задач, и отображается для закрепленного приложения независимо от того, запущено ли это приложение. Это должно быть указано в одном из следующих форматов:

  • Стандартный формат ресурсов, например "%systemdir%\system32\shell32.dll,-128". Символ "-" перед обязательным идентификатором ресурса. Не используйте символ "@" в передней части строки пути.
  • Прямой путь к файлу значка, например "%programfiles%\Microsoft\Notepad\Notepad.ico,0". Обратите внимание, что, поскольку .ico файлы могут содержать несколько ресурсов значков, в строке требуется идентификатор ресурса. Если файл .ico является одним изображением, используйте "0" (без символа -) в качестве идентификатора ресурса.

System.AppUserModel.RelaunchIconResource является необязательным свойством. Если он не задан, используется значок целевой цели команды повторного запуска (System.AppUserModel.RelaunchCommand). Тем не менее, поскольку это может привести к нежелательным результатам, мы настоятельно рекомендуем предоставить значок явным образом через это свойство.

Это свойство используется только в том случае, если в окне есть явный идентификатор пользовательской модели приложения (AppUserModelID) (System.AppUserModel.ID, задайте SHGetPropertyStoreForWindow). Если в окне нет явного идентификатора AppUserModelID (System.AppUserModel.ID), это свойство игнорируется, а окно сгруппировано и закреплено, как если бы оно было частью своего процесса владения. Дополнительные сведения о применении явных идентификаторов AppUserModelID и их влиянии на закрепление панели задач см. в идентификаторов пользовательской модели приложений (AppUserModelID). Это свойство предназначено для использования приложениями или окнами, которые хотят предоставить сведения о повторном перезапуске по умолчанию. Дополнительные сведения см. в 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

перечисление List

перечисление

перечисление EnumRange

изображения

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

связанныйProperty