Gtk2::Ex::FormFactory::Intro

Gtk2::Ex::FormFactory::Widget
+-Gtk2::Ex::FormFactory::Container
|  +-Gtk2::Ex::FormFactory
|  +-Gtk2::Ex::FormFactory::Expander
|  +-Gtk2::Ex::FormFactory::Form
|  +-Gtk2::Ex::FormFactory::HBox
|  +-Gtk2::Ex::FormFactory::Notebook
|  +-Gtk2::Ex::FormFactory::Table
|  +-Gtk2::Ex::FormFactory::VBox
|  +-Gtk2::Ex::FormFactory::Window
+-Gtk2::Ex::FormFactory::Button
+-Gtk2::Ex::FormFactory::CheckButton
+-Gtk2::Ex::FormFactory::CheckButtonGroup
+-Gtk2::Ex::FormFactory::Combo
+-Gtk2::Ex::FormFactory::DialogButtons
+-Gtk2::Ex::FormFactory::Entry
+-Gtk2::Ex::FormFactory::Expander
+-Gtk2::Ex::FormFactory::ExecFlow
+-Gtk2::Ex::FormFactory::GtkWidget
+-Gtk2::Ex::FormFactory::HPaned
+-Gtk2::Ex::FormFactory::HSeparator
+-Gtk2::Ex::FormFactory::Image
+-Gtk2::Ex::FormFactory::Label
+-Gtk2::Ex::FormFactory::List
+-Gtk2::Ex::FormFactory::Menu
+-Gtk2::Ex::FormFactory::Popup
+-Gtk2::Ex::FormFactory::ProgressBar
+-Gtk2::Ex::FormFactory::RadioButton
+-Gtk2::Ex::FormFactory::TextView
+-Gtk2::Ex::FormFactory::Timestamp
+-Gtk2::Ex::FormFactory::ToggleButton
+-Gtk2::Ex::FormFactory::VPaned
+-Gtk2::Ex::FormFactory::VSeparator
+-Gtk2::Ex::FormFactory::YesNo

Gtk2::Ex::FormFactory::Layout
Gtk2::Ex::FormFactory::Rules
Gtk2::Ex::FormFactory::Context
Gtk2::Ex::FormFactory::Proxy
+-Gtk2::Ex::FormFactory::ProxyBuffered

NAME

Gtk2::Ex::FormFactory::ProxyBuffered - Buffering object proxy

SYNOPSIS

  #-- Proxies are always created through
  #-- Gtk2::Ex::FormFactory::Context, never
  #-- directly by the application.

  Gtk2::Ex::FormFactory::ProxyBuffered->new (
    Gtk2::Ex::FormFactory::Proxy attributes
  );

DESCRIPTION

This class is derived from Gtk2::Ex::FormFactory::Proxy and buffers all changes made to object through the proxy. For details about buffering please refer to the chapter BUFFERED CONTEXT OBJECTS in Gtk2::Ex::FormFactory::Context.

OBJECT HIERARCHY

  Gtk2::Ex::FormFactory::Proxy
  +-- Gtk2::Ex::FormFactory::ProxyBuffered

ATTRIBUTES

This module has no additional attributes over those derived from Gtk2::Ex::FormFactory::Proxy.

ATTRIBUTES: Gtk2::Ex::FormFactory::Proxy

Attributes are handled through the common get_ATTR(), set_ATTR() style accessors.

context = Gtk2::Ex::FormFactory::Context [mandatory]

The Context this proxy belongs to.

object = Object instance | CODEREF

The application object itself or a code reference, which returns the object instance.

name = SCALAR [mandatory]

The Context wide unique name of this Proxy.

set_prefix = SCALAR [optional]

This is the method prefix for write accessors. Defaults to set_.

get_prefix = SCALAR [optional]

This is the method prefix for read accessors. Defaults to get_.

attr_accessors_href = HASHREF [optional]

With this hash you can override specific accessors with a code reference, which is called instead of the object's own accessor.

Refer to Gtk2::Ex::FormFactory::Context->add_object for details.

attr_activity_href = HASHREF [optional]

This hash defines callbacks for attributes which return the activity state of the corresonding attribute.

Refer to Gtk2::Ex::FormFactory::Context->add_object for details.

aggregated_by = "object.attr" [optional]

Fully qualified attribute of the parent aggregating this object

Refer to Gtk2::Ex::FormFactory::Context->add_object for details.

changes_attr_filter = REGEX [optional]

Refer to Gtk2::Ex::FormFactory::Context->add_object for details.

object_changed = BOOLEAN

This flag indicates whether the object represented by this Proxy was changed. You may set this attribute to reset the object's changed state.

Click header to unfold this chapter

METHODS

$proxy->commit_buffer ()

Commits all changes buffered in the $proxy object to the corresponding application object.

$proxy->discard_buffer ()

Discards all buffered changes.

For more methods refer to Gtk2::Ex::FormFactory::Proxy.

METHODS: Gtk2::Ex::FormFactory::Proxy

$app_object = $proxy->get_object ()

This returns the actual application object of this Proxy, either the statical assigned instance or a dynamicly retrieved instance.

$proxy->set_object ($object)

Changes the application object instance in this Proxy. All dependend Widgets on the GUI are updated accordingly.

$app_object_attr_value = $proxy->get_attr ($attr)

Returns the application object's attribute $attr of this Proxy.

If $attr has the form "object.attr" the attribute of the correspondent object is retreived, instead of the object associated with this proxy.

$proxy->set_attr ($attr => $value)

Changes the application object's attribute $attr to $value and updates all dependend Widgets on the GUI accordingly.

If $attr has the form "object.attr" the correspondent object will be updated, instead of the object associated with this proxy.

$proxy->set_attrs ( { $attr => $value, ... } )

Changes a bunch of application object's attributes, which is passed as a hash reference with $attr => $value pairs and updates all dependend Widgets on the GUI accordingly.

$activity = $proxy->get_attr_activity ($attr)

Returns the current activity state of $attr.

Click header to unfold this chapter

AUTHORS

 Jörn Reder <joern at zyn dot de>

COPYRIGHT AND LICENSE

Copyright 2004-2006 by Jörn Reder.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details.

You should have received a copy of the GNU Library General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307 USA.