Confirm fonksiyon

Şunlar için geçerlidir: Model temelli uygulamalar, Tuval uygulamaları

Kullanıcıya bir onay iletişim kutusu görüntülemek için bu işlevi kullanın.

Description

İşlev, Confirm geçerli ekranın üst kısmında iki düğme içeren bir iletişim kutusu görüntüler: onayla düğmesi ve iptal düğmesi. Model temelli uygulamalarda, bu düğmeler varsayılan olarak sırasıyla "Tamam" ve "İptal" yerelleştirilmiş sürümlerine sahiptir. Confirm basit bir onay iletişim kutusunu göstermek ve Boole sonucu döndürmek için tuval uygulamalarında da kullanılabilir.

İletişim kutusu kapatılmadan önce kullanıcının düğmelerden birini seçmesi gerekir. İptal düğmesini seçmenin yanı sıra, iletişim kutusu platforma özgü hareketlerle (Esc tuşu veya iletişim kutusunun dışına tıklama gibi) kapatılabilir. Tuval uygulamalarında, bu kapatma yolu hiçbir eylem olarak ele alınmaz (yani döndürür blank).

Not

Tuval uygulamalarında işlev Fluent Confirm iletişim kutusunu kullanır. Modern denetimlerin etkinleştirildiğinden emin olun; aksi takdirde, yerel tarayıcı iletişim kutusu görüntülenir.

Sözdizimi

Confirm( Message [, OptionsRecord ] )

• Mesaj - 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. Kullanılabilir seçenekler için aşağıya bakın.

Options

Onay iletişim kutusunu özelleştirmek için OptionsRecord parametresini kullanın:

Seçenek	Description
Onayla Düğmesi	Onay düğmesinde görüntülenecek metin, varsayılan yerelleştirilmiş "Tamam" veya "Confirm" metninin yerini alır.
İptal Düğmesi	varsayılan yerelleştirilmiş "İptal" metninin yerini alarak iptal düğmesinde görüntülenecek metin.
Title	İletişim kutusu başlığı olarak görüntülenecek metin. İletiden daha büyük, daha kalın bir yazı tipinde görüntülenir. Çok uzun sürerse kesilebilir.
Altyazı	İletişim kutusu alt başlığı olarak görüntülenecek metin. Başlık ve ileti arasında görüntülenir. Çok uzun sürerse kesilebilir.

Varsayılan davranış

Düğme etiketleri: Özel düğme etiketleri sağlamazsanız, Confirm yerelleştirilmiş varsayılan düğme metnini kullanır:

• Tuval uygulamalarında (önizleme) varsayılan değerler "" ve "Confirmİptal" (yerelleştirilmiş) şeklindedir.
• Model temelli uygulamalarda varsayılanlar "Tamam" ve "İptal" (yerelleştirilmiş) şeklindedir.

Dönüş değeri:Confirm , kullanıcı onay düğmesini seçerse ve false aksi takdirde döndürürtrue.

Örnekler

Model temelli uygulamalar

Kaydı kaldırmadan önce basit onay

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

Varsayılan düğmeleri olan bir onay iletişim kutusu görüntüler. Kullanıcı onayla düğmesini seçerse kayıt kaldırılır.

Özel başlıkla onay

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

Kaydı kaldırmadan önce onay iletişim kutusuna başlık ekler.

Kullanıcı tercihi için özel düğme etiketleri

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

Basit bir tercih yakalamak için özel düğme etiketlerini kullanır. Sonuç genel değişkeninde FavColordepolanır.

Dönüş değeri denetlenmeden kalıcı ileti

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

Devam etmeden önce kullanıcının kabul etmesi gereken kalıcı bir ileti görüntüler. Dönüş değeri işaretlenmemiş.

---

Canvas uygulamalar

Confirm silmeden önce

Kayıtların yanlışlıkla silinmesini önlemek için kullanın Confirm :

// Button.OnSelect
If(
    Confirm(
        "Are you sure you want to delete this record?",
        {
            Title: "Delete confirmation",
            Subtitle: "This action can't be undone.",
            ConfirmButton: "Delete",
            CancelButton: "Cancel"
        }
    ),
    Remove(YourDataSource, Gallery1.Selected);
    Notify("Record deleted.", NotificationType.Success)
)

Başlık, alt başlık ve özel düğme etiketleri içeren bir onay iletişim kutusu görüntüler. Kayıt yalnızca kullanıcı Sil'i seçtiğinde silinir.

Confirm form kaydetmeden önce

Veri göndermeden önce kullanıcı amacını doğrulamak için kullanın Confirm :

// Save button.OnSelect
If(
    Confirm(
        "Do you want to save these changes?",
        { Title: "Save changes" }
    ),
    SubmitForm(EditForm1);
    ResetForm(EditForm1);
    Notify("Changes saved successfully.", NotificationType.Success)
)

Formu göndermeden önce bir onay iletişim kutusu görüntüler. Form yalnızca kullanıcı onaylarsa gönderilir.

Sonucu birden çok eylem için bir değişkende depolama

Birden çok aşağı akış işlemi için kullanılacak onay sonucunu depolayın:

// Button.OnSelect
Set(
    varConfirmed,
    Confirm("Do you want to proceed with this operation?")
);

If(
    varConfirmed,
    Notify("Processing your request...", NotificationType.Information);
    /* Additional operations */,
    Notify("Operation canceled.", NotificationType.Warning)
)

Boole sonucu içinde varConfirmed depolanır ve koşullu mantık için birden çok kez başvurulabilir.

Tüm seçeneklerle tam özelleştirme

Tüm kullanılabilir özelleştirme seçeneklerini gösterin:

// Button.OnSelect
If(
    Confirm(
        "This is the main message that describes what the user needs to confirm.",
        {
            Title: "Action Required 🔔",
            Subtitle: "Please choose one of the options below.",
            ConfirmButton: "Yes, proceed",
            CancelButton: "No, cancel"
        }
    ),
    Notify("User confirmed!", NotificationType.Success),
    Notify("User canceled.", NotificationType.Warning)
)

Başlık, alt başlık, ileti ve özel düğme etiketleri içeren tam olarak özelleştirilmiş bir iletişim kutusu görüntüler.

FAQs

İptal düğmesini gizleyebilir miyim?

Hayır. Geçerli tasarımda her zaman hem hem de Confirm İptal düğmeleri gösterilir. Kullanıcıların iletişim kutusunu kapatma veya iptal etme özelliğine sahip olması gerekir.

Üçüncü bir düğme veya ikiden fazla seçenek ekleyebilir miyim?

Hayır. Confirm tam olarak iki seçeneği destekler: onay eylemi ve iptal eylemi. Birden çok seçenek gerektiren senaryolar için özel ekran veya açılan liste denetimi gibi farklı bir kullanıcı arabirimi deseni kullanmayı göz önünde bulundurun.

Diğer işlemleri engeller mi Confirm ?

Evet. Confirm , kullanıcının uygulamanın diğer bölümleriyle etkileşim kurabilmesi için kapatması gereken kalıcı bir iletişim kutusu olarak görüntüler.

Ayrıca bakınız

Bildirim - Ekranın üst kısmında kullanıcı kapatma gerektirmeyen kalıcı olmayan bir başlık iletisi görüntüler.