Kopīgot, izmantojot

Apstiprināt funkciju

  • Raksts

Attiecas uz: modeļa vadītām programmām

Parādīt apstiprinājuma dialoglodziņu lietotājam.

Apraksts

Piezīmes

Pašlaik funkcija Apstiprināt ir pieejama tikai tad, ja raksta Power Fx komandas modeļa vadītām programmām.

Funkcija Confirm parāda dialoglodziņu pašreizējā ekrāna augšpusē. Tiek nodrošinātas divas pogas: apstiprināšanas poga un atcelšanas poga, kas pēc noklusējuma ir lokalizētas attiecīgi "OK" un "Cancel" versijas. Lietotājam ir jāapstiprina vai jāatceļ, pirms dialoglodziņš tiek atbrīvots no darba un funkcija tiek atgriezta. Papildus dialoga pogai, atcelt var izvēlēties arī ar taustiņu Esc vai citiem žestiem, kas ir specifiski platformai.

Dialoglodziņa pamattekstā tiek parādīts parametrs Ziņojums . Ja ziņojums ir garš, tas var tikt saīsināts vai var būt norādīta ritjosla.

Izmantojiet parametru OptionsRecord, lai norādītu dialoglodziņa opcijas. Ne visas opcijas ir pieejamas katrā platformā un tiek apstrādātas, par pamatu izmantojot "labāko piepūli". Šīs opcijas netiek atbalstītas audekla programmās.

Lauks Opcijas Apraksts
ConfirmButton Teksts, kas jāparāda apstiprināšanas pogā, aizstājot noklusēto, lokalizēto "OK" tekstu.
CancelButton Teksts, kas jāparāda atcelšanas pogā, aizstājot noklusējuma, lokalizēto tekstu "Atcelt".
Nosaukums Teksts, kas jārāda kā dialoglodziņa virsraksts. Šī teksta rādīšanai var izmantot lielāku, treknraksta fontu, nekā ziņojuma fontu. Teksts tiks saīsināts, ja tas ir garš.
Apakšvirsraksts Teksts, kas jāparāda kā dialoglodziņa apakšvirsraksts. Šī teksta rādīšanai var izmantot lielāku, treknraksta fontu, nekā ziņojuma fontu. Teksts tiks saīsināts, ja tas ir garš.

Apstipriniet atgriešanu patiess , ja tika atlasīta apstiprināšanas poga, pretējā gadījumā aplams .

Izmantojiet funkciju Paziņot , lai programmas augšdaļā parādītu ziņojuma reklāmkarogu, kas nav jānoraida.

Sintakse

Apstiprināt( Message [, OptionsRecord ] )

  • Ziņojums - Obligāts. Lietotājam rādāmais ziņojums.
  • OptionsRecord - neobligāti. Norādiet dialoglodziņam opciju iestatījumus. Ne visas opcijas ir pieejamas katrā platformā un tiek apstrādātas, par pamatu izmantojot "labāko piepūli".

Piemēri

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

Vienkāršs apstiprinājuma dialoglodziņš, kurā lietotājam tiek lūgts apstiprināt ieraksta dzēšanu pirms tā noņemšanas. Ja vien lietotājs nenospiež pogu "OK", ieraksts netiks izdzēsts.

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

Tas pats dialoglodziņš, kas pēdējā piemērā, bet pievieno virsraksta tekstu.

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

Vaicā lietotājam par savu iecienīto krāsu, tverot rezultātu globālajā mainīgajā. Rezultāts, kas tiks ievietots FavColor , būs teksta virkne "Red" vai "Green". Kā apstiprināšanas izvēle "Sarkans" ir noklusējums. Tas darbojas tikai platformās, kas atbalsta ConfirmButton un CancelButton opcijas.

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

Parāda ziņojumu līdzīgi kā to dara funkcija Paziņot , bet tas ir modāls un prasa lietotājam atlasīt pogu, lai turpinātu. Izmantojiet, ja ir svarīgi, lai lietotājs atpazītu ziņojumu, pirms turpināt. Šādā gadījumā nav svarīgi, kura poga tika atlasīta, un rezultāts netiek pārbaudīts.