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

// Take a look at the license at the top of the repository in the LICENSE file.

use crate::prelude::*;
use crate::rt;
use crate::Application;
use gio::ApplicationFlags;
use glib::signal::SignalHandlerId;
use glib::translate::*;

use std::cell::RefCell;
use std::rc::Rc;

impl Application {
    /// Creates a new [`Application`][crate::Application] instance.
    ///
    /// When using [`Application`][crate::Application], it is not necessary to call [`glib::`Value::from_type()``][crate::glib::`Value::from_type()`]
    /// manually. It is called as soon as the application gets registered as
    /// the primary instance.
    ///
    /// Concretely, [`glib::`Value::from_type()``][crate::glib::`Value::from_type()`] is called in the default handler for the
    /// `GApplication::startup` signal. Therefore, [`Application`][crate::Application] subclasses should
    /// always chain up in their `GApplication::startup` handler before using any GTK
    /// API.
    ///
    /// Note that commandline arguments are not passed to [`glib::`Value::from_type()``][crate::glib::`Value::from_type()`].
    ///
    /// If `application_id` is not [`None`], then it must be valid. See
    /// `[`gio::Application::id_is_valid()`][crate::gio::Application::id_is_valid()]`.
    ///
    /// If no application ID is given then some features (most notably application
    /// uniqueness) will be disabled.
    /// ## `application_id`
    /// The application ID
    /// ## `flags`
    /// the application flags
    ///
    /// # Returns
    ///
    /// a new [`Application`][crate::Application] instance
    #[doc(alias = "gtk_application_new")]
    pub fn new(application_id: Option<&str>, flags: ApplicationFlags) -> Self {
        skip_assert_initialized!();
        let app: Application = unsafe {
            from_glib_full(ffi::gtk_application_new(
                application_id.to_glib_none().0,
                flags.into_glib(),
            ))
        };
        Self::register_startup_hook(&app);
        app
    }

    pub(crate) fn register_startup_hook(app: &Application) {
        skip_assert_initialized!();
        let signalid: Rc<RefCell<Option<SignalHandlerId>>> = Rc::new(RefCell::new(None));
        {
            let signalid_ = signalid.clone();

            let id = app.connect_startup(move |app| {
                app.disconnect(
                    signalid_
                        .borrow_mut()
                        .take()
                        .expect("Signal ID went missing"),
                );
                unsafe { rt::set_initialized() }
            });
            *signalid.borrow_mut() = Some(id);
        }
    }
}