Confirma la funció
S'aplica a:
Aplicacions basades en models
Mostra un quadre de diàleg de confirmació a l'usuari.
Descripció
Nota
En aquest moment, la funció Confirma només està disponible quan s'escriuen Power Fx ordres per a aplicacions basades en models.
La funció Confirma mostra un quadre de diàleg a la part superior de la pantalla actual. Es proporcionen dos botons: un botó de confirmació i un botó de cancel·lació , que per defecte són versions localitzades de "D'acord" i "Cancel·la" respectivament. L'usuarisi ha de confirmar o cancel·lar abans que es descarti el quadre de diàleg i la funció retorni. A més del botó de diàleg, cancel· lar també es pot seleccionar amb la tecla Esc o altres gestos específics de la plataforma.
El paràmetre Message es mostra al cos del quadre de diàleg. Si el missatge és llarg, es pot truncar o es pot proporcionar una barra de desplaçament.
Utilitzeu el paràmetre OptionsRecord per especificar les opcions del quadre de diàleg. No totes les opcions estan disponibles a cada plataforma i es gestionen en les millors condicions possibles. Aquestes opcions no s'admeten a les aplicacions de llenç.
| Camp de l'opció | Descripció |
|---|---|
| Botó de confirmació | El text que es mostrarà al botó de confirmació , substituint el text "D'acord" localitzat per defecte. |
| Cancel·laBotó | El text que es mostrarà al botó de cancel·lació , substituint el text localitzat per defecte "Cancel·la". |
| Títol | El text que es mostrarà com a títol del quadre de diàleg. Un tipus de lletra més gran que el tipus de lletra del missatge es pot utilitzar per visualitzar aquest text. El text es truncarà si és llarg. |
| Subtítol | El text que es mostrarà com a subtítol del quadre de diàleg. Un tipus de lletra més gran que el tipus de lletra del missatge es pot utilitzar per visualitzar aquest text. El text es truncarà si és llarg. |
Confirma retorna true si s'ha seleccionat el botó de confirmació , false en cas contrari.
Utilitzeu la funció Notifica per mostrar un bàner de missatge a la part superior de l'aplicació que no cal descartar.
Sintaxi
Confirm( Missatge [, OptionsRecord ] )
- Missatge : obligatori. Missatge que es mostrarà a l'usuarisi.
- OptionsRecord : opcional. Proporcioneu la configuració de les opcions per al quadre de diàleg. No totes les opcions estan disponibles a cada plataforma i es gestionen en les millors condicions possibles.
Exemples
If( Confirm( "Are you sure?" ), Remove( ThisItem ) )
Diàleg de confirmació senzill, que demana a l'usuari que confirmi la supressió d'un registre abans de suprimir-lo. A menys que l'usuari premeu el botó "D'acord", el registre no se suprimirà.
If( Confirm( "Are you sure?", {Title: "Delete Confirmation"} ), Remove( ThisItem ) )
El mateix diàleg que l'últim exemple, però afegeix text de títol.
Set( FavColor,
If( Confirm( "What is your favorite color?",
{ ConfirmButton: "Red", CancelButton: "Green" }
),
"Red",
"Green"
)
)
Demana a l'usuari quin és el seu color favorit, capturant-ne el resultat en una variable global. El resultat que es col·locarà a FavColor serà la cadena de text "Vermell" o "Verd". Com a opció de confirmació , "Vermell" és el predeterminat. Això només funciona en plataformes que admeten les opcions ConfirmButton i CancelButton .
Confirm( "There was a problem, please review your order." )
Mostra un missatge de manera molt semblant a la funció Notifica , però és modal i requereix que l'usuari seleccioni un botó per continuar. Utilitzeu-lo quan sigui important que l'usuari confirmi el missatge abans de continuar. En aquesta situació, quin botó s'ha seleccionat no és important i el resultat no està marcat.