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);
}
}
}