NotificationProvider Xojo Plugin |

# DesktopNotificationProvider Control

NotificationProvider is a control to display in application notifications.
Not all notifications are worthy of a system notification, like for example when validating fields and other things.
The control supports

- Information notifications.
- Error notifications.
- Warning notifications.
- Success notifications.
- Timed or manual dismiss.
- Bottom right corner placement or bottom full window width placement.
- Color scheme customization.
- Context aware notifications with automatic removal of previous notify from same context.
- Smooth operating system animated fade out when used on macOS systems.

DesktopControl
DesktopNotificationProvider

control DesktopNotificationProvider

#### Properties

ErrorColor | Background color for Error notifications.
ErrorImage | Sets custom image for Error notifications.
ErrorLightForeground | If set to true then foreground of error notification will be in light color.
Handle (Inherited) | Returns a handle to the control.
Index (Inherited) | If the control is used in a control set, this specifies the control's index in the set.
InformationColor | Background color for information notifications.
InformationImage | Sets custom image for Information notifications.
InformationLightForeground | If set to true then foreground of information notification will be in light color.
LastNotificationId | Returns id of last notification.
MacOSAnimate | If set to true then notifications will use macOS native animations when closing manually by click or when closing by timer.
NotificationWidth | Width of notifications or zero if wanting it full window in width.
Placement | Sets or gets placement location of the notifications.
SuccessColor | Background color for Success notifications.
SuccessImage | Sets custom image for Success notifications.
SuccessLightForeground | If set to true then foreground of success notification will be in light color.
WarningColor | Background color for warning notifications.
WarningImage | Sets custom image for Warning notifications.
WarningLightForeground | If set to true then foreground of warning notification will be in light color.
Window (Inherited) | The control's parent window.

#### Methods

Clear | Clears all notifications.
Close (Inherited) | Closes a control.
Notify | Posts notification that has message.
Notify | Posts notification that has title and message.
Notify | Posts notification that has title, message and reference object.
Remove | Removes notification by id.
Remove | Removes notification by reference object.
TimedNotify | Posts timed notification that has message.
TimedNotify | Posts timed notification that has title, message and reference object.
TimedNotify | Posts timed notification that has title and message.

#### Events

Action | Fires when the body of the notification is clicked.
Closing | The control is about to close.
NotificationClosed | This event is fired when a notification closes, giving indication if it was closed by user or not.
Opening | The control is about to be loaded. Use this event to initialize a control.

#### Enumerations

NotifyType | Enum representing Notification types.
PlacementValues | Placement values for the Placement property.

#### Constants

Version = 1.1 |

####
Note that if notifications fill the window then the oldest ones will be automatically dismissed to make space for new ones.

Notifications belong to the host Window. So if NotificationProvider is put in container control then its the host window that will end up displaying the notifications.

#### Supported Platforms:

- macOS Intel 64 bit
- macOS Apple Silicon
- Windows 32 bit
- Windows 64 bit
- Windows ARM 64 bit
- Linux 32 bit
- Linux 64 bit
- Linux ARM 32 bit
- Linux ARM 64 bit