System.AppUserModel.RelaunchIconResource
Especifica o ícone usado para o atalho criado na barra de tarefas quando o usuário opta por fixar um aplicativo na barra de tarefas ou iniciar uma nova instância por meio da Lista de Atalhos do botão. Esse é o ícone usado para o grupo da barra de tarefas e é mostrado para um aplicativo fixado, seja ele em execução ou não. Isso deve ser especificado em um dos seguintes formatos:
- Formato de recurso padrão, como "%systemdir%\system32\shell32.dll,-128". O caractere '-' antes que a ID do recurso seja necessária. Não use o caractere '@' na frente da cadeia de caracteres do caminho.
- Direcione o caminho para um arquivo de ícone, como "%programfiles%\Microsoft\Bloco de notas\Notepad.ico,0". Observe que, como .ico arquivos podem conter vários recursos de ícone, uma ID de recurso é necessária na cadeia de caracteres. Se o arquivo .ico for uma única imagem, use "0" (sem o caractere '-') como a ID do recurso.
System.AppUserModel.RelaunchIconResource é uma propriedade opcional. Se não estiver definido, o ícone do destino do comando de relançamento (System.AppUserModel.RelaunchCommand) será usado. No entanto, como isso pode levar a resultados indesejados, incentivamos você a fornecer um ícone explicitamente por meio dessa propriedade.
Essa propriedade será usada somente se uma janela tiver uma ID de Modelo de Usuário de Aplicativo explícita (AppUserModelID) (System.AppUserModel.ID, definida por meio de SHGetPropertyStoreForWindow). Se a janela não tiver um AppUserModelID explícito (System.AppUserModel.ID), essa propriedade será ignorada e a janela será agrupada e fixada como se fosse parte de seu processo de propriedade. Para obter mais informações sobre a aplicação de AppUserModelIDs explícitos e seu efeito na fixação da barra de tarefas, consulte IDs de modelo de usuário do aplicativo (AppUserModelIDs). Essa propriedade deve ser usada por aplicativos ou janelas que desejam fornecer informações de relançamento não padrão. Para obter mais informações, consulte System.AppUserModel.RelaunchCommand.
Se um AppUserModelID explícito for definido na janela, mas essa propriedade não estiver definida, o sistema tentará encontrar um atalho com o mesmo AppUserModelID e fixa esse atalho na barra de tarefas para representar a janela. Se nenhum atalho desse tipo puder ser localizado, o executável de backup do processo que o possui será usado.
Nota
Essa propriedade será ignorada se System.AppUserModel.PreventPinning estiver definida. Isso permite que um aplicativo controle o agrupamento de suas janelas atribuindo-lhes AppUserModelIDs explícitos, mas impedindo que essas janelas sejam fixadas.
Para definir essa propriedade em uma janela, use SHGetPropertyStoreForWindow para recuperar o repositório de propriedades da janela e use os métodos do objetoIPropertyStorerecuperado para definir a propriedade System.AppUserModel.RelaunchIconRe source dessa janela.
Windows 10, versão 1703, Windows 10, versão 1607, Windows 10, versão 1511, Windows 10, versão 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
Tópicos relacionados