Compartilhar via


System.AppUserModel.RelaunchCommand

Especifica um comando que pode ser executado por meio de 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

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.

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, 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, em que uma única instância de host executa vários aplicativos filho. Por exemplo, uma máquina virtual que hospeda vários aplicativos virtualizados pode querer 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 relançamento apropriadas para fazê-las aparecer como aplicativos. Em seguida, o usuário pode fixá-lo na barra de tarefas e "relançar" a instância fixada.

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 desse objeto IPropertyStore recuperado 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 do modelo de usuário do aplicativo (AppUserModelIDs)

System.AppUserModel.ID

propertyDescriptionList

Propertydescription

searchInfo

labelInfo

Typeinfo

displayInfo

Aliasinfo

Stringformat

booleanFormat

Numberformat

dateTimeFormat

enumeratedList

enumeração

enumRange

imagem

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty