/usr/lib/perl5/Gtk2/TreeIter.pod is in libgtk2-perl-doc 2:1.249-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 | =head1 NAME
Gtk2::TreeIter - wrapper for GtkTreeIter
=cut
=head1 HIERARCHY
Glib::Boxed
+----Gtk2::TreeIter
=cut
=head1 SYNOPSIS
package MyCustomListStore;
use Glib::Object::Subclass
Glib::Object::,
interfaces => [ Gtk2::TreeModel:: ],
;
...
sub set {
my $list = shift;
my $iter = shift; # a Gtk2::TreeIter
# this method needs access to the internal representation
# of the iter, as the model implementation sees it:
my $arrayref = $iter->to_arrayref ($list->{stamp});
...
}
=head1 DESCRIPTION
The methods described here are only of use in custom Gtk2::TreeModel
implementations; they are not safe to be used on generic iters or in
application code. See L<Gtk2::TreeModel/CREATING A CUSTOM TREE MODEL> for
more information.
=cut
=head1 METHODS
=head2 treeiter = Gtk2::TreeIter-E<gt>B<new_from_arrayref> ($sv_iter)
=over
=item * $sv_iter (scalar)
=back
Create a new Gtk2::TreeIter from the "internal" array reference representation
used by custom Gtk2::TreeModel implementations. This is the complement to
Gtk2::TreeIter::to_arrayref(), and is used when you need to create and return
a new iter from a method that is not one of the Gtk2::TreeModelIface
interface vfuncs. See L<Gtk2::TreeModel/CREATING A CUSTOM TREE MODEL> for
more information.
=head2 $iter-E<gt>B<set> ($from)
=over
=item * $from (scalar)
=back
Set the contents of $iter. $from can be either another Gtk2::TreeIter
or an "internal" arrayref form as above.
Often you create a new iter instead of modifying an existing one, but
C<set> lets you to implement things in the style of the C<remove>
method of Gtk2::ListStore and Gtk2::TreeStore.
A set can also explicitly invalidate an iter by zapping its stamp, so
nobody can accidentally use it again.
$iter->set ([0,0,undef,undef]);
=head2 scalar = $iter-E<gt>B<to_arrayref> ($stamp)
=over
=item * $stamp (integer)
=back
Convert a boxed Gtk2::TreeIter reference into the "internal" array reference
representation used by custom Gtk2::TreeModel implementations. This is
necessary when you need to get to the data inside your iters in methods
which are not the vfuncs of the Gtk2::TreeModelIface interface. The stamp
must match; this protects the binding code from potential memory faults
when attempting to convert an iter that doesn't actually belong to your
model. See L<Gtk2::TreeModel/CREATING A CUSTOM TREE MODEL> for
more information.
=cut
=head1 SEE ALSO
L<Gtk2>, L<Glib::Boxed>, L<Gtk2::TreeModel>
=cut
=head1 COPYRIGHT
Copyright (C) 2003-2011 by the gtk2-perl team.
This software is licensed under the LGPL. See L<Gtk2> for a full notice.
=cut
|