gnome2::gconf::value(3pm) [debian man page]

Gnome2::GConf::Value(3pm)				User Contributed Perl Documentation				 Gnome2::GConf::Value(3pm)

NAME

       Gnome2::GConf::Value -  Opaque datatype for generic values

SYNOPSIS

	 $client = Gnome2::GConf::Client->get_default;
	 $client->set($config_key,
	     {
	       type  => 'string',
	       value => 'Hello, World',
	     });
	 print "The Meaning of Life." if ($client->get($another_key)->{value} == 42);

DESCRIPTION

       "GConfValue" is a dynamic type similar to "GValue",  and represents a value that can be obtained from or stored in the configuration
       database; it contains the value bound to a key, and its type.

       In perl, it's an hashref containing these keys:

       type
	   The type of the data.  Fundamental types are 'string', 'int', 'float' and 'bool'.  Lists are handled by passing an arrayref as the
	   payload of the "value" key:

		   $client->set($key, { type => 'string', value => 'some string' });
		   $client->set($key, { type => 'float',  value => 0.5		 });
		   $client->set($key, { type => 'bool',   value => FALSE	 });
		   $client->set($key, { type => 'int',	  value => [0..15]	 });

	   Pairs are handled by using the special type 'pair', and passing, in place of the "value" key, the "car" and the "cdr" keys, each
	   containing an hashref representing a GConfValue:

		   $client->set($key, {
				   type => 'pair',
				   car	=> { type => 'string', value => 'some string' },
				   cdr	=> { type => 'int',    value => 42	      },
			   });

	   This is needed since pairs might have different types; lists, instead, are of the same type.

       value
	   The payload, containing the value of type "type".  It is used only for fundamental types (scalars or lists).

       car, cdr
	   Special keys, that must be used only when working with the 'pair' type.

SEE ALSO

       Gnome2::GConf(3pm), Gnome2::GConf::Entry(3pm), Gnome2::GConf::Schema(3pm), Gnome2::GConf::ChangeSet(3pm).

METHODS

   integer = $value_a->compare ($value_b)
       o   $value_b (value)

       Since: gconf 2.13

   string = $value->to_string
SEE ALSO

       Gnome2::GConf

COPYRIGHT

       Copyright (C) 2003-2006 by the gtk2-perl team.

       This software is licensed under the LGPL.  See Gnome2::GConf for a full notice.

perl v5.14.2							    2011-11-17						 Gnome2::GConf::Value(3pm)

Gnome2::Client(3pm)					User Contributed Perl Documentation				       Gnome2::Client(3pm)

NAME

       Gnome2::Client - wrapper for GnomeClient

HIERARCHY

	 Glib::Object
	 +----Glib::InitiallyUnowned
	      +----Gtk2::Object
		   +----Gnome2::Client

METHODS

   client = Gnome2::Client->new
   client = Gnome2::Client->new_without_connection
   $client->add_static_arg (...)
       o   ... (list)

   $client->set_clone_command (...)
       o   ... (list)

   string = $client->get_config_prefix
   $client->connect
   boolean = $client->connected
   $client->set_current_directory ($dir)
       o   $dir (string)

   string = $client->get_desktop_id
   $client->set_discard_command (...)
       o   ... (list)

   $client->disconnect
   $client->set_environment ($name, $value)
       o   $name (string)

       o   $value (string)

   clientflags = $client->get_flags
   $client->flush
   string = $client->get_global_config_prefix
   $client->set_global_config_prefix ($prefix)
       o   $prefix (string)

   string = $client->get_id
   Gnome2::Client->interaction_key_return ($key, $cancel_shutdown)
       o   $key (integer)

       o   $cancel_shutdown (boolean)

   client = Gnome2::Client->master
   string = $client->get_previous_id
   $client->set_priority ($priority)
       o   $priority (integer)

   $client->request_interaction ($dialog_type, $function, $data=undef)
       o   $dialog_type (Gnome2::DialogType)

       o   $function (scalar)

       o   $data (scalar)

   $client->request_phase_2
   $client->request_save ($save_style, $shutdown, $interact_style, $fast, $global)
       o   $save_style (Gnome2::SaveStyle)

       o   $shutdown (boolean)

       o   $interact_style (Gnome2::InteractStyle)

       o   $fast (boolean)

       o   $global (boolean)

   $client->set_resign_command (...)
       o   ... (list)

   $client->set_restart_command (...)
       o   ... (list)

   $client->set_restart_style ($style)
       o   $style (Gnome2::RestartStyle)

   $client->save_any_dialog ($dialog)
       o   $dialog (Gtk2::Dialog)

   $client->save_error_dialog ($dialog)
       o   $dialog (Gtk2::Dialog)

   $client->set_shutdown_command (...)
       o   ... (list)

SIGNALS

       boolean = save-yourself (Gnome2::Client, integer, Gnome2::SaveStyle, boolean, Gnome2::InteractStyle, boolean)
       die (Gnome2::Client)
       save-complete (Gnome2::Client)
       shutdown-cancelled (Gnome2::Client)
       connect (Gnome2::Client, boolean)
       disconnect (Gnome2::Client)

ENUMS AND FLAGS

   flags Gnome2::ClientFlags
       o   'is-connected' / 'GNOME_CLIENT_IS_CONNECTED'

       o   'restarted' / 'GNOME_CLIENT_RESTARTED'

       o   'restored' / 'GNOME_CLIENT_RESTORED'

   enum Gnome2::DialogType
       o   'error' / 'GNOME_DIALOG_ERROR'

       o   'normal' / 'GNOME_DIALOG_NORMAL'

   enum Gnome2::InteractStyle
       o   'none' / 'GNOME_INTERACT_NONE'

       o   'errors' / 'GNOME_INTERACT_ERRORS'

       o   'any' / 'GNOME_INTERACT_ANY'

   enum Gnome2::RestartStyle
       o   'if-running' / 'GNOME_RESTART_IF_RUNNING'

       o   'anyway' / 'GNOME_RESTART_ANYWAY'

       o   'immediately' / 'GNOME_RESTART_IMMEDIATELY'

       o   'never' / 'GNOME_RESTART_NEVER'

   enum Gnome2::SaveStyle
       o   'global' / 'GNOME_SAVE_GLOBAL'

       o   'local' / 'GNOME_SAVE_LOCAL'

       o   'both' / 'GNOME_SAVE_BOTH'

SEE ALSO

       Gnome2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object

COPYRIGHT

       Copyright (C) 2003-2004 by the gtk2-perl team.

       This software is licensed under the LGPL.  See Gnome2 for a full notice.

perl v5.14.2							    2011-11-16						       Gnome2::Client(3pm)