---

WinToast

WinToast is a lightly library written in C++ which brings a complete integration of the modern toast notifications of Windows 8 & Windows 10.

Toast notifications allows your app to inform the users about relevant information and timely events that they should see and take action upon inside your app, such as a new instant message, a new friend request, breaking news, or a calendar event.

WinToast integrates all standard templates availables in the ToastTemplateType enumeration.

Template	Description	Example
ImageAndText01	A large image and a single string wrapped across three lines of text.
ImageAndText02	A large image, one string of bold text on the first line, one string of regular text wrapped across the second and third lines.
ImageAndText03	A large image, one string of bold text wrapped across the first two lines, one string of regular text on the third line.
ImageAndText04	A large image, one string of bold text on the first line, one string of regular text on the second line, one string of regular text on the third line.
Text01	Single string wrapped across three lines of text.
Text02	One string of bold text on the first line, one string of regular text wrapped across the second and third lines.
Text03	One string of bold text wrapped across the first two lines, one string of regular text on the third line.
Text04	One string of bold text on the first line, one string of regular text on the second line, one string of regular text on the third line.

Usage

Import the header file wintoastlib.h to your project. Check if the current OS supports the library:

using namespace WinToastLib;
....
if (!WinToast::isCompatible()) {
    std::wcout << L"Error, your system in not supported!" << std::endl;
}

For an easy usage, just use the available instance:

using namespace WinToastLib;
....
WinToast::instance()->setAppName(L"WinToastExample");
WinToast::instance()->setAppUserModelId(
	WinToast::configureAUMI(L"mohabouje", L"wintoast", L"wintoastexample", L"20161006"));

Check if the WinToas is initialized with succes & is compatible with your current OS:

    if (!WinToast::instance()->initialize()) {
        std::wcout << L"Error, could not initialize the lib!" << std::endl;
    }

Now, implement your own handler subclassing the interface IWinToastHandler:

class WinToastHandlerExample : public IWinToastHandler {
 public:
	WinToastHandlerExample(); 
	// Public interfaces
	void toastActivated() const;
	void toastDismissed(WinToastDismissalReason state) const;
	void toastFailed() const;
 };

Now, to notify any event just create a new template and launch it:

WinToastHandlerExample* handler = new WinToastHandlerExample;
WinToastTemplate templ = WinToastTemplate(WinToastTemplate::ImageAndText02);
templ.setImagePath(L"C:/example.png");
templ.setTextField(L"title", WinToastTemplate::FirstLine);
templ.setTextField(L"subtitle", WinToastTemplate::SecondLine);

if (!WinToast::instance()->showToast(templ, handler)) {
    std::wcout << L"Error: Could not launch your toast notification!" << std::endl;
}

That's all my folks =)