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 Saltos 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.
- Caminho direto para um arquivo de ícone, como "%programfiles%\Microsoft\Notepad\Notepad.ico,0". Observe que, como os arquivos .ico 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 relaunch (System.AppUserModel.RelaunchCommand) será usado. No entanto, como isso pode levar a resultados indesejados, recomendamos que você forneça um ícone explicitamente por meio dessa propriedade.
Essa propriedade será usada somente se uma janela tiver uma ID explícita do Modelo de Usuário do Aplicativo (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 do 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 estiver 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 suporte do processo que o possui será usado.
Observação
Essa propriedade será ignorada se System.AppUserModel.PreventPinning estiver definido. 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 objeto IPropertyStore recuperado para definir a propriedade System.AppUserModel.RelaunchIconResource 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