Partilhar via

System.AppUserModel.RelaunchCommand

Especifica um comando que pode ser executado por meio ShellExecute para iniciar um aplicativo quando ele é fixado na barra de tarefas ou quando uma nova instância do aplicativo é iniciada por meio da Lista de Atalhos do aplicativo.

Os exemplos incluem o seguinte:

shell:::{ED228FDF-9EA8-4870-83B1-96B02CFE0D52}

virtualhost.exe /virtualapp:12345

notepad.exe

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.

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.

 

Essa propriedade, juntamente com System.AppUserModel.RelaunchDisplayNameResource e System.AppUserModel.RelaunchIconResource pode ser usada para definir visualmente uma janela como um aplicativo para o usuário. Isso é útil para cenários de aplicativo host, onde uma única instância de host executa vários aplicativos filho. Por exemplo, uma máquina virtual que hospeda vários aplicativos virtualizados pode desejar que esses aplicativos virtualizados apareçam como aplicativos individuais para o usuário. A máquina virtual pode rotular cada janela com um AppUserModelID explícito e as propriedades de reinicialização apropriadas para fazê-las aparecer como aplicativos. O usuário poderia então fixá-los na barra de tarefas e "reiniciar" a instância fixada.

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.RelaunchCommand 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.RelaunchCommand
   shellPKey = PKEY_AppUserModel_RelaunchCommand
   formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
   propID = 2
   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

 

 

  • Last updated on