System.AppUserModel.RelaunchCommand

  • Articolo

Specifica un comando che può essere eseguito tramite ShellExecute per avviare un'applicazione quando viene aggiunto alla barra delle applicazioni o quando viene avviata una nuova istanza dell'applicazione tramite jump list dell'applicazione.

Negli esempi vengono illustrati gli aspetti seguenti:

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

virtualhost.exe /virtualapp:12345

notepad.exe

Questa proprietà viene usata solo se una finestra ha un ID modello utente applicazione esplicito (AppUserModelID) (System.AppUserModel.ID, impostato tramite SHGetPropertyStoreForWindow). Se la finestra non ha un AppUserModelID esplicito, questa proprietà viene ignorata e la finestra viene raggruppata e aggiunta come se fosse parte del processo proprietario. Per altre informazioni sull'applicazione di AppUserModelID esplicite e sul relativo effetto sull'aggiunta della barra delle applicazioni, vedere ID modello utente applicazione (AppUserModelIDs) .

Questa proprietà è destinata a essere usata da applicazioni o finestre che vogliono fornire informazioni di riavvio non predefinite.

Nota

System.AppUserModel.RelaunchCommand e System.AppUserModel.RelaunchDisplayNameResource devono essere sempre impostati insieme. Se una di queste proprietà non è impostata, non viene usata alcuna proprietà.

 

Questa proprietà, insieme a System.AppUserModel.RelaunchDisplayNameResource e System.AppUserModel.RelaunchIconResource può essere usata per definire visivamente una finestra come applicazione all'utente. Ciò è utile per gli scenari dell'applicazione host, in cui un'unica istanza host esegue più applicazioni figlio. Ad esempio, una macchina virtuale che ospita diverse applicazioni virtualizzate potrebbe volere che tali applicazioni virtualizzate vengano visualizzate come singole applicazioni all'utente. La macchina virtuale può etichettare ogni finestra con un AppUserModelID esplicito e le proprietà di riavvio appropriate per renderle visualizzate come applicazioni. L'utente potrebbe quindi aggiungerli alla barra delle applicazioni e "riavviare" l'istanza aggiunta.

Nota

Questa proprietà viene ignorata se System.AppUserModel.PreventPinning è impostato. Ciò consente a un'applicazione di controllare il raggruppamento delle finestre assegnandole appUserModelID esplicite, ma impedendo l'aggiunta di tali finestre.

 

Per impostare questa proprietà in una finestra, usare SHGetPropertyStoreForWindow per recuperare l'archivio delle proprietà della finestra e usare i metodi di tale oggetto IPropertyStore recuperati per impostare la proprietà System.AppUserModel.RelaunchCommand di tale finestra.

Windows 10, versione 1703, Windows 10, versione 1607, Windows 10, versione 1511, Windows 10, versione 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

Commenti

I valori PKEY sono definiti in Propkey.h.

ID modello utente applicazione (AppUserModelIDs)

System.AppUserModel.ID

propertyDescriptionList

propertyDescription

searchInfo

labelInfo

Typeinfo

displayInfo

aliasInfo

Stringformat

booleanFormat

numberFormat

Datetimeformat

enumeratedList

Enum

enumRange

image

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty