Pencere öğesi başlık alanını özelleştirin

Windows pencere öğeleri uygulayan uygulamalar, Pencere Öğeleri Panosu'nda pencere öğeleri için görüntülenen üst bilgiyi özelleştirerek varsayılan sunuyu geçersiz kılabilir. Üst bilgi özelleştirmesi, pencere öğesi sağlayıcınızdan işletim sistemine geçirdiğiniz Uyarlamalı Kart yükünde uygulanır, bu nedenle pencere öğesi sağlayıcınızın uygulandığı dilden bağımsız olarak adımlar aynıdır. Pencere öğesi sağlayıcısı oluşturma kılavuzu için, C# Windows Uygulamasında bir pencere öğesi sağlayıcısı uygulama veya bir Win32 uygulamasında (C++/WinRT) pencere öğesi sağlayıcısı uygulamakılavuzlarına bakın.

Üst bilgi özelleştirmesi ana bilgisayar desteğine bağlıdır. $host.isHeaderSupported Şablon özelliği, konağın şablon özelliğini destekleyip desteklemediğini gösterir; bkz. Windows pencere öğesi konak özellikleri. header alanı, kart yükünün bir Windows pencere öğesi uzantısıdır. Sunusunu yalnızca genel amaçlı Uyarlamalı Kartlar Tasarımcısı'nda değil Widget'lar Panosu'nda da doğrulayın.

Varsayılan üst bilgi

Varsayılan olarak, pencere öğesi üst bilgisi görünen adı ve uygulama bildirim dosyasında belirtilen simgeyi gösterir. Görüntüleme adı, Tanım öğesinin DisplayName özniteliği ile belirtilir ve simge, ThemeResourcesaltında yer alan Icon öğesi ile belirtilir. Pencere öğesi uygulaması bildirim dosyası biçimi hakkında daha fazla bilgi için bkz. Pencere öğesi sağlayıcı paketi bildirim XML biçimi.

Aşağıdaki örnekte, varsayılan sunuyu kullanan bir pencere öğesi için Uyarlamalı Kart JSON yükünün bir bölümü gösterilmektedir. Aşağıdaki bölümlerde, bu şablonu varsayılan üst bilgiyi geçersiz kılacak şekilde değiştiren örnekler sağlanacaktır.

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

Görünen ad dizesini geçersiz kılma

DisplayName özniteliği tarafından uygulama manifestosunda belirtilen değeri, pencere öğesi konağına göndermeden önce JSON yüküne yeni görünen ada sahip bir header alanı ekleyerek geçersiz kılabilirsiniz.

Aşağıdaki örnekte, görüntü ad dizesinin geçersiz kılınması gösterilmektedir.

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

Görünen ad dizesini ve simgesini geçersiz kıl

Hem görünen ad dizesini hem de uygulama bildiriminde belirtilen simgeyi geçersiz kılmak için, header ve textalanlarını içeren bir iconUrl nesnesi ekleyin.

Aşağıdaki örnek, görünen ad dizesi ve simgesinin nasıl geçersiz kılınabileceğini göstermektedir.

{ 
    "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" 
      } 
  } 

Üst bilgiyi boş olacak şekilde ayarla

Bazı pencere öğesi sağlayıcıları, pencere öğesinin bu alanı eyleme dönüştürülemez olsa bile tam UX'lerinin pencere öğesinin üst bilgi bölgesine genişletilmesine izin vermek isteyebilir. Bu senaryoda, header alanını null olarak ayarlayarak üst bilgiyi boş bırakabilirsiniz. Üst kısımdaki UX'in kullanıcı tarafından tıklanamayacağını unutmayın.

Aşağıdaki örnek, boş bir başlık ayarlamayı gösterir.

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