$Id: Changes,v 1.18 2005/10/09 12:20:30 joern Exp $
Revision history and release notes for Gtk2::Ex::FormFactory:
0.58 Sun Oct 9, 2005, joern
Features:
- Gtk2::Ex::FormFactory::Container:
- new methods add_child_widget() and remove_child_widget()
to add/remove Widgets at runtime. E.g. you can extend
a notebook at runtime. Thanks to Kaare Rasmussen for
the suggestions.
- Buffered context objects: EXPERIMENTAL!
- if you specify 'buffered => 1' on Context->add_object
a buffering Proxy will be used for this object. That
means all attribute updates are buffered in the proxy
object instead of passing them through to the underlying
application object immediately. This way you can use
a synchronized FormFactory (with all the advantages
of automatically widget updating/activating stuff)
but the possibility to cancel all changes easily.
DialogButtons take care of this, so a "Cancel" button
is displayed in a FormFactory automatically if all
widgets in this factory are connected to a buffered
context object. Tested with simpler forms and works
for me, but this may not work in very complex forms
with a lot of internal dependencies, in particular if
your callbacks for activation checking and stuff don't
use the Context but access the original object directly,
which doesn't see any changes until the FormFactory
is applied!
- Gtk2::Ex::FormFactory::List: prevent unnecessary selection
updates not only for lists with the attr_select_column
property set
- Gtk2::Ex::FormFactory::Widget: active_cond callback now
gets the current application object passed.
Bugfixes:
- Gtk2::Ex::FormFactory::Context: active_depends property
didn't work with an array ref of attributes as stated
in the docs.
- Gtk2::Ex::FormFactory::Label: don't try to update from
an object atribute without any set.
0.57 Mon Aug 1, 2005, joern
Features:
- Gtk2::Ex::FormFactory::Window:
- on window close FormFactory->close is called automatically
if the Window is the 1st child of the FormFactory,
unless a closed_hook is set. Thanks to Kaare Rasmussen
for the hint.
- added 'quit_on_close' option, which quits the Gtk2
main loop as well in that case.
- Gtk2::Ex::FormFactory::List:
- scroll to selected row only on first show, to prevent
unneccessary scrolling.
- trigger selection dependency updates only when the
selection really changed (but only for Lists with
attr_select and attr_select_column set, because
otherwise a selection change can't be detected
safely)
- Documentation updates & fixes
Bugfixes:
- Gtk2::Ex::FormFactory::Layout: setting 'scrollbars'
for non-scrollable widgets didn't work
- Gtk2::Ex::FormFactory::Notebook: restore selected page
only if an object attribute is associated with the
Widget.
- Gtk2::Ex::FormFactory: POD typo fixed, thanks for the
report to Christian Marillat.
0.56 Wed Jul 20, 2005, joern
Features:
- Gtk2::Ex::FormFactory::Rules:
- added 'zero', 'non-zero', 'positive-zero-integer',
'negative-zero-integer', 'positive-zero-float',
'negative-zero-float' rules.
- added special 'or-empty' rule, refer to the man page
for details.
- added 'executable-command' rule.
- Gtk2::Ex::FormFactory::Context:
- added get_object_attr() helper method to retrieve
a specific application object attribute
- added 'accessor' option to the ->add_object() method
- Gtk2::Ex::FormFactory::Widget:
- added 'label_for' attribute, so auto-generated labels
can be bound to specific widgets as well.
- added 'avtive_cond' and 'active_depends' attributes
for direct activity control of the widget.
- added 'changed_hook_after'
- Gtk2::Ex::FormFactory::Popup:
- added 'items' attribute for static popup content
- Gtk2::Ex::FormFactory::Popup:
- default 'scale' to 1 of no other scaling options
are given, images would be invisible without this.
- Gtk2::Ex::FormFactory:
- added 'with_cancel' option to the ->open_confirm_window()
helper method
- Gtk2::Ex::FormFactory::CheckButtonGroup:
- dimensions can be configured through application
object attributes. Row and/or column labels may
be added.
- Gtk2::Ex::FormFactory::Label:
- added bold option.
- Gtk2::Ex::FormFactory::Layout:
- center button icons/labels.
Bugfixes:
- Gtk2::Ex::FormFactory::Combo: rule checking didn't work.
- Gtk2::Ex::FormFactory::Widget: rule checking in synchronized
FormFactories didn't work if no object attribute was
associated with the widget
- Gtk2::Ex::FormFactory::Table: due to missing outer whitespace
truncation parsing of some table layouts was messed up.
- Gtk2::Ex::FormFactory::List: dropped "selects_object"
feature introduced in 0.55 because this can be easily done
by defining attribute dependencies.
- Gtk2::Ex::FormFactory::Layout: setting a label group
didn't work for Label widgets, only for implicite labels
set through the Widget's label attribute.
- Gtk2::Ex::FormFactory::Loader: VSeparator setup was missing.
0.55 Mon Jul 11, 2005, joern
Features:
- Added a fully functional tutorial program (a simple music
database) which makes use of a lot of simple and advanced
Gtk2::Ex::FormFactory features. Not documented yet, but
nevertheless a good example to learn how Gtk2::Ex::FormFactory
works. More details in tutorial/README.
- On demand loading of widget modules saves some memory
- Gtk2::Ex::FormFactory::Context
- pass object aggregation information to define
dependencies between objects. This way all dependent
objects update automatically if their parent object
changes.
- defining constant attribute accessors is now possible,
e.g. for simple Combo presets not changing at runtime.
- new method set_object_attr() sets an specific application
object attribute and triggers corresponding GUI updates
- Gtk2::Ex::FormFactory::List
- new attribute "selects_object" for lists representing
an index of objects to select one of them. The
corresponding widgets are updated automatically
once the list selection changes.
- new attribute "visible" to control visibility of columns
- new attribute "no_header" to suppress list headers
- new attribute "attr_select_column" to have specific
column values instead of selected indices in the
"attr_select" attribute
- Gtk2::Ex::FormFactory::Label: declare an arbitrary Label
widget as the label of another widget, so this label is
deactivated/activated together with the assigned widget
automatically, even in complex layouts.
- Gtk2::Ex::FormFactory::Popup: additional data model,
two dimensional array to define ordered key/value pairs.
- Gtk2::Ex::FormFactory::Window: title may be controlled
by an application object.
- Gtk2::Ex::FormFactory::Widget: moved get_widget() from
Gtk2::Ex::FormFactory to here, so it's available for
all widgets, not only in a FormFactory.
Bugfixes:
- Removed ok_hook() from Gtk2::Ex::FormFactory::Intro
documentation, which was never implemented that way.
- Tooltips on combo entries didn't work.
0.54 Sun May 29, 2005, joern
Features:
- Gtk2::Ex::FormFactory::Table now handles arbitrary
alignments of widgets in the cells.
- Gtk2::Ex::FormFactory: new convenience method
change_mouse_cursor().
- Gtk2::Ex::FormFactory::Layout: no frames around
forms if placed on a notebook page
0.53 Sun Apr 10, 2005, joern
Features:
- $ff->get_widget($name) added.
- $context->remove_object($name) added.
- DialogButtons: control the set of buttons displayed.
Bugfixes:
- Timestamp: placeholders were mixed up, so the calculated
timestamp was nonsense for some values.
- Widget's changed_hook wasn't called at the appropriate
time for some widgets.
0.52 Sun Feb 06, 2005, joern
Bugfixes:
- Popup: didn't consider custom attribute activity conditions
in all cases.
- Container: apply_changes() didn't recurse correctly into
all children
Features:
- New widgets:
- CheckButtonGroup: a table of check buttons representing
a multiple selection of predefined values.
- GtkWidget: support arbitrary Gtk widgets which aren't worth
an own Gtk2::Ex::FormFactory module.
- TextView: a Gtk2::TextView
- Timestamp: Entries to enter correct timestamps down to minute
level, while calculating internally with unix timestamps.
- FormFactory: added parent_ff attribute
- FormFactory: added hide parameter to open() and show() method
- FormFactory: added open_confirm_window() method
- FormFactory: added get_image_path() method
- Button: added stock attribute
- Combo: added presets attribute
- DialogButtons: buttons may now be controlled with the object
attribute's value
- HBox/VBox: added no_frame attribute
- List: added update_selection_only attribute
- Proxy: get_attr/set_attr consider object.attr notation
accordingly and switch to the proxy of the correspondent
object for convenience.
- Table: warn if table layout string contains tab characters
- Widget: added gtk_properties_widget
- Widget: added label_markup attribute
- Widget: added 'type' option to show_error_message() and
error windows are now modal.
=> WARNING: incompatible API change!
- Window: added closed_hook attribute
0.51 Mon Dec 27, 2004, joern
Bugfixes:
- Container: on cleanup the internal content list was
set to undef instead to [].
Features:
- Context: attr_depends_href extended, so it accepts a list
reference of attributes an attribute depends on, not
only a single attribute.
- Image: with a constant scale of 1 all magic regarding scale
calculation is switched off
- Window: if a window has a FormFactory parent, FormFactory->close()
is called automatically when the window is destroyed.
- Container: Print a better error message if a child of a
container isn't defined.
Notes:
- Added GPL LICENSE file to the distribution
0.50 Sat Nov 20, 2004, joern
First public release. Refer to http://www.exit1.org/
for comprehensive online documentation.
WARNING: API is not stable yet and may change incompatibly.