System.AppUserModel.RelaunchIconResource

Especifica o ícone usado para o atalho criado na barra de tarefas quando o usuário escolhe fixar um aplicativo na barra de tarefas ou iniciar uma nova instância por meio da Lista de Atalhos do botão. Este é o ícone usado para o grupo da barra de tarefas e é mostrado para um aplicativo fixo, quer esse aplicativo esteja em execução ou não. Isto deve ser especificado num dos seguintes formatos:

• Formato de recurso padrão, como "%systemdir%\system32\shell32.dll,-128". O caractere '-' antes que o ID do recurso seja necessário. 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 .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 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 vivamente que forneça um ícone explicitamente através desta propriedade.

Esta propriedade é usada somente se uma janela tiver um ID de modelo de usuário de aplicativo explícito (AppUserModelID) (System.AppUserModel.ID, definido através de SHGetPropertyStoreForWindow). Se a janela não tiver um AppUserModelID (System.AppUserModel.ID) explícito, essa propriedade será ignorada e a janela será agrupada e fixada como se fizesse parte de seu próprio processo. Para obter mais informações sobre a aplicação de AppUserModelIDs explícitos e seu efeito na fixação da barra de tarefas, consulte Application User Model IDs (AppUserModelIDs). Esta propriedade destina-se a ser usada por aplicativos ou janelas que desejam fornecer informações de reinicialização 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 fixará esse atalho na barra de tarefas para representar a janela. Se nenhum atalho puder ser localizado, então o executável de suporte do processo que o possui é usado.

Para definir essa propriedade em uma janela, use SHGetPropertyStoreForWindow para recuperar o repositório de propriedades da janela e use os métodos recuperados objeto IPropertyStore 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

IDs de modelo de usuário de aplicativo (AppUserModelIDs)

System.AppUserModel.ID

propriedadeDescriçãoLista

propriedadeDescrição

searchInfo

labelInfo

typeInfo

displayInfo

aliasInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeradoLista

enum

enumRange

imagem

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relacionadoPropriedade