Personalización del área de encabezado del widget

En la versión más reciente, las aplicaciones que implementan widgets de Windows pueden personalizar el encabezado que se muestra para su widget en el Panel de widgets, reemplazando la presentación predeterminada. La personalización del encabezado se implementa en el payload de tarjeta adaptable que se pasa al sistema operativo desde el proveedor de widgets. Por lo tanto, los pasos son los mismos, independientemente del idioma en el que se implemente el proveedor de widgets. Para ver un tutorial sobre cómo crear un proveedor de widgets, vea Implementar un proveedor de widgets en una aplicación de Windows de C# o Implementar un proveedor de widgets en una aplicación win32 (C++/WinRT).

Encabezado predeterminado

De forma predeterminada, el encabezado del widget muestra el nombre para mostrar y el icono especificado en el archivo de manifiesto de la aplicación. El nombre para mostrar se especifica con el atributo DisplayName del elemento Definition y el icono se especifica con un elemento Icon en ThemeResources. Para obtener más información sobre el formato del archivo de manifiesto de la aplicación widget, consulte el Formato XML del manifiesto del paquete del proveedor de widgets.

En el ejemplo siguiente se muestra una parte de la carga JSON de tarjeta adaptable para un widget que usa la presentación predeterminada. En las secciones siguientes, se proporcionarán ejemplos que modifiquen esta plantilla para invalidar el encabezado predeterminado.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] 
  } 

Invalidación de la cadena de nombre para mostrar

Puede invalidar el valor especificado en el elemento DisplayName en el manifiesto de la aplicación agregando un campo header con el nuevo nombre mostrado en la carga JSON antes de enviarlo al host del widget.

En el ejemplo siguiente se muestra cómo sobrescribir el nombre mostrado.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] ,
    "header": "Redmond Weather"
  } 

Invalidación de la cadena y el icono de nombre para mostrar

Para invalidar la cadena de nombre para mostrar y el icono especificado en el manifiesto de la aplicación, agregue un header objeto con campos para text y iconUrl.

En el ejemplo siguiente se muestra cómo sobrescribir la cadena de nombre para mostrar y el icono.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] ,
    "header": { 
         "text": "Redmond weather", 
         "iconUrl": "https://contoso.com/weatherimage.png" 
      } 
  } 

Establezca el encabezado para que esté vacío.

Es posible que algunos proveedores de widgets quieran permitir que su experiencia de usuario completa se expanda en la región de encabezado del widget, aunque esta área del widget no sea accionable. Para este escenario, puede establecer que el encabezado esté vacío configurando el valor de header en null. Tenga en cuenta que el usuario no puede hacer clic en el UX del encabezado.

En el ejemplo siguiente se muestra cómo establecer un encabezado vacío.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] ,
    "header": null
}