diff options
Diffstat (limited to 'doc/html/outliner-example.html')
| -rw-r--r-- | doc/html/outliner-example.html | 279 |
1 files changed, 279 insertions, 0 deletions
diff --git a/doc/html/outliner-example.html b/doc/html/outliner-example.html new file mode 100644 index 0000000..d7a268f --- /dev/null +++ b/doc/html/outliner-example.html @@ -0,0 +1,279 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/examples/xml/outliner/outliner.doc:5 --> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> +<title>Outliner to show use of DOM</title> +<style type="text/css"><!-- +fn { margin-left: 1cm; text-indent: -1cm; } +a:link { color: #004faf; text-decoration: none } +a:visited { color: #672967; text-decoration: none } +body { background: #ffffff; color: black; } +--></style> +</head> +<body> + +<table border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr bgcolor="#E5E5E5"> +<td valign=center> + <a href="index.html"> +<font color="#004faf">Home</font></a> + | <a href="classes.html"> +<font color="#004faf">All Classes</font></a> + | <a href="mainclasses.html"> +<font color="#004faf">Main Classes</font></a> + | <a href="annotated.html"> +<font color="#004faf">Annotated</font></a> + | <a href="groups.html"> +<font color="#004faf">Grouped Classes</font></a> + | <a href="functions.html"> +<font color="#004faf">Functions</font></a> +</td> +<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Outliner to show use of DOM</h1> + + +<p> +<p> This example presents a small outliner program to show the basic usage of +the <a href="xml.html#dom">DOM classes</a>. The format of the outlines +is the OPML format as described in http://www.opml.org/spec. +<p> This example shows how to load a DOM tree from an XML file and how to +traverse it. +<p> <hr> +<p> Sample XML file (todos.opml): +<p> <pre><?xml version="1.0" encoding="ISO-8859-1"?> +<opml version="1.0"> + <head> + <title>Todo List</title> + <dateCreated>Tue, 31 Oct 2000 17:00:17 CET</dateCreated> + <dateModified>Tue, 31 Oct 2000 17:00:17 CET</dateModified> + <ownerName>Arthur Dent</ownerName> + <ownerEmail>info@trolltech.com</ownerEmail> + </head> + <body> + <outline text="Background"> + <outline text="This is an example todo list."/> + </outline> + <outline text="Books to read"> + <outline text="Science Fiction"> + <outline text="Philip K. Dick"> + <outline text="Do Androids Dream of Electical Sheep?"/> + <outline text="The Three Stigmata of Palmer Eldritch"/> + </outline> + <outline text="Robert A. Heinlein"> + <outline text="Stranger in a Strange Land"/> + </outline> + <outline text="Isaac Asimov"> + <outline text="Foundation and Empire"/> + </outline> + </outline> + <outline text="Qt Books (in English)"> + <outline text="Blanchette &amp; Summerfield: C++ GUI Programming with Qt 3"/> + <outline text="Dalheimer: Programming with Qt"/> + <outline text="Griffith: KDE 2/Qt Programming Bible"/> + <outline text="Hughes: Linux Rapid Application Development"/> + <outline text="Solin: <a href="qt.html">Qt</a> Programming in 24 hours"/> + <outline text="Ward: <a href="qt.html">Qt</a> 2 Programming for Linux and Windows 2000"/> + </outline> + </outline> + <outline text="Shopping list"> + <outline text="General"> + <outline text="Towel"/> + <outline text="Hair dryer"/> + <outline text="Underpants"/> + </outline> + <outline text="For Sunday"> + <outline text="Beef"/> + <outline text="Rice"/> + <outline text="Carrots"/> + <outline text="Beans"/> + <outline text="Beer"/> + <outline text="Wine"/> + <outline text="Orange juice"/> + </outline> + </outline> + <outline text="Write a letter to Ford"> + </outline> + </body> +</opml> +</pre> + +<p> <hr> +<p> Header file (outlinetree.h): +<p> <pre>/**************************************************************************** +** $Id: qt/outlinetree.h 3.3.8 edited Jan 11 14:37 $ +** +** Copyright (C) 1992-2007 Trolltech ASA. All rights reserved. +** +** This file is part of an example program for Qt. This example +** program may be used, distributed and modified without limitation. +** +*****************************************************************************/ + +#ifndef OUTLINETREE_H +#define OUTLINETREE_H + +#include <<a href="qlistview-h.html">qlistview.h</a>> +#include <<a href="qdom-h.html">qdom.h</a>> + +class OutlineTree : public <a href="qlistview.html">QListView</a> +{ + <a href="metaobjects.html#Q_OBJECT">Q_OBJECT</a> + +public: + OutlineTree( const <a href="qstring.html">QString</a> fileName, QWidget *parent = 0, const char *name = 0 ); + ~OutlineTree(); + +private: + <a href="qdomdocument.html">QDomDocument</a> domTree; + void getHeaderInformation( const <a href="qdomelement.html">QDomElement</a> &header ); + void buildTree( <a href="qlistviewitem.html">QListViewItem</a> *parentItem, const <a href="qdomelement.html">QDomElement</a> &parentElement ); +}; + +#endif // OUTLINETREE_H +</pre> + +<p> <hr> +<p> Implementation (outlinetree.cpp): +<p> <pre>/**************************************************************************** +** $Id: qt/outlinetree.cpp 3.3.8 edited Jan 11 14:37 $ +** +** Copyright (C) 1992-2007 Trolltech ASA. All rights reserved. +** +** This file is part of an example program for Qt. This example +** program may be used, distributed and modified without limitation. +** +*****************************************************************************/ + +#include "outlinetree.h" +#include <<a href="qfile-h.html">qfile.h</a>> +#include <<a href="qmessagebox-h.html">qmessagebox.h</a>> + +<a name="f522"></a>OutlineTree::OutlineTree( const <a href="qstring.html">QString</a> fileName, QWidget *parent, const char *name ) + : <a href="qlistview.html">QListView</a>( parent, name ) +{ + // div. configuration of the list view + <a href="qlistview.html#addColumn">addColumn</a>( "Outlines" ); + <a href="qlistview.html#setSorting">setSorting</a>( -1 ); + <a href="qlistview.html#setRootIsDecorated">setRootIsDecorated</a>( TRUE ); + + // read the XML file and create DOM tree + <a href="qfile.html">QFile</a> opmlFile( fileName ); +<a name="x1915"></a> if ( !opmlFile.<a href="qfile.html#open">open</a>( <a href="qfile.html#open">IO_ReadOnly</a> ) ) { +<a name="x1917"></a> QMessageBox::<a href="qmessagebox.html#critical">critical</a>( 0, + <a href="qobject.html#tr">tr</a>( "Critical Error" ), + <a href="qobject.html#tr">tr</a>( "Cannot open file %1" ).arg( fileName ) ); + return; + } + if ( !domTree.setContent( &opmlFile ) ) { + QMessageBox::<a href="qmessagebox.html#critical">critical</a>( 0, + <a href="qobject.html#tr">tr</a>( "Critical Error" ), + <a href="qobject.html#tr">tr</a>( "Parsing error for file %1" ).arg( fileName ) ); +<a name="x1914"></a> opmlFile.<a href="qfile.html#close">close</a>(); + return; + } + opmlFile.<a href="qfile.html#close">close</a>(); + + // get the header information from the DOM + <a href="qdomelement.html">QDomElement</a> root = domTree.documentElement(); + <a href="qdomnode.html">QDomNode</a> node; +<a name="x1907"></a> node = root.<a href="qdomnode.html#firstChild">firstChild</a>(); +<a name="x1909"></a> while ( !node.<a href="qdomnode.html#isNull">isNull</a>() ) { +<a name="x1911"></a><a name="x1908"></a> if ( node.<a href="qdomnode.html#isElement">isElement</a>() && node.<a href="qdomnode.html#nodeName">nodeName</a>() == "head" ) { +<a name="x1913"></a> <a href="qdomelement.html">QDomElement</a> header = node.<a href="qdomnode.html#toElement">toElement</a>(); + getHeaderInformation( header ); + break; + } +<a name="x1910"></a> node = node.<a href="qdomnode.html#nextSibling">nextSibling</a>(); + } + // create the tree view out of the DOM + node = root.<a href="qdomnode.html#firstChild">firstChild</a>(); + while ( !node.<a href="qdomnode.html#isNull">isNull</a>() ) { + if ( node.<a href="qdomnode.html#isElement">isElement</a>() && node.<a href="qdomnode.html#nodeName">nodeName</a>() == "body" ) { + <a href="qdomelement.html">QDomElement</a> body = node.<a href="qdomnode.html#toElement">toElement</a>(); + buildTree( 0, body ); + break; + } + node = node.<a href="qdomnode.html#nextSibling">nextSibling</a>(); + } +} + +OutlineTree::~OutlineTree() +{ +} + +void <a name="f523"></a>OutlineTree::getHeaderInformation( const <a href="qdomelement.html">QDomElement</a> &header ) +{ + // visit all children of the header element and look if you can make + // something with it + <a href="qdomnode.html">QDomNode</a> node = header.<a href="qdomnode.html#firstChild">firstChild</a>(); + while ( !node.<a href="qdomnode.html#isNull">isNull</a>() ) { + if ( node.<a href="qdomnode.html#isElement">isElement</a>() ) { + // case for the different header entries + if ( node.<a href="qdomnode.html#nodeName">nodeName</a>() == "title" ) { + <a href="qdomtext.html">QDomText</a> textChild = node.<a href="qdomnode.html#firstChild">firstChild</a>().toText(); + if ( !textChild.<a href="qdomnode.html#isNull">isNull</a>() ) { +<a name="x1912"></a> <a href="qlistview.html#setColumnText">setColumnText</a>( 0, textChild.<a href="qdomnode.html#nodeValue">nodeValue</a>() ); + } + } + } + node = node.<a href="qdomnode.html#nextSibling">nextSibling</a>(); + } +} + +void <a name="f524"></a>OutlineTree::buildTree( <a href="qlistviewitem.html">QListViewItem</a> *parentItem, const <a href="qdomelement.html">QDomElement</a> &parentElement ) +{ + <a href="qlistviewitem.html">QListViewItem</a> *thisItem = 0; + <a href="qdomnode.html">QDomNode</a> node = parentElement.<a href="qdomnode.html#firstChild">firstChild</a>(); + while ( !node.<a href="qdomnode.html#isNull">isNull</a>() ) { + if ( node.<a href="qdomnode.html#isElement">isElement</a>() && node.<a href="qdomnode.html#nodeName">nodeName</a>() == "outline" ) { + // add a new list view item for the outline + if ( parentItem == 0 ) + thisItem = new <a href="qlistviewitem.html">QListViewItem</a>( this, thisItem ); + else + thisItem = new <a href="qlistviewitem.html">QListViewItem</a>( parentItem, thisItem ); +<a name="x1916"></a> thisItem-><a href="qlistviewitem.html#setText">setText</a>( 0, node.<a href="qdomnode.html#toElement">toElement</a>().attribute( "text" ) ); + // recursive build of the tree + buildTree( thisItem, node.<a href="qdomnode.html#toElement">toElement</a>() ); + } + node = node.<a href="qdomnode.html#nextSibling">nextSibling</a>(); + } +} +</pre> + +<p> <hr> +<p> Main (main.cpp): +<p> <pre>/**************************************************************************** +** $Id: qt/main.cpp 3.3.8 edited Jan 11 14:37 $ +** +** Copyright (C) 1992-2007 Trolltech ASA. All rights reserved. +** +** This file is part of an example program for Qt. This example +** program may be used, distributed and modified without limitation. +** +*****************************************************************************/ + +#include <<a href="qapplication-h.html">qapplication.h</a>> +#include "outlinetree.h" + +int main( int argc, char **argv ) +{ + <a href="qapplication.html">QApplication</a> a( argc, argv ); + + OutlineTree outline( "todos.opml" ); + a.<a href="qapplication.html#setMainWidget">setMainWidget</a>( &outline ); +<a name="x1920"></a> outline.<a href="qwidget.html#show">show</a>(); + + return a.<a href="qapplication.html#exec">exec</a>(); +} +</pre> + +<p>See also <a href="xml-examples.html">Qt XML Examples</a>. + +<!-- eof --> +<p><address><hr><div align=center> +<table width=100% cellspacing=0 border=0><tr> +<td>Copyright © 2007 +<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a> +<td align=right><div align=right>Qt 3.3.8</div> +</table></div></address></body> +</html> |