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

//! `iui`, the `i`mproved `u`ser `i`nterface crate, provides Rust bindings to `libui`, a wrapper library for native(ish) GUI libraries:
//!
//! - Win32API on Windows
//! - Cocoa on Mac OS X
//! - GTK+ on Linux and elsewhere
//!
//! This library exposes a Rusty procedural interface to the
//! "Least Common Denominator" of GUI widgets. They are all available on all supported platforms, though some functionality may not
//! perform precisely the same on all platforms. These inconsistencies are marked.
//!
//! To use the library, add the following to your `Cargo.toml`:
//! 
//! ```toml
//! "iui" = "0.3"
//! ```
//!
//! Most of the functionality of the crate is exposed via the [UI](struct.UI.html) RAII guard, which handles all initialization and cleanup for the
//! underlying library.
//! 
//! After initialization, all the functionality used for creating actual UIs is in the [`controls`](controls/index.html) module. 
//! 
//! Fine-grained control of the event loop is avilable via the [`EventLoop`](struct.EventLoop.html) struct.
//! Be aware the Cocoa (GUI toolkit on Mac OS) requires that the _first thread spawned_ controls
//! the UI, so do _not_ spin off your UI interactions into an alternative thread. You're likely to
//! have problems on Mac OS.
//!
//! For code examples, see the [examples](https://github.com/LeoTindall/libui-rs/blob/master/iui/examples/) 
//! directory.

#[macro_use]
extern crate failure;
extern crate libc;
extern crate ui_sys;

pub mod controls;
pub mod draw;
mod error;
mod ffi_tools;
pub mod menus;
mod ui;

pub use error::UIError;
pub use ui::{EventLoop, UI};

/// Common imports are packaged into this module. It's meant to be glob-imported: `use iui::prelude::*`.
pub mod prelude {
    pub use controls::LayoutStrategy;
    pub use controls::{NumericEntry, TextEntry};
    pub use controls::{Window, WindowType};
    pub use ui::UI;
}