Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[0.3.0] - 2020-07-05

vgtk now uses gtk version 0.9, along with the matching versions of its dependencies. This will affect your code, as many method names have changed, most notably the names of specialised widget constructors. You should consult the gtk-rs blog for details on the changes.

New child properties action_widget_start and action_widget_end for Notebook let you add children as action widgets to notebooks. (#47)
There's a new function vgtk::run_dialog_props() for launching a dialog component with a given set of properties, where vgtk::run_dialog() would use Default::default() to construct a properties object for you. (#43)
A new child property custom_title on HeaderBar lets you set a widget as a custom title, emulating the set_custom_title() method. (#38)

A new function vgtk::start() has been added to initialise an Application component without starting the GTK event loop. It has the added benefit of returning a Scope which you can use to communicate with your component from async jobs other than the standard UpdateAction::defer() mechanism.
UpdateAction now has a From implementation for Future<Output = Component::Message>, allowing you to return async {...}.into() from your update function instead of the slightly more verbose UpdateAction::defer(async {...}).

Callbacks can now have empty values (constructed by Default::default()), obviating the need to wrap them in Option<>. The coercion for Option<Callback<>> for functions has been replaced with one for just Callback<> as a consequence, which means you'll have to update your subcomponents: just replace any Option<Callback<A>> with Callback<A> in your properties, and remove the Some check on self.on_my_callback.send()—you can just call send() on an empty callback directly now, and it will quietly do nothing. If you'd rather not needlessly construct the value for send() when a callback is empty, you can use Callback::is_empty() as a predicate instead of the Some check.

A macro gtk_if! has been added, to automate the common case of conditionally inserting a child widget.
Subcomponents will now accept signal handler syntax, rendering on signal=|| {} into on_signal=|| {}, for consistency.
Properties which want an Option<&A> will now accept an Option<A>. (#33)

Initial release.