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
Связанные темы