Compartir a través de

System.AppUserModel.RelaunchCommand

Especifica un comando que se puede ejecutar a través de ShellExecute para iniciar una aplicación cuando se ancla a la barra de tareas o cuando se inicia una nueva instancia de la aplicación a través de la lista de accesos directos de la aplicación.

Entre los ejemplos se incluyen los siguientes:

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

virtualhost.exe /virtualapp:12345

notepad.exe

Esta propiedad solo se usa si una ventana tiene un identificador explícito del modelo de usuario de aplicación (AppUserModelID) (System.AppUserModel.ID, establecido a través de SHGetPropertyStoreForWindow). Si la ventana no tiene un AppUserModelID explícito, esta propiedad se omite y la ventana se agrupa y ancla como si formase parte del proceso que lo posee. Para obtener más información sobre la aplicación de appUserModelID explícitos y su efecto en el anclaje de la barra de tareas, consulte identificadores de modelo de usuario de aplicación (AppUserModelIDs).

Esta propiedad está pensada para ser utilizada por aplicaciones o ventanas que quieran proporcionar información de relanzamiento no predeterminada.

Nota

System.AppUserModel.RelaunchCommand y System.AppUserModel.RelaunchDisplayNameRe source siempre deben establecerse juntos. Si no se establece una de esas propiedades, no se usa ninguna.

 

Esta propiedad, junto con System.AppUserModel.RelaunchDisplayNameResource y System.AppUserModel.RelaunchIconResource se pueden usar para definir visualmente una ventana como una aplicación para el usuario. Esto es útil para escenarios de aplicaciones host, donde una única instancia de host ejecuta varias aplicaciones secundarias. Por ejemplo, una máquina virtual que hospeda varias aplicaciones virtualizadas podría querer que esas aplicaciones virtualizadas aparezcan como aplicaciones individuales para el usuario. La máquina virtual podría etiquetar cada ventana con un AppUserModelID explícito y las propiedades de relanzamiento adecuadas para que aparezcan como aplicaciones. Después, el usuario podría anclarlos a la barra de tareas y "volver a iniciar" la instancia anclada.

Nota

Esta propiedad se omite si se establece System.AppUserModel.PreventPinning. Esto permite que una aplicación controle la agrupación de sus ventanas asignando sus appUserModelID explícitos, pero evitando que esas ventanas se anclen.

 

Para establecer esta propiedad en una ventana, use SHGetPropertyStoreForWindow para recuperar el almacén de propiedades de la ventana y use los métodos de ese objeto IPropertyStore para establecer la propiedad System.AppUserModel.RelaunchCommand de esa ventana.

Windows 10, versión 1703, Windows 10, versión 1607, Windows 10, versión 1511, Windows 10, versión 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

Observaciones

Los valores PKEY se definen en Propkey.h.

identificadores de modelo de usuario de aplicación (AppUserModelIDs)

System.AppUserModel.ID

propertyDescriptionList

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

aliasInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

de enumeración de

enumeraciónRange

de imagen

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty

 

 

  • Last updated on