System.AppUserModel.RelaunchDisplayNameResource

  • Articolo

Specifica il nome visualizzato utilizzato per il collegamento creato sulla barra delle applicazioni quando l'utente sceglie di aggiungere un'applicazione alla barra delle applicazioni o avviare una nuova istanza tramite la jump list del pulsante. Il valore di questa proprietà deve essere uno dei seguenti:

  • Stringa di risorsa indiretta, ad esempio "@%systemdir%\system32\shell32.dll,-19263". Si noti che il carattere '@' è necessario per distinguere una stringa indiretta da una stringa di testo normale (descritta nel paragrafo puntato successivo). Questa stringa indiretta è costituita da un file binario e da un ID risorsa della stringa contenuta in tale file binario. È consigliabile usare questo formato stringa indiretto, che garantisce che il nome visualizzato venga modificato in modo appropriato quando la lingua di sistema viene modificata tramite Multilingual User Interface (MUI). Carattere '-' prima che sia necessario l'ID risorsa.
  • Stringa di testo normale che non punta a una risorsa. Questa operazione deve essere utilizzata solo quando il nome visualizzato viene calcolato in modo dinamico o ottenuto da un'origine dati che non supporta MUI. Ad esempio, la stringa potrebbe essere il nome di un dispositivo, ad esempio "Microsoft Zune", nei casi in cui l'applicazione viene visualizzata quando il dispositivo è collegato al computer.

Nota

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

 

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 dispone di 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 espliciti e sul relativo effetto sull'aggiunta della barra delle applicazioni, vedere ID modello utente applicazione (AppUserModelIDs). Questa proprietà deve essere utilizzata da applicazioni o finestre che desiderano fornire informazioni di riavvio non predefinite. Per altre informazioni, vedere System.AppUserModel.RelaunchCommand.

Nota

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

 

Per impostare questa proprietà in una finestra, utilizzare SHGetPropertyStoreForWindow per recuperare l'archivio delle proprietà della finestra e utilizzare i metodi dell'oggetto IPropertyStore recuperato per impostare la proprietà System.AppUserModel.RelaunchDisplayNameResource 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.RelaunchDisplayNameResource
   shellPKey = PKEY_AppUserModel_RelaunchDisplayNameResource
   formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
   propID = 4
   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