Funkce Notify
Platí pro: aplikace plátna
modelem řízené aplikace
rozhraní příkazového řádku Power Platform
Zobrazí uživateli nápis.
Description
Funkce Upozornit zobrazí uživateli bannerovou zprávu v horní části obrazovky. Oznámení zůstává, dokud ho uživatel neodmítne nebo dokud nevyprší časový limit, který je ve výchozím nastavení 10 sekund.
V závislosti na typu zprávy se použije příslušná barva a ikona. Typ se určuje druhým argumentem funkce:
Poznámka:
Maximální počet znaků pro funkci Notify je 500 znaků.
Argument NotificationType | Popis |
---|---|
NotificationType.Error | Zobrazí zprávu jako chybu. |
NotificationType.Information (výchozí) | Zobrazí zprávu jako informační. |
NotificationType.Success | Zobrazí zprávu jako úspěch. |
NotificationType.Warning | Zobrazí zprávu jako upozornění. |
Zprávy se zobrazují při vytváření aplikace i tehdy, kdy koncoví uživatelé používají vaši aplikaci.
Oznámení lze použít pouze v vzorcích chování.
Notify lze spárovat s funkcí IfError pro detekci a hlášení chyb pomocí vlastní chybové zprávy.
Power Apps mohou odesílat nabízená oznámení také pomocí úplně jiného mechanismu, než je funkce Notify. Další informace naleznete v tématu Odeslání oznámení v Power Apps.
Upozornit vždy vrátí pravda.
Poznámka: Tato funkce měla dříve název ShowError a uměla zobrazovat pouze chybové zprávy.
Poznámka:
Oznámení lze použít v samostatné aplikaci plátna, vlastní stránce a prostředí příkazů Power Fx. Výchozí hodnoty pro NotificationType a Timeout se liší podle prostředí, ve kterém se používá. Hodnoty, které chcete nastavit pro NotificationType a Timeout, můžete určit tak, že je explicitně nastavíte ve vašem výrazu Power Fx a tyto hodnoty budou respektovány bez ohledu na prostředí.
Syntaxe
Upozornit( Zpráva [, Typ oznámení [, Časový limit ] ] )
- Zpráva – Povinné. Zpráva, která se zobrazí uživateli.
- NotificationType – Volitelné. Typ zprávy z tabulky výše, který se zobrazí. Výchozím typem je NotificationType.Information.
- Časový limit – volitelné. Počet milisekund, než bude oznámení automaticky zrušeno. Výchozí hodnota je 10 sekund (nebo 10 000 milisekund). Oznámení se bude zobrazovat na neurčito s Časovým limitem 0.
Příklady
Podrobný postup
Přidejte na obrazovku ovládací prvek Button.
Do vlastnosti OnSelecttlačítka nastavte tento vzorec:
Notify( "Hello, World" )
Klikněte nebo klepněte na tlačítko.
Při každém kliknutí na tlačítko se uživateli zobrazí zpráva Hello, World jako informace. Pokud to uživatel nezruší nebo znovu nestiskne tlačítko, automaticky se zruší za 10 sekund (výchozí časový limit).
Změňte typ zprávy na chybovou zprávu. Přidejte do vzorce druhý argument:
Notify( "Hello, World", NotificationType.Error )
Klikněte nebo klepněte na tlačítko.
Při každém kliknutí na tlačítko se teď uživateli zobrazí zpráva Hello, World jako chyba. Pokud to uživatel nezruší nebo znovu nestiskne tlačítko, automaticky se zruší za 10 sekund (výchozí časový limit).
Změňte typ zprávy na zprávu upozornění. Změňte ve vzorci druhý argument:
Notify( "Hello, World", NotificationType.Warning, 4000 )
Klikněte nebo klepněte na tlačítko.
Při každém kliknutí na tlačítko se teď uživateli zobrazí zpráva Hello, World jako upozornění. Pokud to uživatel nezruší nebo znovu nestiskne tlačítko, automaticky se zruší za 4 sekundy (4 000 milisekund).
Změňte typ zprávy na zprávu o úspěchu. Změňte ve vzorci druhý argument:
Notify( "Hello, World", NotificationType.Success, 0 )
Klikněte nebo klepněte na tlačítko.
Při každém kliknutí na tlačítko se teď uživateli zobrazí zpráva Hello, World jako úspěch. U časového limitu 0 bude oznámení zrušeno pouze uživatelem nebo dalším stisknutím tlačítka.