Notifications.Wpf.Core

Toast notifications for WPF apps based on .NET 8

This is a fork of

Installation:

Install-Package Notifications.Wpf.Core

Usage:

Notification over the taskbar:

var notificationManager = new NotificationManager();

var notificationContent = new NotificationContent
{
    Title = "Sample notification",
    Message = "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
    Type = NotificationType.Information
};

await notificationManager.ShowAsync(notificationContent);

You can also alter this position by passing the desired position as an argument

var notificationManager = new NotificationManager(NotificationPosition.TopRight);

Notification inside application window:

• Adding namespace:

xmlns:notifications="clr-namespace:Notifications.Wpf.Core.Controls;assembly=Notifications.Wpf.Core"

• Adding new NotificationArea:

<notifications:NotificationArea  
     MaxItems="3"
     x:Name="WindowArea"
     Position="TopLeft" />

It is also possible to add the area name with a Binding. But as binding to the Name property directly does not work, we offer you the BindableName property instead.

<notifications:NotificationArea
    BindableName="{Binding NotificationAreaIdentifier}"
    MaxItems="3"
    Position="TopRight" />

• Displaying notification:

var notificationContent = new NotificationContent
{
    Title = "Notification",
    Message = "Notification in window!"
};

await notificationManager.ShowAsync(notificationContent, areaName: "WindowArea");

Simple text with OnClick & OnClose actions:

await notificationManager.ShowAsync("String notification",
    onClick: () => Console.WriteLine("Click"),
    onClose: () => Console.WriteLine("Closed!")
);

Notifications with identifiers

Sometimes it comes in handy if you can close specific notifications via code. To do that you have the possibility to specify an identifier in the form of a Guid for a notification.

var identifier = Guid.NewGuid();

await notificationManager.ShowAsync(identifier,
        "I'm here to stay",
        expirationTime: TimeSpan.MaxValue,
        onClose: (id) =>
        {
            NotifySomeoneAboutClose(id);
        });

await notificationManager.CloseAsync(identifier);

Adjust style of notificiations

You do not like the default styles of the notifications? No problem. You can use your own custom styles. Take a look the sample project Notifications.Wpf.Core.Sample where this is demonstrated. Basically you have to create a custom NotificationTemplateSelector in which you specify which templates should be used.

Caliburn.Micro MVVM support:

• App.xaml:

xmlns:controls="clr-namespace:Notifications.Wpf.Core.Controls;assembly=Notifications.Wpf.Core"

<Application.Resources>
    [...]
    <Style TargetType="controls:Notification">
        <Style.Resources>
            <DataTemplate DataType="{x:Type micro:PropertyChangedBase}">
                <ContentControl cal:View.Model="{Binding}"/>
            </DataTemplate>
        </Style.Resources>
    </Style>
</Application.Resources>

• NotificationViewModel:

The used view model must implement INotificationViewModel

public class NotificationViewModel : PropertyChangedBase, INotificationViewModel
{
    private readonly INotificationManager _manager;

    private Guid? _notificationIdentifier;

    public string? Title { get; set; }
    public string? Message { get; set; }

    public NotificationViewModel(INotificationManager manager)
    {
        _manager = manager;
    }
        
    // This method is called when the notification with this view/view model is
    // shown. It can be used to receive the identifier of the notification
    public void SetNotificationIdentifier(Guid identifier)
    {
        _notificationIdentifier = identifier;
    }

    public async Task Ok()
    {
        await Task.Delay(500);
        await _manager.ShowAsync(new NotificationContent { Title = "Success!", 
                  Message = "Ok button was clicked.", Type = NotificationType.Success });
    }

    public async Task Cancel()
    {
        await Task.Delay(500);
        await _manager.ShowAsync(new NotificationContent { Title = "Error!", 
                  Message = "Cancel button was clicked!", Type = NotificationType.Error });
    }
}

• ShellViewModel:

var content = new NotificationViewModel(_manager)
{
    Title = "Custom notification.",
    Message = "Click on buttons!"
};

await _manager.ShowAsync(content, expirationTime: TimeSpan.FromSeconds(30));

• NotificationView:

<DockPanel LastChildFill="False">
    <!--Using CloseOnClick attached property to close notification when button is pressed-->
    <Button x:Name="Ok" Content="Ok" DockPanel.Dock="Right" controls:Notification.CloseOnClick="True"/>
    <Button x:Name="Cancel" Content="Cancel" DockPanel.Dock="Right" Margin="0,0,8,0" 
           controls:Notification.CloseOnClick="True"/>
</DockPanel>

• Result: