Confirm işlevi

Şunlar için geçerlidir: Model temelli uygulamalar

Kullanıcı için bir onay diyalog kutusu görüntüleyin.

Description

Not

Şu anda, Onayla işlevi yalnızca model odaklı uygulamalar için Power Fx komutları yazarken kullanılabilir.

Onayla işlevi geçerli ekranın en üstünde bir iletişim kutusu görüntüler. İki düğme sağlanır: onay düğmesi ve iptal düğmesi; varsayılan olarak sırasıyla "Tamam" ve "İptal" olarak yerelleştirilen sürümlerine ayarlanır. İletişim kutusu kapatıldıktan ve işlev geri dönmeden önce kullanıcının onaylaması veya iptal etmesi gerekir. İletişim kutusunun yanı sıra, iptal işlemi Esc tuşuyla veya platforma özgü diğer hareketlerle de seçilebilir.

İleti parametresi, diyalog kutusunun gövdesinde görüntülenir. İleti uzunsa kesilebilir veya bir kaydırma çubuğu sağlanabilir.

OptionsRecord parametresini diyalog kutusuyla ilgili seçenekleri belirtmek için kullanın. Her platformda tüm seçenekler kullanılamaz ve seçenekler en iyi çaba temelinde işlenir. Bu seçenekler tuval uygulamalarında desteklenmez.

Seçenek Alanı	Veri Akışı Açıklaması
ConfirmButton	Onayla düğmesinde gösterilecek metin; varsayılan olarak yerelleştirimiş "Tamam" metni ile değiştirilir.
CancelButton	İptal düğmesinde gösterilecek metin; varsayılan olarak yerelleştirilmiş "İptal" metni ile değiştirilir.
Başlık	İletişim kutusunun başlığı olarak görüntülenecek metin Bu metni görüntülemek için ileti yazı tipine göre daha büyük ve kalın yazı tipi kullanılabilir. Metin çok uzunsa kesilir.
Alt yazı	İletişim kutusunun alt başlığı olarak görüntülenecek metin Bu metni görüntülemek için ileti yazı tipine göre daha büyük ve kalın yazı tipi kullanılabilir. Metin çok uzunsa kesilir.

Onayla, onay düğmesi seçildiyse true, aksi takdirde false döndürür.

Uygulamanın üst kısmında kapatılması gerekmeyen bir ileti başlığı görüntülemek için Bildir işlevini kullanın.

Sözdizimi

Onayla (İleti [, OptionsRecord])

• İleti - Gerekli. Kullanıcıya görüntülenecek ileti.
• OptionsRecord - İsteğe bağlı. Diyalog kutusu için seçenek ayarlarını sağlayın. Her platformda tüm seçenekler kullanılamaz ve seçenekler "en iyi çaba" temelinde işlenir.

Örnekler

If( Confirm( "Are you sure?" ), Remove( ThisItem ) )

Kullanıcının kayıt silinmeden önce silme işlemini onaylamasını isteyen basit onay iletişim kutusu. Kullanıcı "Tamam" düğmesine basmadıkça kayıt silinmez.

If( Confirm( "Are you sure?", {Title: "Delete Confirmation"} ), Remove( ThisItem ) )

Son örnekle aynı iletişim kutusu ancak Başlık metni ekler.

Set( FavColor, 
     If( Confirm( "What is your favorite color?", 
                  { ConfirmButton: "Red", CancelButton: "Green" } 
         ), 
         "Red", 
         "Green" 
     ) 
)

Kullanıcıya favori rengini sorar ve sonucu genel bir değişkende yakalar. FavColor içine yerleştirilecek sonuç, "Kırmızı" veya "Yeşil" metin dizesidir. Onaylama seçeneği olarak "Kırmızı" varsayılandır. Bu yalnızca ConfirmButton ve CancelButton seçeneklerini destekleyen platformlar için geçerlidir.

Confirm( "There was a problem, please review your order." )

Bir iletiyi, Bildir işlevine benzer şekilde görüntüler ancak kalıcıdır ve kullanıcının ilerlemek için bir düğme seçmesini gerektirir. Kullanıcının devam etmeden önce mesajı onaylamasının önemli olduğu durumlarda kullanın. Bu durumda, hangi düğmenin seçildiği önemli değildir ve sonuç kontrol edilmez.