ProgressIndicator kontrol

Yükleme deneyimi oluşturmak için kullanılan bir denetim.

Not

Tüm belgeler ve kaynak kodu GitHub kod bileşenleri deposunda bulunabilir.

Tanım

İlerleme durumu göstergeleri, iki saniyeden daha uzun süren bir işlemin tamamlanma durumunu göstermek için kullanılır. İlerleme durumu belirlenemezse bunun yerine bir Değer Değiştirici veya Indeterminate Indicator türünü kullanın. İlerleme durumu göstergeleri; yeni bir panelde, bir açılır pencerede, işlemi başlatan UI'nın altında veya başlatan kullanıcı arabirimin yerinde (etkinlik iptal edilir veya durdurulursa kullanıcı arabiriminin geri döndürülmesi şartıyla) gösterilebilir.

Bu kod bileşeni, tuval uygulamalarında ve özel sayfalarda kullanılmak üzere Fluent UI ProgressIndicator denetimi için sarmalayıcı sağlar. En iyi uygulamalar için bileşen belgelerine bakın.

Properties

Önemli özellikler

Özellik	Tanım
Label	Değer değiştirici için isteğe bağlı etiket.
Percentage Complete	0'dan 1'e kadar olan bir ölçekte tamamlanan işlem yüzdesi. Ayarlanmadıysa Belirsiz Gösterge görüntülenir.
TypeOfIndicator	Gösterge stilinin türünü belirtir. Seçenekler: Default Indicator veya IndeterminateIndicator
HideProgressState	İlerleme durumunu gizlemek için doğru değerini belirtme
BarHeight	Uygun olduğunda çubuğun yüksekliğini belirtme

Stil özellikleri

Özellik	Tanım
Theme	Fluent UI Tema Tasarımcısı (windows.net) kullanılarak oluşturulan bir JSON dizesini kabul eder. Bu alan boş bırakıldığında Power Apps tarafından tanımlanan varsayılan tema kullanılır. Yapılandırma kılavuzu için teme ayarlama bölümüne bakın.
AccessibilityLabel	Ekran okuyucu aria etiketi

Davranış

Yükleme ilerlemesini görüntüleme

İşlem başladığında ProgressIndicator denetiminin kendisini (veya bulunduğu yüzeyi) görünür yapın, ardından işlem segmentleri tamamlandıkça değişkeni bir değerle güncelleştirin. İşlem tamamlandığında gizleyin. Denetimin görünürlüğünü denetlemek ve işlemin gösterilmesi gereken büyük kod blokları arasında değerleri güncelleştirin.

UpdateContext({ var_showProgress: true , var_progressValue: 0 });

/* Some code ... */

UpdateContext({ var_progressValue: 25 });

/* Some code ... */

UpdateContext({ var_progressValue: 50 });

/* Some code ... */

UpdateContext({ var_progressValue: 75 });

/* Some code ... */

UpdateContext({ var_progressValue: 100 });

Notify("Successfully completed process", NotificationType.Success);

UpdateContext({ var_showProgress: false });

var_showProgress öğesinin (veya bulunduğu yüzeyin) Visible özelliği için değer olarak ProgressIndicator değişkenini girin ve var_progressValue özelliği için Value değişkenini atayın.

Sınırlamalar

Bu tuval bileşeni yalnızca tuval uygulamalarında ve özel sayfalarda kullanılabilir.