Gtk2::CellLayout(3) User Contributed Perl Documentation Gtk2::CellLayout(3)NAMEGtk2::CellLayoutSYNOPSIS
# This is an abstract interface; the CellLayout interface is
# implemented by concrete classes like ComboBox and TreeViewColumn.
# See the discussion for details on creating your own CellLayout.
# This synopsis assumes you already have an instance in $cell_layout.
# Add a cell renderer that shows the pixbuf in column 2 of the
# associated TreeModel. It will take up only the necessary space
# ("expand" => FALSE).
my $cell = Gtk2::CellRendererPixbuf->new ();
$cell_layout->pack_start ($cell, FALSE);
$cell_layout->add_attribute ($cell, pixbuf => 2);
# Add another cell renderer that gets the "text" property from
# column 3 of the associated TreeModel, and takes up all remaining
# horizontal space ("expand" => TRUE).
my $cell = Gtk2::CellRendererText->new ();
$cell_layout->pack_start ($cell, TRUE);
$cell_layout->add_attribute ($cell, text => 3);
DESCRIPTIONGtk2::CellLayout is an interface to be implemented by all objects which
want to provide a Gtk2::TreeViewColumn-like API for packing cells,
setting attributes and data funcs.
HIERARCHY
Glib::Interface
+----Gtk2::CellLayout
METHODS
$cell_layout->add_attribute ($cell, $attribute, $column)
· $cell (Gtk2::CellRenderer)
· $attribute (string)
· $column (integer)
Adds an attribute mapping to the list in $cell_layout. The $column is
the column of the model from which to get a value, and the $attribute
is the property of $cell to be set from the value. So, for example, if
column 2 of the model contains strings, you could have the "text"
attribute of a Gtk2::CellRendererText get its values from column 2.
$cell_layout->set_attributes ($cell, ...)
· $cell (Gtk2::CellRenderer)
· ... (list) list of property name and column number pairs.
Sets the pairs in the ... list as the attributes of $cell_layout, as
with repeated calls to "add_attribute". All existing attributes are
removed, and replaced with the new attributes.
$cell_layout->set_cell_data_func ($cell, $func, $func_data=undef)
· $cell (Gtk2::CellRenderer)
· $func (scalar)
· $func_data (scalar)
Sets up $cell_layout to call $func to set up attributes of $cell,
instead of the standard attribute mapping. $func may be undef to
remove an older callback. $func will receive these parameters:
$cell_layout The cell layout instance
$cell The cell renderer to set up
$model The tree model
$iter TreeIter of the row for which to set the values
$data The $func_data passed to "set_cell_data_func"
list = $cell_layout->get_cells
Fetch all of the cell renderers which have been added to $cell_layout.
Note that if there are no cells this functions returns 'undef' instead
of an empty list.
Since: gtk+ 2.12
$cell_layout->clear
Unsets all the mappings on all renderers on $cell_layout and removes
all renderers attached to it.
$cell_layout->clear_attributes ($cell)
· $cell (Gtk2::CellRenderer)
Clears all existing attributes previously set with for $cell with
"add_attribute" or "set_attributes".
$cell_layout->pack_end ($cell, $expand)
· $cell (Gtk2::CellRenderer)
· $expand (boolean)
Like "pack_start", but adds from the end of the layout instead of the
beginning.
$cell_layout->pack_start ($cell, $expand)
· $cell (Gtk2::CellRenderer)
· $expand (boolean)
Packs $cell into the beginning of $cell_layout. If $expand is false,
then $cell is allocated no more space than it needs. Any unused space
is divided evenly between cells for which $expand is true.
$cell_layout->reorder ($cell, $position)
· $cell (Gtk2::CellRenderer)
· $position (integer)
Re-insert $cell at $position. $cell must already be packed into
$cell_layout.
CREATING A CUSTOM CELL LAYOUT
GTK+ provides several CellLayout implementations, such as
Gtk2::TreeViewColumn and Gtk2::ComboBox. To create your own object
that implements the CellLayout interface and therefore can be used to
display CellRenderers, you need to add Gtk2::CellLayout to your class's
"interfaces" list, like this:
package MyLayout;
use Gtk2;
use Glib::Object::Subclass
Gtk2::Widget::,
interfaces => [ Gtk2::CellLayout:: ],
;
This will cause perl to call several virtual methods with
ALL_CAPS_NAMES when GTK+ attempts to perform certain actions. You
simply provide (or override) those methods with perl code. The methods
map rather directly to the object interface, so it should be easy to
figure out what they should do. Those methods are:
PACK_START ($cell_layout, $cell, $expand)
PACK_END ($cell_layout, $cell, $expand)
CLEAR ($cell_layout)
ADD_ATTRIBUTE ($cell_layout, $cell, $attribute, $column)
SET_CELL_DATA_FUNC ($cell_layout, $cell, $func, $data)
CLEAR_ATTRIBUTES ($cell_layout, $cell)
REORDER ($cell_layout, $cell, $position)
list = GET_CELLS ($cell_layout)
SEE ALSO
Gtk2, Glib::Interface
COPYRIGHT
Copyright (C) 2003-2011 by the gtk2-perl team.
This software is licensed under the LGPL. See Gtk2 for a full notice.
perl v5.18.1 2013-09-28 Gtk2::CellLayout(3)
