Sesuaikan area kepala widget

Dalam rilis terbaru, aplikasi yang mengimplementasikan widget Windows dapat menyesuaikan header yang ditampilkan untuk widget mereka di Papan Widget, mengganti presentasi default. Kustomisasi header diimplementasikan dalam payload Kartu Adaptif yang Anda berikan ke OS dari penyedia widget Anda, sehingga langkah-langkahnya sama terlepas dari bahasa tempat penyedia widget Anda diimplementasikan. Untuk panduan membuat penyedia widget, lihat Menerapkan penyedia widget di Aplikasi C# Windows atau Menerapkan penyedia widget di aplikasi win32 (C++/WinRT).

Header bawaan

Secara default, header widget menunjukkan nama tampilan dan ikon yang ditentukan dalam file manifes aplikasi. Nama tampilan ditentukan dengan atribut DisplayName dari elemen Definisi dan ikon ditentukan dengan elemen Ikon di bawah ThemeResources. Untuk informasi selengkapnya tentang format file manifes aplikasi widget, lihat Format XML manifes paket penyedia widget.

Contoh berikut menunjukkan sebagian payload JSON Kartu Adaptif untuk widget yang memakai presentasi bawaan. Di bagian di bawah ini, contoh akan disediakan yang mengubah templat ini untuk mengambil alih header default.

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

Mengambil alih string nama tampilan

Anda dapat menggantikan nilai yang ditentukan dalam elemen DisplayName dalam manifes aplikasi dengan menambahkan elemen bidang header dengan nama tampilan baru di payload JSON sebelum mengirimkannya ke host widget.

Contoh berikut menunjukkan penggantian string nama tampilan.

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

Mengganti string dan ikon nama tampilan

Untuk mengganti string nama tampilan dan ikon yang ditentukan dalam manifes aplikasi, tambahkan objek header dengan bidang untuk text dan iconUrl.

Contoh berikut menunjukkan cara mengganti nama tampilan dan ikon.

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

Atur header menjadi kosong

Beberapa penyedia widget mungkin ingin mengizinkan UX penuh mereka untuk diperluas ke wilayah header widget, meskipun area widget ini tidak dapat ditindak lanjuti. Untuk skenario ini, Anda dapat mengatur header menjadi kosong dengan mengatur nuansa header ke null. Perhatikan bahwa UX di header tidak dapat diklik oleh pengguna.

Contoh berikut menunjukkan pengaturan header kosong.

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