System.AppUserModel.RelaunchIconResource

  • Articolo

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 la 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 risorse 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 del percorso.
  • Percorso diretto di un file icona, ad esempio "%programfiles%\Microsoft\Notepad\Notepad.ico,0". Si noti che poiché i file con estensione ico possono contenere più risorse icona, nella stringa è necessario un ID risorsa. Se il file con estensione 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ò causare 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 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.

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 un collegamento di questo tipo, viene usato il file eseguibile di backup del processo proprietario.

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.RelaunchIconResource 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

enumeratedList

Enum

enumRange

image

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty