Exemplo de propriedade da janela ID do modelo de usuário do aplicativo (AppID)

Demonstra como controlar o comportamento de agrupamento da barra de tarefas das janelas de um aplicativo através da propriedade System.AppUserModel.ID.

Este tópico contém as seguintes seções.

• Descrição
• Requisitos
• Transferência do exemplo
• Construindo a amostra
• Executando o exemplo
• Tópicos relacionados

Descrição

Este exemplo mostra como definir a propriedade System.AppUserModel.ID por meio do uso da implementação do IPropertyStoreda janela, que é obtida por meio de SHGetPropertyStoreForWindow.

Requerimentos

Download do exemplo

Construindo a amostra

Para criar o exemplo a partir do prompt de comando:

1. Abra a janela da linha de comandos e navegue até o diretório do projeto AppUserModelIDWindowProperty.
2. Digite msbuild AppUserModelIDWindowProperty.sln.

Para criar o exemplo usando o Microsoft Visual Studio (preferencial):

1. Abra o Explorador do Windows e navegue até o diretório do projeto AppUserModelIDWindowProperty.
2. Clique duas vezes no ícone do arquivo AppUserModelIDWindowProperty.sln para abrir o projeto no Visual Studio.
3. No menu Construir, selecione Construir Solução.

Executando o exemplo

1. Navegue até o diretório que contém o novo executável, usando o prompt de comando ou o Windows Explorer.
2. Na linha de comando, digite AppUserModelIDWindowProperty.exe. Como alternativa, no Windows Explorer, clique duas vezes no ícone do AppUserModelIDWindowProperty.exe.
3. Para demonstrar o efeito que as IDs de Modelo de Usuário de Aplicativo (AppUserModelIDs) têm no agrupamento da barra de tarefas, execute pelo menos três instâncias do aplicativo ao mesmo tempo.
4. Use o menu para definir um AppUserModelID diferente em cada uma das três janelas. Observe que cada AppUserModelID separado resulta em um botão separado da barra de tarefas e que as janelas podem alterar sua identidade em tempo de execução.
5. Defina pelo menos duas janelas para o segundo AppUserModelID. Observe que ambos se movem para o mesmo grupo da barra de tarefas.
6. Abra a janela Propriedades da Barra de Tarefas e do Menu Iniciar ao clicar com o botão direito na barra de tarefas e selecionar Propriedades no menu de contexto. Alterar os botões Barra de tarefas: lista suspensa entre os Combinar quando a barra de tarefas estiver cheia e Nunca combinar valores. Observe que cada janela pode obter um botão separado, mas que os botões são agrupados por AppUserModelID.

Tópicos relacionados

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