Compartilhar via

System.AppUserModel.ID

  • Artigo

Uma ID explícita do modelo de usuário do aplicativo (AppUserModelID) usada para associar processos, arquivos e janelas a um aplicativo específico. Em alguns casos, é suficiente confiar no AppUserModelID interno atribuído a um processo pelo sistema. No entanto, um aplicativo que possui vários processos ou um aplicativo em execução em um processo de host pode precisar se identificar explicitamente por meio dessa propriedade para que ele possa agrupar suas janelas diferentes em um único botão de barra de tarefas e controlar o conteúdo da Lista de Atalhos desse aplicativo.

Para definir essa propriedade em uma janela, use SHGetPropertyStoreForWindow para recuperar o repositório de propriedades da janela e use os métodos desse objeto IPropertyStore recuperado para definir a propriedade System.AppUserModel.ID dessa janela.

Para obter mais informações, consulte IDs do modelo de usuário do aplicativo (AppUserModelIDs).

No momento em que a propriedade System.AppUserModel.ID é definida, a barra de tarefas é notificada para atualizar suas informações na janela ou atalho, considerando que AppUserModelID.

Outras propriedades de janela e atalho podem ser usadas em conjunto com um AppUserModelID explícito para controlar ainda mais o agrupamento e a fixação associados a uma janela, o nome de exibição e o ícone usados para ele na barra de tarefas e o comando para iniciar um aplicativo fixado na barra de tarefas ou uma nova instância do aplicativo por meio da Lista de Atalhos desse aplicativo. Essas propriedades devem ser definidas antes de definir a propriedade System.AppUserModel.ID . Para obter mais informações, consulte estes tópicos:

Windows 10, versão 1703, Windows 10, versão 1607, Windows 10, versão 1511, Windows 10, versão 1507, Windows 8.1, Windows 8, Windows 7

propertyDescription
   name = System.AppUserModel.ID
   shellPKey = PKEY_AppUserModel_ID
   formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
   propID = 5
   SearchInfo
      InInvertedIndex = false
      IsColumn = false
   typeInfo
      type = String
      IsInnate = false

Comentários

Os valores PKEY são definidos em Propkey.h.

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

SHGetPropertyStoreForWindow

propertyDescriptionList

Propertydescription

searchInfo

labelInfo

Typeinfo

displayInfo

Aliasinfo

Stringformat

booleanFormat

Numberformat

dateTimeFormat

enumeratedList

enumeração

enumRange

imagem

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty