GtkCListModel(3)					User Contributed Perl Documentation					  GtkCListModel(3)

NAME

       Gtk::CListModel - A simple data model with Gtk::Clist views

SINOPSYS

	       my $model = tie @data, 'Gtk::CListModel',
		       titles => ["Fruit", "Price", "Quantity"];
	       # all data manipulation is done on @data now
	       push @data, ["Oranges", 5, 16];
	       # Create a view (a Gtk::Clist widget) to represent the data
	       # Include only some of the data in the view (fruit type and price)
	       # Also, do not include fruits that cost more than 6 price units.
	       my $clist = $model->create_view('main',
		       titles => ['Fruit', 'Price'],
		       filter => sub {$_[1] > 6? () : @_});

DESCRIPTION

       Gtk::CListModel lets you keep your data in a perl array and easily create a numer of different views on that data using Gtk::CList widgets.
       The views can show only some of the columns, or a subset of the data or even munge the data with user-defined filters.

       All the data manipulations will be performed on a tied array and the changes will be propagated to the views created for that data.

       To create the model use "tie":

	       my $model = tie @data, 'Gtk::CListModel',
		       titles => ["head1", "head2",...];

       The "titles" attribute should be an array reference with the titles of the columns of data. They will be used also for the default titles
       in the views.

       You can also provide the initial data using the "data" attribute. Remember that the data elements you insert and retreive from the @data
       array are array references with as many items as the columns in the model. The order is the one defined by the "titles" attribute.

       Later you can manipulate the @data array with the usual perl array operators, push, splice and so on.

METHODS

       create_view ($name[, %options])
	 Create a Gtk::Clist widget that represents the data in the model.  The name can be used later to disconnect the view from the data.

	 Options can be one of the following:

	 o titles
	   An array reference of the titles of the columns to display in the list in the order they should appear in the view. The default is the
	   titles specified at the model creation.

	 o filter
	   A function that can manipulate the data just before it is inserted in the Gtk::CList. The function will receive the data and can either
	   make a copy and modify the data or return an empty list. In the latter case the data will not be added to the view or, if the corre-
	   sponding row was already present, it will be removed from the view.

	 o postfilter
	   A function that receives the view, the row and the data that was just inserted/modified in the view. By default all the data is
	   inserted in the views as text. This filter can be used to display pixmaps, for example or do any other kind of manipulations on the
	   Gtk::CList row.

       remove_view ($name)
	 Disconnect the named view from the data. The current data displayed in the view will not be affected, but changes in the model will not
	 propagate to this view anymore.

       map_row ($clist, $row)
	 Get the index in the data array cooresponding to the row displayed in the Gtk::CList widget.

AUTHOR

       Molaro Paolo lupus@debian.org

perl v5.8.0							    2001-06-26							  GtkCListModel(3)