Xamarin.Forms İlerleme Çubuğu

Denetim Xamarin.FormsProgressBar , ilerleme durumunu görsel olarak bir değerle temsil edilen yüzdeye doldurulmuş yatay bir float çubuk olarak temsil eder. ProgressBar sınıfı öğesinden Viewdevralır.

Aşağıdaki ekran görüntüleri iOS ve Android'de bir ProgressBar gösterir:

Denetim ProgressBar iki özelliği tanımlar:

• Progressfloat, geçerli ilerleme durumunu 0'dan 1'e kadar olan bir değer olarak temsil eden bir değerdir. Progress 0'dan küçük değerler 0'a, 1'den büyük değerler 1'e sıkıştırılır.
• ProgressColor geçerli ilerleme durumunu temsil eden iç çubuk rengini etkileyen bir Color değerdir.

Bu özellikler nesneler tarafından BindableProperty desteklenir; başka ProgressBar bir deyişle, stili oluşturulabilir ve veri bağlamalarının hedefi olabilir.

Denetim ProgressBar , çubuğu geçerli değerinden belirtilen değere ProgressTo animasyon ekleyen bir yöntem de tanımlar. Daha fazla bilgi için bkz . ProgressBar'a animasyon ekleme.

Not

kullanıcı ProgressBar düzenlemesini kabul etmediğinden, denetimleri seçmek için Sekme tuşu kullanılırken atlanır.

progressbar oluşturma

ProgressBar XAML'de örneği oluşturulabilir. özelliği Progress , iç, renkli çubuğun dolgu yüzdesini belirler. Varsayılan Progress özellik değeri 0'dır. Aşağıdaki örnek, isteğe bağlı Progress özellik kümesiyle XAML'de bir ProgressBar örneği oluşturmayı gösterir:

<ProgressBar Progress="0.5" />

ProgressBar Kodda da oluşturulabilir:

ProgressBar progressBar = new ProgressBar { Progress = 0.5f };

Uyarı

, Startveya End gibi ProgressBarkısıtlanmamış yatay düzen seçeneklerini Centerkullanmayın. UWP'de, sıfır genişlikte ProgressBar bir çubuk daraltılır. varsayılan HorizontalOptions değerini Fill koruyun ve düzenine eklerken Grid ProgressBar öğesinin Auto genişliğini kullanmayın.

ProgressBar görünüm özellikleri

ProgressColor özelliği sıfırdan büyük olduğunda Progress iç çubuk rengini tanımlar. Aşağıdaki örnekte, özellik kümesiyle XAML'de bir ProgressBar örneği oluşturma gösterilmektedir ProgressColor :

<ProgressBar ProgressColor="Orange" />

Kod ProgressColor içinde oluştururken ProgressBar özelliği de ayarlanabilir:

ProgressBar progressBar = new ProgressBar { ProgressColor = Color.Orange };

Aşağıdaki ekran görüntüleri, iOS ve Android'de Color.Orange özelliğinin ProgressColor olarak ayarlandığı öğesini gösterirProgressBar:

İlerleme Çubuğuna Animasyon Ekleme

yöntemi, ProgressTo geçerli Progress değerinden ProgressBar zaman içinde sağlanan bir değere animasyon ekler. yöntemi bir float ilerleme değeri, milisaniye cinsinden bir uint süre, bir Easing sabit listesi değeri kabul eder ve döndürür Task<bool>. Aşağıdaki kod, bir ProgressBaranimasyonu nasıl oluşturacaklarını gösterir:

// animate to 75% progress over 500 milliseconds with linear easing
await progressBar.ProgressTo(0.75, 500, Easing.Linear);

Numaralandırma hakkında Easing daha fazla bilgi için, bkz . içindeki Xamarin.Formskolaylaştırma işlevleri.