NAME

Meta::Widget::Gtk::XmlTree - widget to show/edit XML::DOM objects.

COPYRIGHT

Copyright (C) 2001, 2002 Mark Veltzer; All rights reserved.

LICENSE

This program 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 2 of the License, or (at your option) any later version.

This program 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 this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.

DETAILS

        MANIFEST: XmlTree.pm
        PROJECT: meta
        VERSION: 0.14

SYNOPSIS

        package foo;
        use Meta::Widget::Gtk::XmlTree qw();
        my($object)=Meta::Widget::Gtk::XmlTree->new();
        my($result)=$object->set_dom($dom);

DESCRIPTION

This is a widget which is derived from the Gtk::Tree widget and which displays an XML::DOM object in it. The object has several options: 0. vali - if this is turned on then a validating parser will be used to parse the document. This has more overhead but is more secure. 1. skip - if this is turned on then junk whitespace will be skipped and not presented as nodes. It is usually a good thing to keep this on. 2. full - if this is turned on then the entire DOM object will be scanned at the beginnig and all the visual elements created at that time. This has more overhead at begining but afterwards is much faster. If this option is turned off then only the root will be created and elements will be created as requested by the user. This has less overhead at the begining, uses less memory but is a little slower at run time. Please remmember that in either case the entire XML is already in memory because you are using DOM...:)

FUNCTIONS

        new($)
        set_dom($$)
        set_file($$)
        set_deve_file($$)
        get_vali($)
        set_vali($$)
        get_skip($)
        set_skip($$)
        get_full($)
        set_full($$)
        node_add($$$)
        node_del($$$)
        tree_expand($$$)
        tree_collapse($$$)
        TEST($)

FUNCTION DOCUMENTATION

new($)

This is a constructor for the Meta::Widget::Gtk::XmlTree object.

set_dom($$)

This will add a dom object to this tree.

set_file($$)

This method gets a file name, parses it and uses it as the display of the widget.

set_deve_file($$)

This method will do the same as set_file except it assumes that the file given to it is in a development system and will ask the development system locator for the files actual location before invoking set_file.

get_vali($)

This method will retrieve the validate attribute.

set_vali($$)

This method will set the validate attribute.

get_skip($)

This method will retrieve the skip attribute.

set_skip($$)

This method will set the skip attribute.

get_full($)

This method will retrieve the full attribute.

set_full($$)

This method will set the full attribute.

node_add($$$)

This will add a node.

node_del($$$)

This method deletes a node.

tree_expand($$$)

This will handle tree expansions.

tree_collapse($$$)

This will handle tree expansions.

TEST($)

Test suite for this module.

SUPER CLASSES

Gtk::Tree(3)

BUGS

None.

AUTHOR

        Name: Mark Veltzer
        Email: mailto:veltzer@cpan.org
        WWW: http://www.veltzer.org
        CPAN id: VELTZER

HISTORY

        0.00 MV perl reorganization
        0.01 MV get imdb ids of directors and movies
        0.02 MV todo items in XML
        0.03 MV perl packaging
        0.04 MV PDMT
        0.05 MV md5 project
        0.06 MV database
        0.07 MV perl module versions in files
        0.08 MV movies and small fixes
        0.09 MV thumbnail user interface
        0.10 MV more thumbnail issues
        0.11 MV website construction
        0.12 MV web site automation
        0.13 MV SEE ALSO section fix
        0.14 MV md5 issues

SEE ALSO

Gtk(3), Meta::Baseline::Aegis(3), XML::DOM(3), XML::DOM::ValParser(3), strict(3)

TODO

Nothing.