System.AppUserModel.RelaunchIconResource

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 usado 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 frontal 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 .ico archivos 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 explícito del modelo de usuario de aplicación (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 ser utilizada por 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 que posee.

Nota

Esta propiedad se omite si se establece System.AppUserModel.PreventPinning. Esto permite que una aplicación controle la agrupación de sus ventanas asignando sus 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 para establecer la propiedad System.AppUserModel.RelaunchIconRe source 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

Temas relacionados

identificadores de modelo de usuario de aplicación (AppUserModelIDs)

System.AppUserModel.ID

propertyDescriptionList

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

aliasInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

de enumeración de

enumeraciónRange

de imagen

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty