08 Jun 2014 10:25:52 UTC
- Distribution: Glib-Ex-ObjectBits
- Module version: 16
- Source (raw)
- Browse (raw)
- How to Contribute
- Testers (3434 / 29 / 0)
- KwaliteeBus factor: 1
- 68.02% Coverage
- License: gpl_3
- Perl: v5.8.0
- Activity24 month
- Download (51.52KB)
- MetaCPAN Explorer
- Subscribe to distribution
- This version
- Latest versionKRYDE Kevin Rydeand 1 contributors
- Kevin Ryde
Glib::Ex::ObjectBits -- misc Glib object helpers
Glib::Ex::ObjectBits::set_property_maybe ($obj, $pname1,$value1, $pname2,$value2, ...)
Set properties on
$objif they exist. Each
$pnameis a property name (a string) and those which exist on
$objare set to their
This is a handy way to apply properties which might only exist in a new enough version of a library. For example
tooltip-textin Gtk 2.12 up,
Glib::Ex::ObjectBits::set_property_maybe ($widget, tooltip_text => 'Some description.');
Things like this which are purely visual and don't affect actual operation are good for a set-maybe. Important things might want some sort of proper fallback.
Properties which do always exist can be included in
set_property_maybe(), if a single call looks better. But be careful not to mis-spell a property name, since
set_property_maybe()of course has no way to identify that.
Nothing is exported by default, but the functions can be requested in usual
use Glib::Ex::ObjectBits 'set_property_maybe'; # "tearoff-title" new in Gtk 2.10 set_property_maybe ($combobox, tearoff_title => 'My Menu');
set_property_maybe()is good if making many such settings. The name is tolerably distinctive.
:alltag since this module is meant as a grab-bag of functions and to import as-yet unknown things would be asking for name clashes.
Copyright 2010, 2011, 2012, 2014 Kevin Ryde
Glib-Ex-ObjectBits is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.
Glib-Ex-ObjectBits 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 General Public License for more details.
You should have received a copy of the GNU General Public License along with Glib-Ex-ObjectBits. If not, see http://www.gnu.org/licenses/.
Module Install Instructions
To install Glib::Ex::ObjectBits, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell install Glib::Ex::ObjectBits
For more information on module installation, please visit the detailed CPAN module installation guide.