Personalización del área de encabezado del widget

Las aplicaciones que implementan Windows widgets 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 la carga útil de Adaptive Card que pasas al sistema operativo desde tu proveedor de widgets, por lo que los pasos son los mismos independientemente del lenguaje en el que esté implementado tu 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": [
        ...
    ] 
  } 

Sobrescribir la cadena del 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.

El siguiente ejemplo muestra cómo sobrescribir la cadena del nombre para mostrar.

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

Sobrescribir la cadena del nombre para mostrar y el icono

Para sobrescribir tanto la cadena del nombre para mostrar como el icono especificados en el manifiesto de la aplicación, añade un objeto header con campos para text y iconUrl.

El siguiente ejemplo muestra cómo sobrescribir la cadena del 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 estableciendo el header campo en null. Ten en cuenta que el usuario no puede hacer clic en la experiencia de usuario 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
}