GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GTK2::EX::FORMFACTORY::PROXY (3)

.ds Aq ’

NAME

Gtk2::Ex::FormFactory::Proxy - Proxy class for application objects

CONTENTS

SYNOPSIS



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

  Gtk2::Ex::FormFactory::Proxy->new (
    context              => Gtk2::Ex::FormFactory::Context,
    object               => Object instance or CODEREF,
    name                 => Name of this proxy,
    set_prefix           => Method prefix for write accessors,
    get_prefix           => Method prefix for read accessors,
    attr_accessors_href  => Hashref with accessor callbacks,
    attr_activity_href   => Hashref with activity callbacks,
    aggregated_by        => Fully qualified attribute of the parent,
    changes_attr_filter  => Regex for attributes which should not trigger
                            the objects changed status
  );



DESCRIPTION

This class implements a generic proxy mechanism for accessing application objects and their attributes. It defines attributes of the associated object are accessed. You never instantiate objects of this class by yourself; they’re created internally by Gtk2::Ex::FormFactory::Context when adding objects with the Context->add_object() method.

But you may use the proxy objects e.g. for updates which affect the application object and the GUI as well.

You can receive Proxy objects using the Gtk2::Ex::FormFactory::Context->get_proxy() method.

OBJECT HIERARCHY



  Gtk2::Ex::FormFactory::Proxy



ATTRIBUTES

Attributes are handled through the common get_ATTR(), set_ATTR() style accessors.
<B>contextB> = Gtk2::Ex::FormFactory::Context [mandatory] The Context this proxy belongs to.
<B>objectB> = Object instance | CODEREF The application object itself or a code reference, which returns the object instance.
<B>nameB> = SCALAR [mandatory] The Context wide unique name of this Proxy.
<B>set_prefixB> = SCALAR [optional] This is the method prefix for write accessors. Defaults to <B>set_B>.
<B>get_prefixB> = SCALAR [optional] This is the method prefix for read accessors. Defaults to <B>get_B>.
<B>attr_accessors_hrefB> = 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.

<B>attr_activity_hrefB> = 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.

<B>aggregated_byB> = ‘‘object.attr’’ [optional] Fully qualified attribute of the parent aggregating this object

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

<B>changes_attr_filterB> = REGEX [optional] Refer to Gtk2::Ex::FormFactory::Context->add_object for details.
<B>object_changedB> = 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.

METHODS

$app_object = $proxy-><B>get_objectB> () This returns the actual application object of this Proxy, either the statical assigned instance or a dynamicly retrieved instance.
$proxy-><B>set_objectB> ($object) Changes the application object instance in this Proxy. All dependend Widgets on the GUI are updated accordingly.
$app_object_attr_value = $proxy-><B>get_attrB> ($attr) Returns the application object’s attribute <B>B>$attr<B>B> 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-><B>set_attrB> ($attr => $value) Changes the application object’s attribute <B>B>$attr<B>B> to <B>B>$value<B>B> 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-><B>set_attrsB> ( { $attr => $value, ... } ) Changes a bunch of application object’s attributes, which is passed as a hash reference with <B>B>$attr<B> => B>$value<B>B> pairs and updates all dependend Widgets on the GUI accordingly.
$activity = $proxy-><B>get_attr_activityB> ($attr) Returns the current activity state of <B>B>$attr<B>B>.

AUTHORS



 Joern Reder <joern at zyn dot de>



COPYRIGHT AND LICENSE

Copyright 2004-2006 by Joern 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.

POD ERRORS

Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 470: Expected text after =item, not a bullet
Around line 476: Non-ASCII character seen before =encoding in ’Joern’. Assuming ISO8859-1
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 GTK2::EX::FORMFACTORY::PROXY (3) 2011-03-08

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.