System.AppUserModel.RelaunchIconResource

  • Artículo

Especifica el icono usado para el acceso directo creado en la barra de tareas cuando el usuario elige anclar una aplicación a la barra de tareas o iniciar una nueva instancia a través de la lista de accesos directos de su botón. Este es el icono que se usa para el grupo de la barra de tareas y se muestra para una aplicación anclada si esa aplicación se está ejecutando o no. Debe especificarse en uno de los siguientes formatos:

  • Formato de recurso estándar, como "%systemdir%\system32\shell32.dll,-128". Carácter "-" antes de que se requiera el identificador de recurso. No use el carácter '@' en la parte delantera de la cadena de ruta de acceso.
  • Ruta de acceso directa a un archivo de icono, como "%programfiles%\Microsoft\Notepad\Notepad.ico,0". Tenga en cuenta que, dado que los archivos .ico pueden contener varios recursos de icono, se requiere un identificador de recurso en la cadena. Si el archivo .ico es una sola imagen, use "0" (sin el carácter "-") como identificador de recurso.

System.AppUserModel.RelaunchIconResource es una propiedad opcional. Si no se establece, se usa el icono del destino del comando relaunch (System.AppUserModel.RelaunchCommand). Sin embargo, dado que esto puede dar lugar a resultados no deseados, le recomendamos encarecidamente que proporcione un icono explícitamente a través de esta propiedad.

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 (System.AppUserModel.ID), esta propiedad se omite y la ventana se agrupa y ancla como si formase parte de su propio proceso. 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. Para obtener más información, vea System.AppUserModel.RelaunchCommand.

Si se establece un AppUserModelID explícito en la ventana, pero esta propiedad no está establecida, el sistema intenta buscar un acceso directo con el mismo AppUserModelID y ancla ese acceso directo a la barra de tareas para representar la ventana. Si no se puede encontrar este acceso directo, se usa el ejecutable de respaldo del proceso al que pertenece.

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

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

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