win32_notif 0.15.2

Wrapper around Windows UWP XAML (WinRT) Notification api
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

#![cfg_attr(docsrs, feature(doc_cfg))]
#![allow(private_bounds)]

//! Win32 Notification
//!
//! This library implements UWP XML Toast Notification
//! This is a safe wrapper around the official WinRT apis
//!
//! # Example
//! ```rust
//! use win32_notif::{
//!  notification::{
//!   actions::ActionButton,
//!   group::{Group, SubGroup},
//!   visual::{
//!     text::{HintAlign, HintStyle},
//!     Text,
//!   },
//!   Scenario,
//!  },
//!  NotificationBuilder, ToastsNotifier,
//! };
//!
//! pub fn main() {
//!  let notifier = ToastsNotifier::new(Some("Microsoft.Windows.Explorer")).unwrap();
//!
//!  let notification = NotificationBuilder::new()
//!   .with_scenario(Scenario::IncomingCall)
//!   .with_use_button_style(true)
//!   .visual(
//!     Group::new()
//!      .with_subgroup(
//!       SubGroup::new().with_visual(Text::create(0, "Hello World").with_style(HintStyle::Title)),
//!     )
//!     .with_subgroup(
//!       SubGroup::new().with_visual(
//!         Text::create(0, "Hello World x2")
//!           .with_style(HintStyle::Header)
//!           .with_align(HintAlign::Right),
//!       ),
//!     ),
//!   )
//!   .action(
//!     ActionButton::create("Answer")
//!     .with_tooltip("Answer")
//!     .with_id("answer"),
//!   )
//!   .build(1, &notifier, "a", "ahq")
//!   .expect("Error");
//!
//!   notification.show().expect("Not Sent");
//! }
//! ```

#[macro_export]
///
/// Creates a reference to a value in notification
///
/// # Example
/// ```rust
/// use win32_notif::string;
///
/// fn main() {
///     let value = string!("status");
/// }
/// ```
macro_rules! string {
    ($($x:tt)*) => {
        format!($($x)*)
    };
}

mod structs;

use std::{error::Error, fmt::Display};

pub use structs::*;

#[cfg(feature = "registration")]
pub mod registration;

macro_rules! from_impl {
  ($x:ty => $y:ident) => {
    impl From<$x> for NotifError {
      fn from(value: $x) -> Self {
        Self::$y(value)
      }
    }
  };
}

#[derive(Debug)]
pub enum NotifError {
  WindowsCore(windows::core::Error),
  DurationTooLong,
  AUMIDRequired,
  UnknownAndImpossible,
  EmptyAUMID,
}

impl Display for NotifError {
  fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
    write!(f, "{:?}", self)
  }
}

impl Error for NotifError {}

from_impl!(windows::core::Error => WindowsCore);