Partilhar via


System.AppUserModel.RelaunchDisplayNameResource

Especifica o nome para exibição 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. 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 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 indireta, que garante que o nome para exibição seja alterado adequadamente quando o idioma do sistema for alterado por meio da Interface do Usuário Multilíngüe (MUI). O caractere '-' antes que o ID do recurso seja necessário.
  • Uma cadeia de caracteres de texto sem formatação que não aponta para um recurso. Isso só deve ser usado quando o nome para exibição é calculado dinamicamente ou obtido de uma fonte de dados que não oferece suporte a 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 está conectado ao computador.

Observação

System.AppUserModel.RelaunchCommand e System.AppUserModel.RelaunchDisplayNameResource devem ser sempre definidos juntos. Se uma dessas propriedades não estiver definida, nenhuma delas será usada.

 

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 explícito, essa propriedade será ignorada e a janela será agrupada e fixada como se fizesse 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 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.

Observação

Essa propriedade será ignorada se System.AppUserModel.PreventPinning estiver definida. 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 armazenamento de propriedades da janela e use os métodos recuperados objeto IPropertyStore 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.

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