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 и их влиянии на закрепление на панели задач см. в разделе Идентификаторы пользовательских моделей приложений (AppUserModelIDs). Это свойство предназначено для использования приложениями или окнами, которые хотят предоставить сведения о повторном запуске, отличные от стандартного. Дополнительные сведения см. в разделе System.AppUserModel.RelaunchCommand.

Если в окне задан явный AppUserModelID, но это свойство не задано, система пытается найти ярлык с тем же AppUserModelID и закрепляет этот ярлык на панели задач, чтобы представить окно. Если такой ярлык не найден, используется резервный исполняемый файл процесса, которому он принадлежит.

Примечание

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

 

Чтобы задать это свойство в окне, используйте 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

Идентификаторы моделей пользователей приложений (AppUserModelID)

System.AppUserModel.ID

propertyDescriptionList

PropertyDescription

searchInfo

labelInfo

Typeinfo

displayInfo

aliasInfo

Stringformat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

enum

enumRange

image

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty