rust-macios 0.4.2

Apple Frameworks for Rust
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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147

use objc::{msg_send, sel, sel_impl};
use rust_macios_objective_c_runtime_proc_macros::interface_impl;

use crate::{
    foundation::{NSArray, NSString},
    object,
    objective_c_runtime::{
        nil,
        traits::{FromId, PNSObject},
    },
};

use super::un_notification_action::UNNotificationAction;

object! {
    /// A type of notification your app supports and the custom actions that the system displays.
    unsafe pub struct UNNotificationCategory;
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord)]
#[repr(u64)]
pub enum UNNotificationCategoryOptions {
    None = 0,
    CustomDismissAction = (1 << 0),
    AllowInCarPlay = (1 << 1),
    HiddenPreviewsShowTitle = (1 << 2),
    HiddenPreviewsShowSubtitle = (1 << 3),
    #[deprecated]
    AllowAnnouncement = (1 << 4),
}

#[interface_impl(NSObject)]
impl UNNotificationCategory {
    /* Essentials
     */

    /// Creates a category object containing the specified actions and options.
    #[method]
    pub fn category_with_identifier_actions_intent_identifiers_options(
        identifier: NSString,
        actions: NSArray<UNNotificationAction>,
        intent_identifiers: NSArray<NSString>,
        options: &[UNNotificationCategoryOptions],
    ) -> Self
    where
        Self: Sized + FromId,
    {
        let options = options
            .iter()
            .fold(0u64, |init, option| init | *option as u64);

        unsafe {
            Self::from_id(
                msg_send![Self::m_class(), categoryWithIdentifier: identifier actions: actions intentIdentifiers: intent_identifiers options: options],
            )
        }
    }

    /// Creates a category object containing the specified actions, options, and placeholder text used when previews aren’t shown.
    #[method]
    pub fn category_with_identifier_actions_intent_identifiers_hidden_previews_body_placeholder_options(
        identifier: NSString,
        actions: NSArray<UNNotificationAction>,
        intent_identifiers: NSArray<NSString>,
        hidden_previews_body_placeholder: Option<NSString>,
        options: &[UNNotificationCategoryOptions],
    ) -> Self
    where
        Self: Sized + FromId,
    {
        let hidden_previews_body_placeholder = match hidden_previews_body_placeholder {
            Some(value) => value.m_self(),
            None => nil,
        };

        let options = options
            .iter()
            .fold(0u64, |init, option| init | *option as u64);

        unsafe {
            Self::from_id(
                msg_send![Self::m_class(), categoryWithIdentifier: identifier actions: actions intentIdentifiers: intent_identifiers hiddenPreviewsBodyPlaceholder: hidden_previews_body_placeholder options: options],
            )
        }
    }

    pub fn categoryWithIdentifier_actions_intentIdentifiers_hiddenPreviewsBodyPlaceholder_categorySummaryFormat_options(
        identifier: NSString,
        actions: NSArray<UNNotificationAction>,
        intent_identifiers: NSArray<NSString>,
        hidden_previews_body_placeholder: NSString,
        category_summary_format: NSString,
        options: &[UNNotificationCategoryOptions],
    ) -> Self
    where
        Self: Sized + FromId,
    {
        let options = options
            .iter()
            .fold(0u64, |init, option| init | *option as u64);

        unsafe {
            Self::from_id(
                msg_send![Self::m_class(), categoryWithIdentifier: identifier actions: actions intentIdentifiers: intent_identifiers hiddenPreviewsBodyPlaceholder: hidden_previews_body_placeholder categorySummaryFormat: categorySummaryFormat options: options],
            )
        }
    }

    /* Getting the Information
     */

    /// The unique string assigned to the category.
    #[property]
    pub fn identifier(&self) -> NSString {
        unsafe { NSString::from_id(msg_send![self.m_self(), identifier]) }
    }

    /// The actions to display when the system delivers notifications of this type.
    #[property]
    pub fn actions(&self) -> NSArray<UNNotificationAction> {
        unsafe { NSArray::from_id(msg_send![self.m_self(), actions]) }
    }

    /// The intents related to notifications of this category.
    #[property]
    pub fn intent_identifiers(&self) -> NSArray<NSString> {
        unsafe { NSArray::from_id(msg_send![self.m_self(), intentIdentifiers]) }
    }

    /// The placeholder text to display when the system disables notification previews for the app.
    #[property]
    pub fn hidden_previews_body_placeholder(&self) -> NSString {
        unsafe { NSString::from_id(msg_send![self.m_self(), hiddenPreviewsBodyPlaceholder]) }
    }

    /// A format string for the summary description used when the system groups the category’s notifications.
    #[property]
    pub fn category_summary_format(&self) -> NSString {
        unsafe { NSString::from_id(msg_send![self.m_self(), categorySummaryFormat]) }
    }

    /// Options for how to handle notifications of this type.
    #[property]
    pub fn options(&self) -> UNNotificationCategoryOptions {
        unsafe { msg_send![self.m_self(), options] }
    }
}