Merge pull request MicrosoftDocs#2441 from MicrosoftDocs/gregli-notify

Update Notify function docs with new functionality

Author: KumarVivek

powerapps-docs/maker/canvas-apps/functions/function-showerror.md

@@ -1,13 +1,13 @@
 ---
-title: ShowError function | Microsoft Docs
-description: Reference information, including syntax and examples, for the ShowError function in Power Apps
+title: Notify function | Microsoft Docs
+description: Reference information, including syntax and examples, for the Notify function in Power Apps
 author: gregli-msft
 manager: kvivek
 ms.service: powerapps
 ms.topic: reference
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 06/05/2018
+ms.date: 02/28/2020
 ms.author: gregli
 search.audienceType: 
   - maker
@@ -18,7 +18,7 @@ search.app:
 Displays a banner message to the user.
 
 ## Description
-The **Notify** function displays a banner message to the user at the top of the screen, overlaying what is currently displayed.  
+The **Notify** function displays a banner message to the user at the top of the screen, overlaying what is currently displayed.  The notification will remain until the user dismisses it, another notification replaces it, or the timeout expires which defaults to 10 seconds.
 
 An appropriate color and icon are used depending on the type of the message.   The type is specified by the second argument to the function:
 
@@ -42,10 +42,11 @@ Power Apps can also send push notifications using an entirely different mechanis
 Note: This function was previously named **ShowError** when it could only display error messages.
 
 ## Syntax
-**Notify**( *Message*, [ *NotificationType* ] )
+**Notify**( *Message* [, *NotificationType* [ , *Timeout* ] ] )
 
 * *Message* – Required.  Message to display to the user.
-* *NotificationType* – Optional.  Type of the message to display from the table above.  The default is **NotificationType.Information**.  
+* *NotificationType* – Optional.  Type of the message to display from the table above.  The default is **NotificationType.Information**.  
+* *Timeout* – Optional.  Number of milliseconds to wait before automatically dismissing the notification.  The default is 10 seconds (or 10,000 milliseconds).  The notification will be displayed indefinitely with a *Timeout* of 0.
 
 ## Examples
 
@@ -59,7 +60,7 @@ Note: This function was previously named **ShowError** when it could only displa
 
 3. Click or press the button.  
 
-	Each time the button is clicked, the message **Hello, World** is displayed to the user as informational.
+	Each time the button is clicked, the message **Hello, World** is displayed to the user as informational.  It will dismiss automatically in 10 seconds (default timeout) if the user does not dismiss it or press the button again.
 
 	![In the authoring environment, showing Button.OnSelect calling Notify and displaying the resulting Hello, World message as a blue banner message for the user](media/function-showerror/hello-world.png)
 
@@ -69,26 +70,26 @@ Note: This function was previously named **ShowError** when it could only displa
 
 5. Click or press the button.
 
-	Now each time the button is clicked, the message **Hello, World** is displayed to the user as an error.
+	Now each time the button is clicked, the message **Hello, World** is displayed to the user as an error.  It will dismiss automatically in 10 seconds (default timeout) if the user does not dismiss it or press the button again.
 
 	![In the authoring environment, showing Button.OnSelect calling Notify and displaying the resulting Hello, World message as a red banner message for the user](media/function-showerror/hello-world-error.png)
 
 4. Change the type of message to indicate a warning.  Change the second argument in our formula:
 
-	**Notify( "Hello, World", NotificationType.Warning )**
+	**Notify( "Hello, World", NotificationType.Warning, 4000 )**
 
 5. Click or press the button.
 
-	Now each time the button is clicked, the message **Hello, World** is displayed to the user as a warning.
+	Now each time the button is clicked, the message **Hello, World** is displayed to the user as a warning.  It will dismiss automatically in 4 seconds (4,000 milliseconds) if the user does not dismiss it or press the button again.
 
 	![In the authoring environment, showing Button.OnSelect calling Notify and displaying the resulting Hello, World message as an orange banner message for the user](media/function-showerror/hello-world-warning.png)
 
 4. Change the type of message to indicate success.  Change the second argument in our formula:
 
-	**Notify( "Hello, World", NotificationType.Success )**
+	**Notify( "Hello, World", NotificationType.Success, 0 )**
 
 5. Click or press the button.
 
-	Now each time the button is clicked, the message **Hello, World** is displayed to the user as success.
+	Now each time the button is clicked, the message **Hello, World** is displayed to the user as success.  With a **0** timeout, the notification will only be dismissed by the user or by pressing the button again.
 
 	![In the authoring environment, showing Button.OnSelect calling Notify and displaying the resulting Hello, World message as a green banner message for the user](media/function-showerror/hello-world-success.png)