Condividi tramite

System.AppUserModel.RelaunchIconResource

Specifica l'icona utilizzata 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 jump list del pulsante. Questa è l'icona usata per il gruppo della barra delle applicazioni e viene visualizzata per un'applicazione bloccata, indipendentemente dal fatto che l'applicazione sia in esecuzione o meno. Deve essere specificato in uno dei formati seguenti:

  • Formato di risorsa standard, ad esempio "%systemdir%\system32\shell32.dll,-128". Carattere '-' prima che sia necessario l'ID risorsa. Non utilizzare il carattere '@' nella parte anteriore della stringa di percorso.
  • Percorso diretto di un file icona, ad esempio "%programfiles%\Microsoft\Notepad\Notepad.ico,0". Si noti che poiché .ico file possono contenere più risorse icona, nella stringa è necessario un ID risorsa. Se il file .ico è una singola immagine, usare "0" (senza il carattere "-") come ID risorsa.

System.AppUserModel.RelaunchIconResource è una proprietà facoltativa. Se non è impostata, viene usata l'icona della destinazione del comando di riavvio (System.AppUserModel.RelaunchCommand). Tuttavia, poiché ciò può portare a risultati indesiderati, è consigliabile fornire un'icona in modo esplicito tramite questa 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 (System.AppUserModel.ID), questa proprietà viene ignorata e la finestra viene raggruppata e bloccata come se fosse parte del proprio processo. Per altre informazioni sull'applicazione di AppUserModelIDs espliciti e sul relativo effetto sull'aggiunta della barra delle applicazioni, vedere ID modello utente applicazione (AppUserModelIDs). Questa proprietà è destinata all'uso da parte di applicazioni o finestre che desiderano fornire informazioni di riavvio non predefinite. Per altre informazioni, vedere System.AppUserModel.RelaunchCommand.

Se nella finestra è impostato un AppUserModelID esplicito, ma questa proprietà non è impostata, il sistema tenta di trovare un collegamento con lo stesso AppUserModelID e aggiunge tale collegamento alla barra delle applicazioni per rappresentare la finestra. Se non è possibile trovare tale collegamento, viene usato il file eseguibile di backup del processo proprietario.

Nota

Questa proprietà viene ignorata se è impostata System.AppUserModel.PreventPinning. Ciò consente a un'applicazione di controllare il raggruppamento delle finestre assegnando loro 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 di che hanno recuperato oggetto IPropertyStore per impostare la proprietà System.AppUserModel.RelaunchIconRe source di tale finestra.

Windows 10, versione 1703, Windows 10, versione 1607, Windows 10, versione 1511, Windows 10, versione 1507, Windows 8.1

propertyDescription
   name = System.AppUserModel.RelaunchIconResource
   shellPKey = PKEY_AppUserModel_RelaunchIconResource
   formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
   propID = 3
   SearchInfo
      InInvertedIndex = false
      IsColumn = true
   typeInfo
      type = String
      IsInnate = false

Windows 8, Windows 7

propertyDescription
   name = System.AppUserModel.RelaunchIconResource
   shellPKey = PKEY_AppUserModel_RelaunchIconResource
   formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
   propID = 3
   SearchInfo
      InInvertedIndex = false
      IsColumn = false
   typeInfo
      type = String
      IsInnate = false

ID modello utente applicazione (AppUserModelIDs)

System.AppUserModel.ID

propertyDescriptionList

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

aliasInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratoList

enumerazione

enumRange

'immagine

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty