Confirm-Funktion

Gilt für: Modellgesteuerte Apps

Dem Benutzer wird ein Bestätigungsdialogfeld angezeigt.

Beschreibung

Notiz

Derzeit ist die Funktion Confirm ist nur verfügbar, wenn Power Fx-Befehle für modellgesteuerte Apps geschrieben werden.

Die Confirm-Funktion zeigt ein Dialogfeld über dem aktuellen Bildschirm an. Es stehen zwei Schaltflächen zur Verfügung: eine Bestätigen- und eine Abbrechen-Schaltfläche, die standardmäßig auf lokalisierte Versionen von „OK“ bzw. „Abbrechen“ eingestellt sind. Der Benutzer muss bestätigen oder abbrechen, bevor das Dialogfeld geschlossen wird und die Funktion zurückkehrt. Neben der Dialogschaltfläche kann Abbrechen auch mit der Esc-Taste oder anderen plattformspezifischen Gesten ausgewählt werden.

Der Parameter Message wird im Hauptteil des Dialogfelds angezeigt. Eine lange Nachricht wird entweder abgeschnitten oder eine Bildlaufleiste wird bereitgestellt.

Verwenden Sie den OptionsRecord-Parameter, um Optionen für das Dialogfeld anzugeben. Nicht alle Optionen sind auf jeder Plattform verfügbar und werden nach bestem Wissen und Gewissen behandelt. Diese Optionen werde in Canvas-Apps nicht unterstützt.

Feldoption	Beschreibung
Schaltfläche „Bestätigen“	Der Text, der auf der Schaltfläche bestätigen angezeigt wird, ersetzt den standardmäßigen lokalisierten Text OK.
AbbrechenButton	Der Text, der auf der Schaltfläche abbrechen angezeigt wird, ersetzt den standardmäßigen lokalisierten Text abbrechen.
Titel	Der Text, der als Titel des Dialogfelds angezeigt werden soll. Zur Anzeige dieses Textes kann eine größere, fettere Schriftart als die Nachrichtenschrift verwendet werden. Der Text wird abgeschnitten, falls er zu lang ist.
Untertitel	Der Text, der als Untertitel des Dialogfelds angezeigt werden soll. Zur Anzeige dieses Textes kann eine größere, fettere Schriftart als die Nachrichtenschrift verwendet werden. Der Text wird abgeschnitten, falls er zu lang ist.

„Bestätigen“ gibt „true“ zurück, wenn die Schaltfläche „Bestätigen“ ausgewählt wurde, andernfalls „false“ .

Verwenden Sie die Notify Funktion, um oben in der App eine Meldung anzeigen zu lassen, die nicht geschlossen werden muss.

Syntax

Bestätigen( Nachricht [, OptionenDatensatz ] )

• Nachricht – Erforderlich. Meldung, die dem Benutzer angezeigt wird.
• OptionsRecord – Optional. Stellen Sie Optionseinstellungen für das Dialogfeld bereit. Nicht alle Optionen sind auf jeder Plattform verfügbar und werden nach bestem Wissen und Gewissen behandelt.

Beispiele

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

Einfacher Bestätigungsdialog, in dem der Benutzer aufgefordert wird, das Löschen eines Datensatzes zu bestätigen, bevor er entfernt wird. Der Datensatz wird nicht gelöscht, es sei denn, der Benutzer drückt die „OK“-Schaltfläche.

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

Gleicher Dialog wie im letzten Beispiel, aber Titeltext wird hinzugefügt.

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

Fragt den Benutzer nach seiner Lieblingsfarbe und erfasst das Ergebnis in einer globalen Variablen. Das Ergebnis, das in FavColor platziert wird, ist die Textzeichenfolge „Rot“ oder „Grün“ sein. „Rot“ ist die Standardeinstellung für die Auswahl Bestätigen. Dies funktioniert nur auf Plattformen, welche die Optionen ConfirmButton und CancelButton unterstützen.

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

Zeigt eine Nachricht ähnlich der Notify-Funktion an, ist jedoch modal und erfordert, dass der Benutzer eine Schaltfläche auswählt, um fortzufahren. Verwenden, wenn es wichtig ist, dass der Benutzer die Nachricht vor dem Fortfahren bestätigt. In dieser Situation spielt es keine Rolle, welche Schaltfläche ausgewählt wurde. Das Ergebnis wird nicht überprüft.