Uygulamanızın içerisinde kartları işleme

Uyarlamalı Kartları uygulamanızın içinde işlemek kolaydır. Tüm ortak platformlar için SDK'lar sağlar ve kendi Uyarlamalı Kart işleyicinizi oluşturmak için ayrıntılı bir belirtim sağlarız.

1. Hedef platformunuz için bir işleyici SDK'sı yükleyin.
2. Uygulamanızın stili, kuralları ve eylem olay işleyicileriyle yapılandırılmış bir işleyici örneği oluşturun.
3. Yerel kullanıcı arabirimine bir kart oluşturun; otomatik olarak uygulamanıza göre şekillendirilir.

Uyarlamalı Kart SDK'ları

Platforma	Yükleme	İnşa et	Dokümanlar	Statü
JavaScript		Kaynak	Belgeler
.NET WPF		Kaynak	Belgeler	derleme durumuBuild status
.NET HTML		Kaynak	Belgeler	derleme durumuBuild status
Windows UWP		Kaynak	Belgeler
WinUI 3		Kaynak	Belgeler
Android		Kaynak	Belgeler	derleme durumuBuild status
Ios		Kaynak	Belgeler	derleme durumuBuild status

Çizicinin bir örneğini oluşturun

Sonraki adım, bir AdaptiveCardRenderer örneği oluşturmaktır.

Eylem olaylarını bağlama

Varsayılan olarak, eylemler kartta düğme olarak işlenir, ancak beklediğiniz gibi davranmalarını sağlamak uygulamanıza bağlıdır. Her SDK, işlemeniz gereken bir OnAction olayın eşdeğeridir.

• Action.OpenUrl - belirtilen urlöğesini açın.
• Action.Submit - Gönderme işleminin sonucunu alın ve kaynağa gönderin. Kartın kaynağına nasıl gönderdiğiniz tamamen size bağlıdır.
• Action.ShowCard - bir iletişim kutusu çağırır ve alt kartı bu iletişim kutusuna işler. Bunu yalnızca ShowCardActionModepopup olarak ayarlandıysa işlemeniz gerektiğini unutmayın.

Kartı oluştur

Bir kart yükü aldıktan sonra, basitçe renderleyiciyi çağırın ve kartı geçirin. Kart içeriğinden oluşan yerel bir kullanıcı arabirimi nesnesini geri alırsınız. Şimdi bu kullanıcı arabirimini uygulamanızda bir yere yerleştirmeniz yeter.

Özelleştirme

Görüntülenen öğeleri özelleştirmenin çeşitli yolları vardır.

HostConfig

HostConfig, uygulamanızdaki kartların temel stil ve davranışlarını denetleyan paylaşılan, platformlar arası bir yapılandırma nesnesidir. Yazı tipi boyutları, öğeler arasındaki aralıklar, renkler, desteklenen eylemlerin sayısı vb. gibi öğeleri tanımlar.

Yerel platform stillendirmesi

Çoğu KULLANıCı arabirimi çerçevesi, yerel UI çerçevesi stilini kullanarak işlenen karta stil oluşturmanızı sağlar. Örneğin, HTML'de HTML için CSS sınıfları belirtebilir veya XAML'de çıkışın ayrıntılı denetimi için özel bir ResourceDictionary geçirebilirsiniz.

Öğe başına işlemeyi özelleştirme

Her SDK, herhangi bir öğenin işlenmesini geçersiz kılmanıza ve hatta tanımladığınız tamamen yeni öğeler için destek eklemenize olanak tanır. Örneğin, Input.Date renderer'ı kendi özel denetiminizi üretecek şekilde değiştirebilir ve renderer'ın çıkışının geri kalanını koruyabilirsiniz. Ya da tanımladığınız özel Rating bir öğe için destek ekleyebilirsiniz.