Açılır Pencereleri Görüntüle

Uyarı görüntüleme, kullanıcıdan seçim yapmasını isteme veya istem görüntüleme yaygın bir kullanıcı arabirimi görevidir. Xamarin.Forms sınıfında, bir açılır pencere aracılığıyla kullanıcıyla etkileşim kurmak için üç yöntemi Page vardır: DisplayAlert, DisplayActionSheetve DisplayPromptAsync. Bunlar her platformda uygun yerel denetimlerle işlenir.

Uyarı görüntüleme

Tüm Xamarin.Formsdesteklenen platformlarda kullanıcıyı uyarmak veya basit sorular sormak için kalıcı bir açılır pencere bulunur. içinde bu uyarıları Xamarin.Formsgörüntülemek için herhangi bir Pageüzerinde yöntemini kullanınDisplayAlert. Aşağıdaki kod satırı kullanıcıya basit bir ileti gösterir:

await DisplayAlert ("Alert", "You have been alerted", "OK");

Bu örnek kullanıcıdan bilgi toplamaz. Uyarı modlu olarak görüntülenir ve kapatıldıktan sonra kullanıcı uygulamayla etkileşime devam eder.

yöntemi, DisplayAlert iki düğme sunarak ve döndürerek booleankullanıcının yanıtını yakalamak için de kullanılabilir. Uyarıdan yanıt almak için hem düğmeler await hem de yöntemi için metin sağlayın. Kullanıcı seçeneklerden birini seçtikten sonra yanıt kodunuz için döndürülür. async Aşağıdaki örnek kodda ve await anahtar sözcüklerini not edin:

async void OnAlertYesNoClicked (object sender, EventArgs e)
{
  bool answer = await DisplayAlert ("Question?", "Would you like to play a game", "Yes", "No");
  Debug.WriteLine ("Answer: " + answer);
}

yöntemi ayrıca DisplayAlert kullanıcı arabirimi öğelerinin uyarı içinde akma yönünü belirten bir FlowDirection bağımsız değişkeni kabul eden aşırı yüklemelere sahiptir. Akış yönü hakkında daha fazla bilgi için bkz . Sağdan sola yerelleştirme.

Uyarı

Varsayılan olarak UWP'de bir uyarı görüntülendiğinde uyarının arkasındaki sayfada tanımlanan erişim anahtarları yine de etkinleştirilebilir. Daha fazla bilgi için bkz . Windows'ta VisualElement Erişim Anahtarları.

Kullanıcılara görevler boyunca kılavuzluk etme

UIActionSheet, iOS'ta yaygın bir kullanıcı arabirimi öğesidir. yöntemi, Xamarin.FormsDisplayActionSheet bu denetimi platformlar arası uygulamalara dahil etmenizi ve Android ve UWP'de yerel alternatifleri işlemenizi sağlar.

Bir eylem sayfasını görüntülemek için, awaitDisplayActionSheet herhangi bir Pageiçinde ileti ve düğme etiketlerini dize olarak geçirin. yöntemi, kullanıcı tarafından tıklanan düğmenin dize etiketini döndürür. Burada basit bir örnek gösterilmiştir:

async void OnActionSheetSimpleClicked (object sender, EventArgs e)
{
  string action = await DisplayActionSheet ("ActionSheet: Send to?", "Cancel", null, "Email", "Twitter", "Facebook");
  Debug.WriteLine ("Action: " + action);
}

Düğme destroy , iOS'ta diğer düğmelere göre farklı işlenir ve üçüncü dize parametresi olarak bırakılabilir null veya belirtilebilir. Aşağıdaki örnekte düğme kullanılır destroy :

async void OnActionSheetCancelDeleteClicked (object sender, EventArgs e)
{
  string action = await DisplayActionSheet ("ActionSheet: SavePhoto?", "Cancel", "Delete", "Photo Roll", "Email");
  Debug.WriteLine ("Action: " + action);
}

Yöntemin DisplayActionSheet ayrıca, kullanıcı arabirimi öğelerinin eylem sayfası içinde akma yönünü belirten bir bağımsız değişken kabul eden bir FlowDirection aşırı yüklemesi de vardır. Akış yönü hakkında daha fazla bilgi için bkz . Sağdan sola yerelleştirme.

İstem görüntüleme

bir istem görüntülemek için herhangi Pagebir içinde öğesini çağırın DisplayPromptAsync ve bağımsız değişken olarak string bir başlık ve ileti geçirin:

string result = await DisplayPromptAsync("Question 1", "What's your name?");

İstem modlu olarak görüntülenir:

Tamam düğmesine dokunulduğunda, girilen yanıt olarak stringdöndürülür. İptal düğmesine dokunulduğunda döndürülür null .

yöntemi için DisplayPromptAsync tam bağımsız değişken listesi:

• title, türünde string, isteminde görüntülenecek başlıktır.
• message, türünde string, isteminde görüntülenecek iletidir.
• accept, türündeki string, kabul et düğmesinin metnidir. Bu, varsayılan değeri Tamam olan isteğe bağlı bir bağımsız değişkendir.
• cancel, türündeki string, iptal düğmesinin metnidir. Bu, varsayılan değeri İptal olan isteğe bağlı bir bağımsız değişkendir.
• placeholder, türünde string, isteminde görüntülenecek yer tutucu metindir. Bu, varsayılan değeri olan isteğe bağlı bir bağımsız değişkendir null.
• maxLength, kullanıcı intyanıtının uzunluk üst sınırıdır. Bu, varsayılan değeri -1 olan isteğe bağlı bir bağımsız değişkendir.
• keyboard, türünde Keyboard, kullanıcı yanıtı için kullanılacak klavye türüdür. Bu, varsayılan değeri olan isteğe bağlı bir bağımsız değişkendir Keyboard.Default.
• initialValue, türünde string, görüntülenecek ve düzenlenebilen önceden tanımlanmış bir yanıttır. Bu, varsayılan değeri boş stringolan isteğe bağlı bir bağımsız değişkendir.

Aşağıdaki örnekte, isteğe bağlı bağımsız değişkenlerden bazılarını ayarlama gösterilmektedir:

string result = await DisplayPromptAsync("Question 2", "What's 5 + 5?", initialValue: "10", maxLength: 2, keyboard: Keyboard.Numeric);

Bu kod önceden tanımlanmış 10 yanıt görüntüler, giriş yapılaabilecek karakter sayısını 2 ile sınırlar ve kullanıcı girişi için sayısal klavyeyi görüntüler:

Uyarı

UWP'de varsayılan olarak, bir istem görüntülendiğinde, istemin arkasındaki sayfada tanımlanan tüm erişim anahtarları yine etkinleştirilebilir. Daha fazla bilgi için bkz . Windows'ta VisualElement Erişim Anahtarları.

İlgili bağlantılar

• Sağdan sola yerelleştirme