Sesuaikan area kepala widget

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

Kustomisasi header bergantung pada dukungan host. Properti template $host.isHeaderSupported menunjukkan apakah host mendukungnya; lihat properti host widget Windows. Bidang header ini adalah ekstensi widget Windows pada payload kartu. Validasikan presentasinya di Widgets Board, tidak hanya di Desainer Kartu Adaptif tujuan umum.

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": [
        { "type": "TextBlock", "text": "Weather for Redmond" }
    ] 
  } 

Mengambil alih string nama tampilan

Anda dapat mengambil alih nilai yang ditentukan oleh atribut DisplayName di manifes aplikasi dengan menambahkan field header dengan nama tampilan baru ke 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": [
        { "type": "TextBlock", "text": "Weather for Redmond" }
    ] ,
    "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": [
        { "type": "TextBlock", "text": "Weather for Redmond" }
    ] ,
    "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 header bidang 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": [
        { "type": "TextBlock", "text": "Weather for Redmond" }
    ] ,
    "header": null
}