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 jump List de la aplicación.

Entre otros, se incluyen los siguientes ejemplos:

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

virtualhost.exe /virtualapp:12345

notepad.exe

Esta propiedad solo se usa si una ventana tiene un identificador de modelo de usuario de aplicación explícito (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 usarse en aplicaciones o ventanas que quieran proporcionar información de relanzamiento no predeterminada.

Nota

System.AppUserModel.RelaunchCommand y System.AppUserModel.RelaunchDisplayNameResource deben establecerse siempre 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 al 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 a una aplicación controlar la agrupación de sus ventanas asignándoles 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 recuperado 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 (AppUserModelID)

System.AppUserModel.ID

propertyDescriptionList

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

aliasInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

enum

enumRange

image

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty