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

En son sürümde, 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.

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": [
        ...
    ] 
  } 

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

Uygulama bildirimindeki DisplayName öğesinde belirtilen değeri, pencere öğesi konağına göndermeden önce JSON yükünde yeni görünen adla 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": [
        ...
    ] ,
    "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": [
        ...
    ] ,
    "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 hissini nullolarak 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": [
        ...
    ] ,
    "header": null
}