System.AppUserModel.RelaunchDisplayNameResource
Especifica o nome de exibição 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. O valor dessa propriedade deve ser um dos seguintes:
- Uma cadeia de caracteres de recurso indireto, como "@%systemdir%\system32\shell32.dll,-19263". Observe que o caractere '@' é necessário para distinguir uma cadeia de caracteres indireta de uma cadeia de caracteres de texto sem formatação (descrita no próximo parágrafo com marcadores). Essa cadeia de caracteres indireta consiste em um arquivo binário e uma ID de recurso da cadeia de caracteres contida nesse binário. É altamente recomendável que você use esse formulário de cadeia de caracteres indireto, que garante que o nome de exibição seja alterado adequadamente quando o idioma do sistema for alterado por meio da MUI (Interface do Usuário Multilíngue). O caractere '-' antes que a ID do recurso seja necessária.
- Uma cadeia de caracteres de texto sem formatação que não aponta para um recurso. Isso só deve ser usado quando o nome de exibição é calculado dinamicamente ou obtido de uma fonte de dados que não dá suporte à MUI. Por exemplo, a cadeia de caracteres pode ser o nome de um dispositivo, como "Microsoft Zune", nos casos em que o aplicativo aparece quando esse dispositivo é anexado ao computador.
Observação
System.AppUserModel.RelaunchCommand e System.AppUserModel.RelaunchDisplayNameResource sempre devem ser definidos juntos. Se uma dessas propriedades não estiver definida, nenhuma delas será usada.
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, essa propriedade será ignorada e a janela será agrupada e fixada como se fosse parte do processo que a possui. 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.
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.RelaunchDisplayNameResource 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, Windows 8, Windows 7
propertyDescription
name = System.AppUserModel.RelaunchDisplayNameResource
shellPKey = PKEY_AppUserModel_RelaunchDisplayNameResource
formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
propID = 4
SearchInfo
InInvertedIndex = false
IsColumn = false
typeInfo
type = String
IsInnate = false
Comentários
Os valores PKEY são definidos em Propkey.h.
Tópicos relacionados