cacao 0.3.2

Rust bindings for AppKit (macOS/Airyx/GNUStep, beta) and UIKit (iOS/tvOS, alpha).
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

//! Handles the Objective-C functionality for the Toolbar module.

use std::sync::Once;

use objc::declare::ClassDecl;
use objc::runtime::{Class, Object, Sel};
use objc::{class, msg_send, sel, sel_impl};

use crate::appkit::toolbar::{ToolbarDelegate, TOOLBAR_PTR};
use crate::foundation::{id, load_or_register_class, NSArray, NSString, BOOL};
use crate::utils::load;

/// Retrieves and passes the allowed item identifiers for this toolbar.
extern "C" fn allowed_item_identifiers<T: ToolbarDelegate>(this: &Object, _: Sel, _: id) -> id {
    let toolbar = load::<T>(this, TOOLBAR_PTR);

    let identifiers: NSArray = toolbar
        .allowed_item_identifiers()
        .iter()
        .map(|identifier| identifier.to_nsstring())
        .collect::<Vec<id>>()
        .into();

    identifiers.into()
}

/// Retrieves and passes the default item identifiers for this toolbar.
extern "C" fn default_item_identifiers<T: ToolbarDelegate>(this: &Object, _: Sel, _: id) -> id {
    let toolbar = load::<T>(this, TOOLBAR_PTR);

    let identifiers: NSArray = toolbar
        .default_item_identifiers()
        .iter()
        .map(|identifier| identifier.to_nsstring())
        .collect::<Vec<id>>()
        .into();

    identifiers.into()
}

/// Retrieves and passes the default item identifiers for this toolbar.
extern "C" fn selectable_item_identifiers<T: ToolbarDelegate>(this: &Object, _: Sel, _: id) -> id {
    let toolbar = load::<T>(this, TOOLBAR_PTR);

    let identifiers: NSArray = toolbar
        .selectable_item_identifiers()
        .iter()
        .map(|identifier| identifier.to_nsstring())
        .collect::<Vec<id>>()
        .into();

    identifiers.into()
}

/// Loads the controller, grabs whatever item is for this identifier, and returns what the
/// Objective-C runtime needs.
extern "C" fn item_for_identifier<T: ToolbarDelegate>(this: &Object, _: Sel, _: id, identifier: id, _: BOOL) -> id {
    let toolbar = load::<T>(this, TOOLBAR_PTR);
    let identifier = NSString::from_retained(identifier);

    let item = toolbar.item_for(identifier.to_str());
    unsafe { msg_send![&*item.objc, self] }
    //&mut *item.objc
}

/// Registers a `NSToolbar` subclass, and configures it to hold some ivars for various things we need
/// to store. We use it as our delegate as well, just to cut down on moving pieces.
pub(crate) fn register_toolbar_class<T: ToolbarDelegate>(instance: &T) -> *const Class {
    load_or_register_class("NSObject", instance.subclass_name(), |decl| unsafe {
        // For callbacks
        decl.add_ivar::<usize>(TOOLBAR_PTR);

        // Add callback methods
        decl.add_method(
            sel!(toolbarAllowedItemIdentifiers:),
            allowed_item_identifiers::<T> as extern "C" fn(&Object, _, _) -> id
        );
        decl.add_method(
            sel!(toolbarDefaultItemIdentifiers:),
            default_item_identifiers::<T> as extern "C" fn(&Object, _, _) -> id
        );
        decl.add_method(
            sel!(toolbarSelectableItemIdentifiers:),
            selectable_item_identifiers::<T> as extern "C" fn(&Object, _, _) -> id
        );
        decl.add_method(
            sel!(toolbar:itemForItemIdentifier:willBeInsertedIntoToolbar:),
            item_for_identifier::<T> as extern "C" fn(&Object, _, _, _, _) -> id
        );
    })
}