Udostępnij za pośrednictwem

Funkcja Confirm

  • Artykuł

Dotyczy: Aplikacje oparte na modelu

Wyświetlić użytkownikowi okno dialogowe potwierdzenia.

Popis

Uwaga

Obecnie funkcja Confirm jest dostępna tylko podczas pisania poleceń Power Fx dla aplikacji opartych na modelu.

Funkcja Confirm powoduje wyświetlenie okna dialogowego u góry bieżącego ekranu. Dostępne są dwa przyciski: przycisk potwierdzenia i przycisk anulowania, które domyślnie są zlokalizowanymi wersjami odpowiednio „OK” i „Cancel”. Użytkownik musi potwierdzić lub anulować zanim okno dialogowe zostanie zamknięte i funkcja powróci. Oprócz przycisku dialogowego, anulowanie można również wybrać za pomocą klawisza Esc lub innych gestów, które są specyficzne dla danej platformy.

Parametr Message zostanie wyświetlony w treści okna dialogowego. Jeśli wiadomość jest bardzo długa, zostanie albo obcięta, albo pojawi się pasek przewijania.

Użyj parametru OptionsRecord do określenia opcji okna dialogowego. Nie wszystkie opcje są dostępne na każdej platformie i są obsługiwane na zasadzie „best effort”. Opcje te nie są obsługiwane w aplikacjach kanwy.

Pole opcje opis
PotwierdźPrzycisk Tekst wyświetlany na przycisku Confirm, zastępujący domyślny, zlokalizowany tekst OK.
Anuluj przycisk Tekst wyświetlany na przycisku cancel, zastępujący domyślny, zlokalizowany tekst Anuluj.
Tytuł Tekst, który ma być wyświetlany jako tytuł okna dialogowego. Do wyświetlenia tego tekstu można użyć większej, pogrubionej czcionki niż czcionka komunikatu. Tekst zostanie obcięty, jeśli jest długi.
Podtytuł Tekst, który ma być wyświetlany jako podtytuł okna dialogowego. Do wyświetlenia tego tekstu można użyć większej, pogrubionej czcionki niż czcionka komunikatu. Tekst zostanie obcięty, jeśli jest długi.

Potwierdź zwraca wartość true , jeśli wybrano przycisk potwierdzenia , w przeciwnym razie wartość false jest fałszywa .

Użyj funkcji Notify, aby wyświetlić baner z wiadomością na górze aplikacji, który nie musi być odrzucany.

Składnia

Confirm( Message [, OptionsRecord ] )

  • Wiadomość- Wymagane . Komunikat wyświetlany użytkownikowi.
  • OptionsRecord - Opcjonalne. Podać ustawienia opcji dla okna dialogowego. Nie wszystkie opcje są dostępne na każdej platformie i są obsługiwane na zasadzie „best effort”.

Przykłady

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

Prosty dialog potwierdzający, pytający użytkownika o potwierdzenie usunięcia rekordu przed jego usunięciem. Jeśli użytkownik nie naciśnie przycisku „OK”, rekord nie zostanie usunięty.

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

To samo okno dialogowe co w ostatnim przykładzie, ale dodaje tekst tytułu.

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

Pyta użytkownika o jego ulubiony kolor, przechwytując wynik do zmiennej globalnej. Wynik, który zostanie umieszczony w FavColor będzie ciągiem tekstowym „Czerwony” lub „Zielony”. W przypadku potwierdzenia wyboru domyślną wartością jest Czerwony. Działa to tylko na platformach, które obsługują opcje ConfirmButton i CancelButton.

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

Wyświetla wiadomość podobnie jak funkcja Notify, ale jest modalna i wymaga od użytkownika wybrania przycisku, aby kontynuować. Użyj, gdy ważne jest, aby użytkownik potwierdził wiadomość przed kontynuowaniem. W tej sytuacji wybrany przycisk nie jest ważny, a wynik nie jest sprawdzany.