Xamarin.Forms Açılır Pencereler Öğreticisi

Makale
Developer (Başlangıç)
Tamamlanması için 6 dakika kaldı

Bu öğreticiye başlamadan önce şunları başarıyla tamamlamış olmanız gerekir:

İlk Xamarin.Forms uygulama hızlı başlangıcınızı oluşturun.
StackLayout öğreticisi.
Düğme öğreticisi.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

Kullanıcıdan seçim yapmasını istemek için bir uyarı görüntüleme.
Kullanıcıya bir görevde kılavuzluk yapmak için bir eylem sayfası görüntüleme.

Içinde açılır pencerelerin Xamarin.Formsnasıl görüntüleneceğini gösteren basit bir uygulama oluşturmak için Visual Studio 2019 veya Mac için Visual Studio kullanacaksınız. Aşağıdaki ekran görüntüleri, son uygulamayı gösterir:

Uyarı görüntüleme

5 dakika kaldı

Xamarin.Forms kullanıcıyı uyarmak veya basit sorular sormak için uyarı olarak bilinen kalıcı bir açılır pencereye sahiptir. Bu alıştırmada Page sınıfından DisplayAlert yöntemini kullanarak kullanıcıya bir uyarı gösterecek ve basit bir soru soracaksınız.

Visual Studio
Mac için Visual Studio

Bu öğreticiyi tamamlamak için Visual Studio 2019 (son sürüm) ve .NET ile mobil uygulama geliştirme iş yükü sisteminizde yüklü olmalıdır. Ayrıca öğretici uygulamasını iOS üzerinde derleyebilmek için eşleştirilmiş bir Mac de gerekecektir. Xamarin platformunu yükleme hakkında bilgi için bkz. Xamarin'i Yükleme. Visual Studio 2019'u bir Mac derleme ana bilgisayarına bağlama hakkında bilgi için bkz. Xamarin.iOS geliştirme için Mac ile eşleştirme.

Visual Studio'yu başlatın ve PopupsTutorial adlı boş Xamarin.Forms bir uygulama oluşturun.

Önemli

Bu öğreticide kullanılan C# ve XAML kod parçacıklarında çözüm adı PopupsTutorial olarak belirlenmiştir. Farklı bir ad kullanırsanız bu öğreticideki kodları çözüme kopyaladığınızda derleme hatalarıyla karşılaşabilirsiniz.

Oluşturulan .NET Standard kitaplığı hakkında daha fazla bilgi için Bkz. Hızlı Başlangıç Ayrıntılı Bakış'taXamarin.Forms uygulamanın Xamarin.Forms anatomisi.
Çözüm Gezgini'ndeki PopupsTutorial projesinde MainPage.xaml dosyasına çift tıklayıp açın. Ardından MainPage.xaml içindeki şablon kodunun tamamını silip aşağıdaki kodu ekleyin:
```
<?xml version="1.0" encoding="utf-8"?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="PopupsTutorial.MainPage">
    <StackLayout Margin="20,35,20,20">
        <Button Text="Display alert"
                Clicked="OnDisplayAlertButtonClicked" />
        <Button Text="Display alert question"
                Clicked="OnDisplayAlertQuestionButtonClicked" />
    </StackLayout>
</ContentPage>
```
Bu kod, sayfa için kullanıcı arabirimini bildirimli bir şekilde tanımlar ve bu da bir StackLayout içindeki iki Button nesnesinden oluşur. Button.Text özellikleri her bir Button içinde görüntülenen metni belirtir, Clicked olayları da bir sonraki adımda oluşturulacak olay işleyicilerine ayarlanmıştır.
Çözüm Gezgini'ndeki PopupsTutorial projesinde MainPage.xaml bölümünü genişletip MainPage.xaml.cs dosyasına çift tıklayarak açın. Ardından MainPage.xaml.cs içinde sınıfa OnDisplayAlertButtonClicked ve OnDisplayAlertQuestionButtonClicked olay işleyicilerini ekleyin:
```
async void OnDisplayAlertButtonClicked(object sender, EventArgs e)
{
    await DisplayAlert("Alert", "This is an alert.", "OK");
}

async void OnDisplayAlertQuestionButtonClicked(object sender, EventArgs e)
{
    bool response = await DisplayAlert("Save?", "Would you like to save your data?", "Yes", "No");
    Console.WriteLine("Save data: " + response);
}
```
Button öğesine dokunulduğunda ilgili olay işleyicisi yöntemi yürütülür. OnDisplayAlertButtonClicked yöntemi DisplayAlert yöntemini çağırarak tek bir iptal düğmesine sahip bir kalıcı uyarı görüntüler. Kullanıcıyı, uyarıyı kapattıktan sonra uygulamayla etkileşim kurmaya devam edebilir.

OnDisplayAlertQuestionButtonClicked yöntemi DisplayAlert yönteminin aşırı yüklemesini çağırarak kabul ve iptal düğmesine sahip bir kalıcı uyarı görüntüler. Kullanıcı düğmelerden birini seçtikten sonra yapılan seçim boolean olarak döndürülür.

Önemli

DisplayAlert yöntemi zaman uyumsuzdur ve her zaman await anahtar sözcüğüyle birlikte beklenmelidir.
Visual Studio araç çubuğunda Başlat düğmesine (Oynat düğmesine benzeyen üçgen düğme) basarak uygulamayı seçtiğiniz uzak iOS simülatöründe veya Android öykünücüsünde başlatın. Ardından ilk Button öğesine dokunun:

Uyarıyı kapattıktan sonra ikinci Button öğesine dokunun:

Sorunun yanıtını seçtikten sonra yanıtın Visual Studio'daki Çıkış penceresine iletildiğini göreceksiniz. Bu pencere görünmüyorsa, Çıktıyı Görüntüle > menü seçeneği seçilerek görünür hale getirilebilir.

Visual Studio'da uygulamayı durdurun.

Uyarı görüntüleme hakkında daha fazla bilgi için Açılır Pencere Görüntüleme kılavuzunun Uyarı görüntüleme bölümüne bakın.

Bu öğreticiyi tamamlamak için iOS ve Android platformu desteğine sahip Mac için Visual Studio (son sürüm) uygulamasını yüklemiş olmanız gerekir. Ayrıca Xcode (son sürüm) uygulaması da gereklidir. Xamarin platformunu yükleme hakkında daha bilgi için bkz. Xamarin'i Yükleme.

Mac için Visual Studio başlatın ve PopupsTutorial adlı boş Xamarin.Forms bir uygulama oluşturun.

Önemli

Bu öğreticide kullanılan C# ve XAML kod parçacıklarında çözüm adı PopupsTutorial olarak belirlenmiştir. Farklı bir ad kullanırsanız bu öğreticideki kodları çözüme kopyaladığınızda derleme hatalarıyla karşılaşabilirsiniz.

Oluşturulan .NET Standard kitaplığı hakkında daha fazla bilgi için Bkz. Hızlı Başlangıç Ayrıntılı Bakış'taXamarin.Forms uygulamanın Xamarin.Forms anatomisi.
Çözüm Bölmesi'ndeki PopupsTutorial projesinde MainPage.xaml dosyasına çift tıklayıp açın. Ardından MainPage.xaml içindeki şablon kodunun tamamını silip aşağıdaki kodu ekleyin:
```
<?xml version="1.0" encoding="utf-8"?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="PopupsTutorial.MainPage">
    <StackLayout Margin="20,35,20,20">
        <Button Text="Display alert"
                Clicked="OnDisplayAlertButtonClicked" />
        <Button Text="Display alert question"
                Clicked="OnDisplayAlertQuestionButtonClicked" />
    </StackLayout>
</ContentPage>
```
Bu kod, sayfa için kullanıcı arabirimini bildirimli bir şekilde tanımlar ve bu da bir StackLayout içindeki iki Button nesnesinden oluşur. Button.Text özellikleri her bir Button içinde görüntülenen metni belirtir, Clicked olayları da bir sonraki adımda oluşturulacak olay işleyicilerine ayarlanmıştır.
Çözüm Bölmesi'ndeki PopupsTutorial projesinde MainPage.xaml bölümünü genişletip MainPage.xaml.cs dosyasına çift tıklayarak açın. Ardından MainPage.xaml.cs içinde sınıfa OnDisplayAlertButtonClicked ve OnDisplayAlertQuestionButtonClicked olay işleyicilerini ekleyin:
```
async void OnDisplayAlertButtonClicked(object sender, EventArgs e)
{
    await DisplayAlert("Alert", "This is an alert.", "OK");
}

async void OnDisplayAlertQuestionButtonClicked(object sender, EventArgs e)
{
    bool response = await DisplayAlert("Save?", "Would you like to save your data?", "Yes", "No");
    Console.WriteLine("Save data: " + response);
}
```
Button öğesine dokunulduğunda ilgili olay işleyicisi yöntemi yürütülür. OnDisplayAlertButtonClicked yöntemi DisplayAlert yöntemini çağırarak tek bir iptal düğmesine sahip bir kalıcı uyarı görüntüler. Kullanıcıyı, uyarıyı kapattıktan sonra uygulamayla etkileşim kurmaya devam edebilir.

OnDisplayAlertQuestionButtonClicked yöntemi DisplayAlert yönteminin aşırı yüklemesini çağırarak kabul ve iptal düğmesine sahip bir kalıcı uyarı görüntüler. Kullanıcı düğmelerden birini seçtikten sonra yapılan seçim boolean olarak döndürülür.

Önemli

DisplayAlert yöntemi zaman uyumsuzdur ve her zaman await anahtar sözcüğüyle birlikte beklenmelidir.
Mac için Visual Studio araç çubuğunda Başlat düğmesine (Oynat düğmesine benzeyen üçgen düğme) basarak uygulamayı seçtiğiniz iOS simülatöründe veya Android öykünücüsünde başlatın. Ardından ilk Button öğesine dokunun:

Uyarıyı kapattıktan sonra ikinci Button öğesine dokunun:

Sorunun yanıtını seçtikten sonra yanıtın Mac için Visual Studio'daki Uygulama Çıkışı penceresine iletildiğini göreceksiniz. Bu pencere görünmüyorsa, Diğer Windows > Uygulama Çıkışını Görüntüle > menü seçeneği seçilerek görünür hale getirilebilir.

Mac için Visual Studio'da uygulamayı durdurun.

Uyarı görüntüleme hakkında daha fazla bilgi için Açılır Pencere Görüntüleme kılavuzunun Uyarı görüntüleme bölümüne bakın.

Eylem sayfası görüntüleme

2 dakika kaldı

Xamarin.Forms bir görev boyunca kullanıcılara yol göstermek için kullanılabilecek, eylem sayfası olarak bilinen kalıcı bir açılır pencereye sahiptir. Bu alıştırmada Page sınıfındaki DisplayActionSheet yöntemini kullanarak kullanıcılara bir görevde kılavuzluk edecek bir eylem sayfası görüntüleyeceksiniz.

Visual Studio
Mac için Visual Studio

MainPage.xaml içinde eylem sayfasını görüntüleyecek yeni bir Button bildirimi ekleyin:
```
<Button Text="Display action sheet"
        Clicked="OnDisplayActionSheetButtonClicked" />
```
Button.Text özelliği, Button içinde görüntülenen metni belirtir. Ayrıca Clicked olayı, bir sonraki adımda oluşturulacak OnDisplayActionSheetButtonClicked adlı olay işleyicisi olarak ayarlanmıştır.
Çözüm Gezgini'ndeki PopupsTutorial projesinde MainPage.xaml bölümünü genişletip MainPage.xaml.cs dosyasına çift tıklayarak açın. Ardından MainPage.xaml.cs içinde sınıfa OnDisplayActionSheetButtonClicked olay işleyicisini ekleyin:
```
async void OnDisplayActionSheetButtonClicked(object sender, EventArgs e)
{
    string action = await DisplayActionSheet("Send to?", "Cancel", null, "Email", "Twitter", "Facebook");
    Console.WriteLine("Action: " + action);
}
```
Button öğesine dokunulduğunda OnDisplayActionSheetButtonClicked yöntemi yürütülür. Bu yöntem DisplayActionSheet yöntemini çağırarak kullanıcıya görevi sürdürmek için kullanabileceği bir dizi alternatif sunar. Kullanıcı alternatiflerden birini seçtikten sonra yapılan seçim string olarak döndürülür.

Önemli

DisplayActionSheet yöntemi zaman uyumsuzdur ve her zaman await anahtar sözcüğüyle birlikte beklenmelidir.
Visual Studio araç çubuğunda Başlat düğmesine (Oynat düğmesine benzeyen üçgen düğme) basarak uygulamayı seçtiğiniz uzak iOS simülatöründe veya Android öykünücüsünde başlatın. Ardından ContentPage içine eklediğiniz Button öğesine dokunun:

Eylem sayfası iletişim kutusundaki alternatiflerden birini seçtiğinizde ilgili seçimin Visual Studio Çıkış penceresinde görüntülendiğini göreceksiniz. Bu pencere görünmüyorsa, Çıktıyı Görüntüle > menü seçeneği seçilerek görünür hale getirilebilir.

Visual Studio'da uygulamayı durdurun.

Eylem sayfalarını görüntüleme hakkında daha fazla bilgi için Açılır Pencereleri Görüntüleme kılavuzunun Kullanıcılara görevlerde kılavuzluk yapma bölümüne bakın.

MainPage.xaml içinde eylem sayfasını görüntüleyecek yeni bir Button bildirimi ekleyin:
```
<Button Text="Display action sheet"
        Clicked="OnDisplayActionSheetButtonClicked" />
```
Button.Text özelliği, Button içinde görüntülenen metni belirtir. Ayrıca Clicked olayı, bir sonraki adımda oluşturulacak OnDisplayActionSheetButtonClicked adlı olay işleyicisi olarak ayarlanmıştır.
Çözüm Bölmesi'ndeki PopupsTutorial projesinde MainPage.xaml bölümünü genişletip MainPage.xaml.cs dosyasına çift tıklayarak açın. Ardından MainPage.xaml.cs içinde sınıfa OnDisplayActionSheetButtonClicked olay işleyicisini ekleyin:
```
async void OnDisplayActionSheetButtonClicked(object sender, EventArgs e)
{
    string action = await DisplayActionSheet("Send to?", "Cancel", null, "Email", "Twitter", "Facebook");
    Console.WriteLine("Action: " + action);
}
```
Button öğesine dokunulduğunda OnDisplayActionSheetButtonClicked yöntemi yürütülür. Bu yöntem DisplayActionSheet yöntemini çağırarak kullanıcıya görevi sürdürmek için kullanabileceği bir dizi alternatif sunar. Kullanıcı alternatiflerden birini seçtikten sonra yapılan seçim string olarak döndürülür.

Önemli

DisplayActionSheet yöntemi zaman uyumsuzdur ve her zaman await anahtar sözcüğüyle birlikte beklenmelidir.
Mac için Visual Studio araç çubuğunda Başlat düğmesine (Oynat düğmesine benzeyen üçgen düğme) basarak uygulamayı seçtiğiniz iOS simülatöründe veya Android öykünücüsünde başlatın. Ardından ContentPage içine eklediğiniz Button öğesine dokunun:

Eylem sayfası iletişim kutusundaki alternatiflerden birini seçtiğinizde ilgili seçimin Mac için Visual Studio Uygulama Çıkışı penceresinde görüntülendiğini göreceksiniz. Bu pencere görünmüyorsa, Diğer Windows > Uygulama Çıkışını Görüntüle > menü seçeneği seçilerek görünür hale getirilebilir.

Mac için Visual Studio'da uygulamayı durdurun.

Eylem sayfalarını görüntüleme hakkında daha fazla bilgi için Açılır Pencereleri Görüntüleme kılavuzunun Kullanıcılara görevlerde kılavuzluk yapma bölümüne bakın.

Xamarin.Forms Açılır Pencereler Öğreticisi

Uyarı görüntüleme

Eylem sayfası görüntüleme

Tebrikler!

Sonraki adımlar

Xamarin.Forms Açılır Pencereler Öğreticisi

Uyarı görüntüleme

Eylem sayfası görüntüleme

Tebrikler!

Sonraki adımlar

İlgili bağlantılar