Confirm פונקציה

חל על: אפליקציות Canvas המבוססות על מודלים

השתמש בפונקציה זו כדי להציג למשתמש תיבת דו-שיח לאישור.

Description

הפונקציה Confirm מציגה תיבת דו-שיח מעל המסך הנוכחי עם שני לחצנים: לחצן אישורולחצן ביטול. באפליקציות מונחות דגמים, לחצנים אלה כברירת מחדל לגירסאות "OK" ו- "Cancel" המותאמות לשפות אחרות בהתאמה. Confirm זמין גם ביישום בד ציור להצגת תיבת דו-שיח פשוטה לאישור ולהחזרת תוצאה בוליאנית.

על המשתמש לבחור אחד מהלחצנים לפני סגירת תיבת הדו-שיח. מלבד בחירה בלחצן ביטול, ניתן לבטל את תיבת הדו-שיח באמצעות מחוות ספציפיות לפלטפורמה (כגון מקש Esc או לחיצה מחוץ לתיבת הדו-שיח). ביישום בד ציור, נתיב ביטול זה אינו מטופל כפעולה (לדוגמה, הוא מחזיר ) blank.

הערה

ביישום בד ציור, הפונקציה Confirm משתמשת בתיבת הדו-שיח Fluent. ודא שפקדים מודרניים זמינים; אחרת, תיבת הדו-שיח המקורית של הדפדפן תופיע.

תחביר

Confirm( Message [, OptionsRecord ] )

• הודעה - חובה. הודעה להצגה למשתמש.
• OptionsRecord - אופציונלי. ספק קבוצת אפשרויות לדו-שיח. ראה להלן את האפשרויות הזמינות.

אפשרויות

השתמש בפרמטר OptionsRecord כדי להתאים אישית את תיבת הדו-שיח לאישור:

אפשרות	Description
כפתור אישור	הטקסט שיוצג בלחצן האישור, תוך החלפת הטקסט "אישור" או "Confirm" המותאם לשפות אחרות המוגדר כברירת מחדל.
כפתור ביטול	הטקסט שיוצג בלחצן הביטול, תוך החלפת הטקסט "ביטול" המותאם לשפות אחרות המוגדר כברירת מחדל.
כּוֹתֶרֶת	הטקסט שיוצג ככותרת תיבת הדו-שיח. מוצג בגופן גדול יותר מודגש יותר מההודעה. היא עשויה להיחתך אם היא ארוכה מאוד.
כְּתוּבִית	הטקסט שיוצג ככותרת המשנה של תיבת הדו-שיח. מוצג בין הכותרת להודעה. היא עשויה להיחתך אם היא ארוכה מאוד.

אופן הפעולה המהווה ברירת מחדל

תוויות לחצן: אם אינך מספק תוויות לחצן מותאמות אישית, השתמש בטקסט Confirm הלחצן המותאם לשפות אחרות המוגדר כברירת מחדל:

• ביישום בד ציור (תצוגה מקדימה), ברירות המחדל הן "Confirm" ו "ביטול" (מותאם לשפות אחרות).
• באפליקציות מונחות דגמים, ברירות המחדל הן "אישור" ו"ביטול" (מותאם לשפות אחרות).

ערך החזרה:Confirm מחזירה true אם המשתמש בוחר בלחצן אישור, ובחזרה false אחרת.

דוגמאות

יישומים מונחי-דגמים

אישור פשוט לפני הסרת רשומה

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

הצגת תיבת דו-שיח לאישור עם לחצני ברירת מחדל. אם המשתמש בוחר בלחצן אישור, הרשומה מוסרת.

אישור עם כותרת מותאמת אישית

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

הוספת כותרת לתיבת הדו-שיח לאישור לפני הסרת רשומה.

תוויות לחצן מותאמות אישית עבור העדפת משתמש

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

שימוש בתוויות לחצן מותאמות אישית כדי ללכוד העדפה פשוטה. התוצאה מאוחסנת במשתנה הכללי FavColor.

הודעה מודאלית מבלי לבדוק את ערך ההחזרה

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

הצגת הודעה מודאלית שהמשתמש חייב לאשר לפני שתמשיך. ערך ההחזרה אינו מסומן.

---

יישומי בד ציור

Confirm לפני המחיקה

השתמש 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)
)

הצגת תיבת דו-שיח לאישור עם תוויות כותרת, כותרת משנה ולחצן מותאם אישית. הרשומה נמחקת רק אם המשתמש בוחר מחק.

Confirm לפני שמירת טופס

השתמש 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)
)

הצגת תיבת דו-שיח לאישור לפני שליחת הטופס. הטופס נשלח רק אם המשתמש מאשר.

תוצאת האחסון במשתנה עבור פעולות מרובות

אחסן את תוצאת האישור לשימוש בפעולות מרובות במורד הזרם:

// 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)
)

התוצאה הבוליאנית מאוחסנת ובאפשרותך להפנות varConfirmed מספר פעמים ללוגיקה מותנית.

התאמה אישית מלאה עם כל האפשרויות

הצג את כל אפשרויות ההתאמה האישית הזמינות:

// 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)
)

הצגת תיבת דו-שיח מותאמת אישית מלאה עם תוויות כותרת, כותרת משנה, הודעה ולחצן מותאם אישית.

שאלות נפוצות

האם ניתן להסתיר את לחצן ביטול?

לא. העיצוב הנוכחי מציג תמיד הן את הלחצנים Confirm והן את הלחצנים ביטול. למשתמשים חייבת להיות היכולת לבטל או לבטל את תיבת הדו-שיח.

האם ניתן להוסיף לחצן שלישי או יותר משתי אפשרויות?

לא. Confirm תומך בשתי אפשרויות בדיוק: פעולת אישור וביטול. עבור תרחישים הדורשים אפשרויות בחירה מרובות, שקול להשתמש בתבנית ממשק משתמש שונה, כגון מסך מותאם אישית או פקד רשימה נפתחת.

האם לחסום Confirm פעולות אחרות?

כן. Confirm מוצגת כתיבת דו-שיח מודאלית שהמשתמש חייב לבטל כדי שהוא יוכל לקיים אינטראקציה עם חלקים אחרים של היישום.

למידע נוסף

Notify - הצגת הודעת כרזה לא מודאלית בחלק העליון של המסך שאינה דורשת ביטול של משתמש.