funktion Confirm

Gäller för: Modelldrivna appar, Arbetsyteappar

Använd den här funktionen om du vill visa en bekräftelsedialogruta för användaren.

Description

Funktionen Confirm visar en dialogruta ovanpå den aktuella skärmen med två knappar: en bekräfta-knapp och en avbryt-knapp . I modelldrivna appar är dessa knappar standard för lokaliserade versioner av "OK" respektive "Avbryt". Confirm är också tillgängligt i appar för arbetsytor för att visa en enkel bekräftelsedialogruta och returnera ett booleskt resultat.

Användaren måste välja en av knapparna innan dialogrutan stängs. Förutom att välja knappen Avbryt kan dialogrutan stängas via plattformsspecifika gester (till exempel Esc-tangenten eller klicka utanför dialogrutan). I appar för arbetsytor behandlas den här uppsägningssökvägen som ingen åtgärd (det vill säga den returnerar blank).

Syntax

Confirm( Message [, OptionsRecord ] )

• Meddelande – Obligatoriskt. Meddelande som ska visas för användaren.
• OptionsRecord - Valfritt. Ange alternativinställningar för dialogrutan. Se nedan för tillgängliga alternativ.

Options

Använd parametern OptionsRecord för att anpassa bekräftelsedialogrutan:

Standardbeteende

Knappetiketter: Om du inte anger anpassade knappetiketter Confirm använder du lokaliserad standardknapptext:

• I appar för arbetsytor (förhandsversion) är standardvärdena "Confirm" och "Avbryt" (lokaliserad).
• I modelldrivna appar är standardvärdena "OK" och "Avbryt" (lokaliserad).

Returvärde:Confirm returnerar true om användaren väljer knappen Bekräfta och false annars.

Exempel

Modellbaserade appar

Enkel bekräftelse innan du tar bort en post

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

Visar en bekräftelsedialogruta med standardknappar. Om användaren väljer knappen Bekräfta tas posten bort.

Bekräftelse med anpassad rubrik

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

Lägger till en rubrik i bekräftelsedialogrutan innan du tar bort en post.

Anpassade knappetiketter för användarinställningar

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

Använder anpassade knappetiketter för att skapa en enkel inställning. Resultatet lagras i den globala variabeln FavColor.

Modalt meddelande utan att kontrollera returvärdet

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

Visar ett modalt meddelande som användaren måste bekräfta innan du fortsätter. Returvärdet är inte markerat.

Canvas-appar

Confirm innan du tar bort

Använd Confirm för att förhindra oavsiktlig borttagning av poster:

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

Visar en bekräftelsedialogruta med etiketter för rubrik, underrubrik och anpassad knapp. Posten tas bara bort om användaren väljer Ta bort.

Confirm innan du sparar ett formulär

Använd Confirm för att verifiera användar avsikten innan du skickar data:

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

Visar en bekräftelsedialogruta innan formuläret skickas. Formuläret skickas endast om användaren bekräftar det.

Lagra resulterar i en variabel för flera åtgärder

Lagra bekräftelseresultatet som ska användas i flera underordnade åtgärder:

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

Det booleska resultatet lagras i varConfirmed och kan refereras flera gånger för villkorslogik.

Fullständig anpassning med alla alternativ

Visa upp alla tillgängliga anpassningsalternativ:

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

Visar en helt anpassad dialogruta med etiketter för rubrik, underrubrik, meddelande och anpassad knapp.

FAQs

Kan jag dölja knappen Avbryt?

Nej. Den aktuella designen visar alltid både knapparna Confirm och Avbryt. Användare måste ha möjlighet att stänga eller avbryta dialogrutan.

Kan jag lägga till en tredje knapp eller fler än två alternativ?

Nej. Confirm stöder exakt två alternativ: en bekräfta-åtgärd och en avbryt-åtgärd. För scenarier som kräver flera val kan du överväga att använda ett annat användargränssnittsmönster, till exempel en anpassad skärm eller listrutekontroll.

Blockerar Confirm andra åtgärder?

Ja. Confirm visas som en modal dialogruta som användaren måste stänga innan de kan interagera med andra delar av appen.

Se även

Meddela – Visar ett icke-modalt banderollmeddelande överst på skärmen som inte kräver att användaren avskedas.