Native Windows GUI

Native Windows GUI (NWG) is a thin GUI toolkit built over the Microsoft Windows WINAPI for rust. The current version is 0.2.0 BETA 1. The library is close to be production ready, but still lacks some important features and some useful controls and resources.

NWG uses retep998/winapi-rs and works on all rust channels and most rust versions. NWG was tested on Windows 8.1 and Windows 10 using the MSVC ABI build but any version of Microsoft Windows supported by Rust is supposed to be supported by NWG (vista and up).

Why NWG?

Is native-windows-gui the gui framework you are looking for? It is ...

For those who wants to develop on Windows and want the smallest executable and memory footprint possible.
For those who LOVE hashmap. The UI are represented as hashmap-like objects (called the UI)
For those who don't like dependencies. NWG only requires some winapi-rs crates and do not depends on external "executable" code
For those who want a canvas to draw pretty things, NWG has a very powerful (and light) canvas build over Direct2D
For those who don't like to manage widgets (aka controls, aka stuff the user clicks on), NWG is for you. The UI manages the controls and the resources for you.
For those who like documentation, NWG has one ( and I think it's pretty good ). Oh and its API is avaible online too: https://gabdube.github.io/native-windows-gui/
For those who want a light and simple API, NWG might be for you (ok, I'm totally biased on this one, external opinion required)

And it isn't...

For those who want portability across system. Maybe it will work with WINE though...
For those who has to create controls on the fly. Each UI element requires a unique ID, which make this kind of UI harder to create
For those who want to deploy a production ready application as soon as possible. The first stable version will take some time to come out.
For those who want a safe api to create custom control, nwg is not there YET...
For those who want a UI to track a killers API address, Visual Basic is better (source: CSI)

Beta notes

The beta release is a rewrite, so the ALPHA code won't work anymore. Most of the concepts remain though.

NWG now supports macro templates in order to make interface definition much less painful.

Installation

To use NWG in your project add it to cargo.toml:

toml [dependencies] native-windows-gui = "0.2.0"

And then, in main.rs or lib.rs :

rust extern crate native_windows_gui as nwg;

Documentation

NWG has a complete documentation available here: https://gabdube.github.io/native-windows-gui/

The documentation alone should be enough to introduce to the basics of NWG.

(btw) If English is your first language (it's not mine), it would be super kind to give me feedback about quality of the docs.

Example

Having cargo installed and in your PATH, execute the following code to run the included example:

bash git clone git@github.com:gabdube/native-windows-gui.git cd native-windows-gui cargo run --example showcase cargo run --example canvas cargo run --example templating

A GUI