<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US">
<head>
<title>khtml: DOM::TreeWalker Class Reference (khtml)</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org" r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org" r (n 0 s 0 v 0 l 0))' />
<meta name="trademark" content="KDE e.V." />
<meta name="description" content="K Desktop Environment Homepage, KDE.org" />
<meta name="MSSmartTagsPreventParsing" content="true" />
<meta name="robots" content="all" />
<link rel="shortcut icon" href="../../favicon.ico" />
<link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" />
</head>
<body>
<div id="nav_header_top" align="right">
<a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a>
<a href="../.."><img id="nav_header_logo" alt="Home" align="left" src="../../kde_gear_64.png" border="0" /></a>
<span class="doNotDisplay">::</span>
<div id="nav_header_title" align="left">KDE API Reference</div>
</div>
<div id="nav_header_bottom" align="right">
<span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span>
<div id="nav_header_bottom_right" style="text-align: left;">
/ <a href="../..">API Reference</a>
/ <a href=".">khtml</a>
</div>
</div>
<table id="main" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td valign="top" class="menuheader" height="0"></td>
<td id="contentcolumn" valign="top" rowspan="2" >
<div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;">
<a name="content"></a>
<!-- Generated by Doxygen 1.7.4 -->
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="namespaceDOM.html">DOM</a> </li>
<li class="navelem"><a class="el" href="classDOM_1_1TreeWalker.html">TreeWalker</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pro-methods">Protected Member Functions</a> |
<a href="#pro-attribs">Protected Attributes</a> |
<a href="#friends">Friends</a> </div>
<div class="headertitle">
<div class="title">DOM::TreeWalker Class Reference</div> </div>
</div>
<div class="contents">
<!-- doxytag: class="DOM::TreeWalker" -->
<p><code><a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a></code> objects are used to navigate a document tree or subtree using the view of the document defined by its <code>whatToShow</code> flags and any filters that are defined for the <code><a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a></code> .
<a href="classDOM_1_1TreeWalker.html#details">More...</a></p>
<p><code>#include <<a class="el" href="dom2__traversal_8h_source.html">dom2_traversal.h</a>></code></p>
<p><a href="classDOM_1_1TreeWalker-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a5b34dc8d7063dfc820a8fc3b450fc237"></a><!-- doxytag: member="DOM::TreeWalker::TreeWalker" ref="a5b34dc8d7063dfc820a8fc3b450fc237" args="(const TreeWalker &other)" -->
 </td><td class="memItemRight" valign="bottom"><b>TreeWalker</b> (const <a class="el" href="classDOM_1_1TreeWalker.html">TreeWalker</a> &other)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a3519d53fc08d3b4253ac9aff722cfabd"></a><!-- doxytag: member="DOM::TreeWalker::operator=" ref="a3519d53fc08d3b4253ac9aff722cfabd" args="(const TreeWalker &other)" -->
<a class="el" href="classDOM_1_1TreeWalker.html">TreeWalker</a> & </td><td class="memItemRight" valign="bottom"><b>operator=</b> (const <a class="el" href="classDOM_1_1TreeWalker.html">TreeWalker</a> &other)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classDOM_1_1Node.html">Node</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOM_1_1TreeWalker.html#a61d2f0414e445677ed68c4bfb19548fd">root</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">unsigned long </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOM_1_1TreeWalker.html#a6ff099191d7e697ceccd4f9ff164161e">whatToShow</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classDOM_1_1NodeFilter.html">NodeFilter</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOM_1_1TreeWalker.html#ab17b15a9ebf5f25d5b3e4de9fb4e2c16">filter</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOM_1_1TreeWalker.html#a9fc0a37188d9ff1b59e9676412b35719">expandEntityReferences</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classDOM_1_1Node.html">Node</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOM_1_1TreeWalker.html#ab0c3a9abc4828ea9b650ffe6d06c9b1c">currentNode</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOM_1_1TreeWalker.html#a734f5d5ebb07d27f73fc20317c398ae2">setCurrentNode</a> (const <a class="el" href="classDOM_1_1Node.html">Node</a> &_currentNode)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classDOM_1_1Node.html">Node</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOM_1_1TreeWalker.html#a48db084f49423c2a9b7926415d6a7d68">parentNode</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classDOM_1_1Node.html">Node</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOM_1_1TreeWalker.html#a601cea3b8d991848df5f55abb3dc0178">firstChild</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classDOM_1_1Node.html">Node</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOM_1_1TreeWalker.html#a469a0dfe5178f9a9fdf167b1a3591a18">lastChild</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classDOM_1_1Node.html">Node</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOM_1_1TreeWalker.html#ade39ce0a137678556b43737484483951">previousSibling</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classDOM_1_1Node.html">Node</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOM_1_1TreeWalker.html#adacbab406de14c222afbc9a2a8f3e35d">nextSibling</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classDOM_1_1Node.html">Node</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOM_1_1TreeWalker.html#a0c85924bbba6e5158f5d8728c692945a">previousNode</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classDOM_1_1Node.html">Node</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOM_1_1TreeWalker.html#aa4eea50c409ad79e4f7c82afca8a4e75">nextNode</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ab9ac6d208575a7ba0ab8524c2a2d468f"></a><!-- doxytag: member="DOM::TreeWalker::handle" ref="ab9ac6d208575a7ba0ab8524c2a2d468f" args="() const " -->
TreeWalkerImpl * </td><td class="memItemRight" valign="bottom"><b>handle</b> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a6be6722c28dbca85bcc2bb1965c23f4e"></a><!-- doxytag: member="DOM::TreeWalker::isNull" ref="a6be6722c28dbca85bcc2bb1965c23f4e" args="() const " -->
bool </td><td class="memItemRight" valign="bottom"><b>isNull</b> () const </td></tr>
<tr><td colspan="2"><h2><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a343f5205d2252c24fc90ba37afa30445"></a><!-- doxytag: member="DOM::TreeWalker::TreeWalker" ref="a343f5205d2252c24fc90ba37afa30445" args="(TreeWalkerImpl *i)" -->
 </td><td class="memItemRight" valign="bottom"><b>TreeWalker</b> (TreeWalkerImpl *i)</td></tr>
<tr><td colspan="2"><h2><a name="pro-attribs"></a>
Protected Attributes</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ad736aa5dbce21f855bac9c73cbbba21f"></a><!-- doxytag: member="DOM::TreeWalker::impl" ref="ad736aa5dbce21f855bac9c73cbbba21f" args="" -->
TreeWalkerImpl * </td><td class="memItemRight" valign="bottom"><b>impl</b></td></tr>
<tr><td colspan="2"><h2><a name="friends"></a>
Friends</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a883538034e58fc5c0de7d4e4cab3cef7"></a><!-- doxytag: member="DOM::TreeWalker::Document" ref="a883538034e58fc5c0de7d4e4cab3cef7" args="" -->
class </td><td class="memItemRight" valign="bottom"><b>Document</b></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a07cf95be6d018eb40e40daff060850d5"></a><!-- doxytag: member="DOM::TreeWalker::TreeWalkerImpl" ref="a07cf95be6d018eb40e40daff060850d5" args="" -->
class </td><td class="memItemRight" valign="bottom"><b>TreeWalkerImpl</b></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p><code><a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a></code> objects are used to navigate a document tree or subtree using the view of the document defined by its <code>whatToShow</code> flags and any filters that are defined for the <code><a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a></code> . </p>
<p>Any function which performs navigation using a <code><a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a></code> will automatically support any view defined by a <code><a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a></code> .</p>
<p>Omitting nodes from the logical view of a subtree can result in a structure that is substantially different from the same subtree in the complete, unfiltered document. Nodes that are siblings in the <a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a> view may be children of different, widely separated nodes in the original view. For instance, consider a Filter that skips all nodes except for <a class="el" href="classDOM_1_1Text.html" title="The Text interface represents the textual content (termed character data in XML) of an Element or At...">Text</a> nodes and the root node of a document. In the logical view that results, all text nodes will be siblings and appear as direct children of the root node, no matter how deeply nested the structure of the original document. </p>
<p>Definition at line <a class="el" href="dom2__traversal_8h_source.html#l00339">339</a> of file <a class="el" href="dom2__traversal_8h_source.html">dom2_traversal.h</a>.</p>
</div><hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="ab0c3a9abc4828ea9b650ffe6d06c9b1c"></a><!-- doxytag: member="DOM::TreeWalker::currentNode" ref="ab0c3a9abc4828ea9b650ffe6d06c9b1c" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classDOM_1_1Node.html">Node</a> TreeWalker::currentNode </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The node at which the <a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a> is currently positioned. </p>
<p>Alterations to the <a class="el" href="namespaceDOM.html" title="The Document Object Model (DOM) is divided into two parts, the COREDOM core DOM, specifying some core...">DOM</a> tree may cause the current node to no longer be accepted by the TreeWalker's associated filter. currentNode may also be explicitly set to any node, whether or not it is within the subtree specified by the root node or would be accepted by the filter and whatToShow flags. Further traversal occurs relative to currentNode even if it is not part of the current view, by applying the filters in the requested direction; if no traversal is possible, currentNode is not changed.</p>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classDOM_1_1DOMException.html" title="DOM operations only raise exceptions in "exceptional" circumstances, i.e., when an operation is impos...">DOMException</a></td><td>NOT_SUPPORTED_ERR: Raised if an attempt is made to set currentNode to null. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="dom2__traversal_8cpp_source.html#l00283">283</a> of file <a class="el" href="dom2__traversal_8cpp_source.html">dom2_traversal.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a9fc0a37188d9ff1b59e9676412b35719"></a><!-- doxytag: member="DOM::TreeWalker::expandEntityReferences" ref="a9fc0a37188d9ff1b59e9676412b35719" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool TreeWalker::expandEntityReferences </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The value of this flag determines whether the children of entity reference nodes are visible to the <a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a>. </p>
<p>If false, they and their descendents will be rejected. Note that this rejection takes precedence over whatToShow and the filter, if any.</p>
<p>To produce a view of the document that has entity references expanded and does not expose the entity reference node itself, use the whatToShow flags to hide the entity reference node and set expandEntityReferences to true when creating the <a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a>. To produce a view of the document that has entity reference nodes but no entity expansion, use the whatToShow flags to show the entity reference node and set expandEntityReferences to false. </p>
<p>Definition at line <a class="el" href="dom2__traversal_8cpp_source.html#l00277">277</a> of file <a class="el" href="dom2__traversal_8cpp_source.html">dom2_traversal.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ab17b15a9ebf5f25d5b3e4de9fb4e2c16"></a><!-- doxytag: member="DOM::TreeWalker::filter" ref="ab17b15a9ebf5f25d5b3e4de9fb4e2c16" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classDOM_1_1NodeFilter.html">NodeFilter</a> TreeWalker::filter </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The filter used to screen nodes. </p>
<p>Definition at line <a class="el" href="dom2__traversal_8cpp_source.html#l00271">271</a> of file <a class="el" href="dom2__traversal_8cpp_source.html">dom2_traversal.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a601cea3b8d991848df5f55abb3dc0178"></a><!-- doxytag: member="DOM::TreeWalker::firstChild" ref="a601cea3b8d991848df5f55abb3dc0178" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classDOM_1_1Node.html">Node</a> TreeWalker::firstChild </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Moves the <code><a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a></code> to the first child of the current node, and returns the new node. </p>
<p>If the current node has no children, returns <code>null</code> , and retains the current node.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The new node, or <code>null</code> if the current node has no children.</dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname">Exceptions</td><td>from user code Any exceptions raised by a user-written Filter will propagate through. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="dom2__traversal_8cpp_source.html#l00300">300</a> of file <a class="el" href="dom2__traversal_8cpp_source.html">dom2_traversal.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a469a0dfe5178f9a9fdf167b1a3591a18"></a><!-- doxytag: member="DOM::TreeWalker::lastChild" ref="a469a0dfe5178f9a9fdf167b1a3591a18" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classDOM_1_1Node.html">Node</a> TreeWalker::lastChild </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Moves the <code><a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a></code> to the last child of the current node, and returns the new node. </p>
<p>If the current node has no children, returns <code>null</code> , and retains the current node.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The new node, or <code>null</code> if the current node has no children.</dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname">Exceptions</td><td>from user code Any exceptions raised by a user-written Filter will propagate through. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="dom2__traversal_8cpp_source.html#l00306">306</a> of file <a class="el" href="dom2__traversal_8cpp_source.html">dom2_traversal.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="aa4eea50c409ad79e4f7c82afca8a4e75"></a><!-- doxytag: member="DOM::TreeWalker::nextNode" ref="aa4eea50c409ad79e4f7c82afca8a4e75" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classDOM_1_1Node.html">Node</a> TreeWalker::nextNode </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Moves the <code><a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a></code> to the next node in document order relative to the current node, and returns the new node. </p>
<p>If the current node has no next node, returns <code>null</code> , and retains the current node.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The new node, or <code>null</code> if the current node has no next node.</dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname">Exceptions</td><td>from user code Any exceptions raised by a user-written Filter will propagate through. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="dom2__traversal_8cpp_source.html#l00330">330</a> of file <a class="el" href="dom2__traversal_8cpp_source.html">dom2_traversal.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="adacbab406de14c222afbc9a2a8f3e35d"></a><!-- doxytag: member="DOM::TreeWalker::nextSibling" ref="adacbab406de14c222afbc9a2a8f3e35d" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classDOM_1_1Node.html">Node</a> TreeWalker::nextSibling </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Moves the <code><a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a></code> to the next sibling of the current node, and returns the new node. </p>
<p>If the current node has no next sibling, returns <code>null</code> , and retains the current node.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The new node, or <code>null</code> if the current node has no next sibling.</dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname">Exceptions</td><td>from user code Any exceptions raised by a user-written Filter will propagate through. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="dom2__traversal_8cpp_source.html#l00318">318</a> of file <a class="el" href="dom2__traversal_8cpp_source.html">dom2_traversal.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a48db084f49423c2a9b7926415d6a7d68"></a><!-- doxytag: member="DOM::TreeWalker::parentNode" ref="a48db084f49423c2a9b7926415d6a7d68" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classDOM_1_1Node.html">Node</a> TreeWalker::parentNode </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Moves to and returns the parent node of the current node. </p>
<p>If there is no parent node, or if the current node is the root node from which this <a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a> was created, retains the current position and returns null.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The new parent node, or null if the current node has no parent in the TreeWalker's logical view.</dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname">Exceptions</td><td>from user code Any exceptions raised by a user-written Filter will propagate through. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="dom2__traversal_8cpp_source.html#l00294">294</a> of file <a class="el" href="dom2__traversal_8cpp_source.html">dom2_traversal.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a0c85924bbba6e5158f5d8728c692945a"></a><!-- doxytag: member="DOM::TreeWalker::previousNode" ref="a0c85924bbba6e5158f5d8728c692945a" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classDOM_1_1Node.html">Node</a> TreeWalker::previousNode </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Moves the <code><a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a></code> to the previous node in document order relative to the current node, and returns the new node. </p>
<p>If the current node has no previous node, returns <code>null</code> , and retains the current node.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The new node, or <code>null</code> if the current node has no previous node.</dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname">Exceptions</td><td>from user code Any exceptions raised by a user-written Filter will propagate through. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="dom2__traversal_8cpp_source.html#l00324">324</a> of file <a class="el" href="dom2__traversal_8cpp_source.html">dom2_traversal.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ade39ce0a137678556b43737484483951"></a><!-- doxytag: member="DOM::TreeWalker::previousSibling" ref="ade39ce0a137678556b43737484483951" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classDOM_1_1Node.html">Node</a> TreeWalker::previousSibling </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Moves the <code><a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a></code> to the previous sibling of the current node, and returns the new node. </p>
<p>If the current node has no previous sibling, returns <code>null</code> , and retains the current node.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The new node, or <code>null</code> if the current node has no previous sibling.</dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname">Exceptions</td><td>from user code Any exceptions raised by a user-written Filter will propagate through. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="dom2__traversal_8cpp_source.html#l00312">312</a> of file <a class="el" href="dom2__traversal_8cpp_source.html">dom2_traversal.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a61d2f0414e445677ed68c4bfb19548fd"></a><!-- doxytag: member="DOM::TreeWalker::root" ref="a61d2f0414e445677ed68c4bfb19548fd" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classDOM_1_1Node.html">Node</a> TreeWalker::root </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The root node of the <a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a>, as specified when it was created. </p>
<p>Definition at line <a class="el" href="dom2__traversal_8cpp_source.html#l00259">259</a> of file <a class="el" href="dom2__traversal_8cpp_source.html">dom2_traversal.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a734f5d5ebb07d27f73fc20317c398ae2"></a><!-- doxytag: member="DOM::TreeWalker::setCurrentNode" ref="a734f5d5ebb07d27f73fc20317c398ae2" args="(const Node &_currentNode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void TreeWalker::setCurrentNode </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classDOM_1_1Node.html">Node</a> & </td>
<td class="paramname"><em>_currentNode</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>see currentNode </p>
<p>Definition at line <a class="el" href="dom2__traversal_8cpp_source.html#l00289">289</a> of file <a class="el" href="dom2__traversal_8cpp_source.html">dom2_traversal.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a6ff099191d7e697ceccd4f9ff164161e"></a><!-- doxytag: member="DOM::TreeWalker::whatToShow" ref="a6ff099191d7e697ceccd4f9ff164161e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">unsigned long TreeWalker::whatToShow </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This attribute determines which node types are presented via the <a class="el" href="classDOM_1_1TreeWalker.html" title="TreeWalker objects are used to navigate a document tree or subtree using the view of the document def...">TreeWalker</a>. </p>
<p>The available set of constants is defined in the <a class="el" href="classDOM_1_1NodeFilter.html" title="Filters are objects that know how to "filter out" nodes.">NodeFilter</a> interface. Nodes not accepted by whatToShow will be skipped, but their children may still be considered. Note that this skip takes precedence over the filter, if any. </p>
<p>Definition at line <a class="el" href="dom2__traversal_8cpp_source.html#l00265">265</a> of file <a class="el" href="dom2__traversal_8cpp_source.html">dom2_traversal.cpp</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="dom2__traversal_8h_source.html">dom2_traversal.h</a></li>
<li><a class="el" href="dom2__traversal_8cpp_source.html">dom2_traversal.cpp</a></li>
</ul>
</div>
</div></div>
</td>
</tr>
<tr>
<td valign="top" id="leftmenu" width="25%">
<a name="navigation"></a>
<div class="menu_box"><h2>khtml</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="namespacemembers.html">Namespace Members</a></li><li><a href="functions.html">Class Members</a></li><li><a href="pages.html">Related Pages</a></li></ul>
<!--
<h2>Class Picker</h2>
<div style="text-align: center;">
<form name="guideform">
<select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value">
<option value="annotated.html">-- Choose --</option>
<option value="classDOM_1_1AbstractView.html">dom::abstractview</option>, <option value="classDOM_1_1Attr.html">dom::attr</option>, <option value="classDOM_1_1CDATASection.html">dom::cdatasection</option>, <option value="classDOM_1_1CharacterData.html">dom::characterdata</option>, <option value="classDOM_1_1Comment.html">dom::comment</option>, <option value="classDOM_1_1Counter.html">dom::counter</option>, <option value="classDOM_1_1CSS2Azimuth.html">dom::css2azimuth</option>, <option value="classDOM_1_1CSS2BackgroundPosition.html">dom::css2backgroundposition</option>, <option value="classDOM_1_1CSS2BorderSpacing.html">dom::css2borderspacing</option>, <option value="classDOM_1_1CSS2CounterIncrement.html">dom::css2counterincrement</option>, <option value="classDOM_1_1CSS2CounterReset.html">dom::css2counterreset</option>, <option value="classDOM_1_1CSS2Cursor.html">dom::css2cursor</option>, <option value="classDOM_1_1CSS2FontFaceSrc.html">dom::css2fontfacesrc</option>, <option value="classDOM_1_1CSS2FontFaceWidths.html">dom::css2fontfacewidths</option>, <option value="classDOM_1_1CSS2PageSize.html">dom::css2pagesize</option>, <option value="classDOM_1_1CSS2PlayDuring.html">dom::css2playduring</option>, <option value="classDOM_1_1CSS2Properties.html">dom::css2properties</option>, <option value="classDOM_1_1CSS2TextShadow.html">dom::css2textshadow</option>, <option value="classDOM_1_1CSSCharsetRule.html">dom::csscharsetrule</option>, <option value="classDOM_1_1CSSException.html">dom::cssexception</option>, <option value="classDOM_1_1CSSFontFaceRule.html">dom::cssfontfacerule</option>, <option value="classDOM_1_1CSSImportRule.html">dom::cssimportrule</option>, <option value="classDOM_1_1CSSMediaRule.html">dom::cssmediarule</option>, <option value="classDOM_1_1CSSPrimitiveValue.html">dom::cssprimitivevalue</option>, <option value="classDOM_1_1CSSRule.html">dom::cssrule</option>, <option value="classDOM_1_1CSSRuleList.html">dom::cssrulelist</option>, <option value="classDOM_1_1CSSStyleDeclaration.html">dom::cssstyledeclaration</option>, <option value="classDOM_1_1CSSStyleRule.html">dom::cssstylerule</option>, <option value="classDOM_1_1CSSStyleSheet.html">dom::cssstylesheet</option>, <option value="classDOM_1_1CSSUnknownRule.html">dom::cssunknownrule</option>, <option value="classDOM_1_1CSSValue.html">dom::cssvalue</option>, <option value="classDOM_1_1CSSValueList.html">dom::cssvaluelist</option>, <option value="classDOM_1_1CustomNodeFilter.html">dom::customnodefilter</option>, <option value="classDOM_1_1Document.html">dom::document</option>, <option value="classDOM_1_1DocumentFragment.html">dom::documentfragment</option>, <option value="classDOM_1_1DocumentType.html">dom::documenttype</option>, <option value="classDOM_1_1DOMException.html">dom::domexception</option>, <option value="classDOM_1_1DOMImplementation.html">dom::domimplementation</option>, <option value="classDOM_1_1DOMString.html">dom::domstring</option>, <option value="classDOM_1_1Element.html">dom::element</option>, <option value="classDOM_1_1Entity.html">dom::entity</option>, <option value="classDOM_1_1EntityReference.html">dom::entityreference</option>, <option value="classDOM_1_1Event.html">dom::event</option>, <option value="classDOM_1_1EventException.html">dom::eventexception</option>, <option value="classDOM_1_1EventListener.html">dom::eventlistener</option>, <option value="classDOM_1_1HTMLAnchorElement.html">dom::htmlanchorelement</option>, <option value="classDOM_1_1HTMLAppletElement.html">dom::htmlappletelement</option>, <option value="classDOM_1_1HTMLAreaElement.html">dom::htmlareaelement</option>, <option value="classDOM_1_1HTMLBaseElement.html">dom::htmlbaseelement</option>, <option value="classDOM_1_1HTMLBaseFontElement.html">dom::htmlbasefontelement</option>, <option value="classDOM_1_1HTMLBlockquoteElement.html">dom::htmlblockquoteelement</option>, <option value="classDOM_1_1HTMLBodyElement.html">dom::htmlbodyelement</option>, <option value="classDOM_1_1HTMLBRElement.html">dom::htmlbrelement</option>, <option value="classDOM_1_1HTMLButtonElement.html">dom::htmlbuttonelement</option>, <option value="classDOM_1_1HTMLCollection.html">dom::htmlcollection</option>, <option value="classDOM_1_1HTMLDirectoryElement.html">dom::htmldirectoryelement</option>, <option value="classDOM_1_1HTMLDivElement.html">dom::htmldivelement</option>, <option value="classDOM_1_1HTMLDListElement.html">dom::htmldlistelement</option>, <option value="classDOM_1_1HTMLDocument.html">dom::htmldocument</option>, <option value="classDOM_1_1HTMLElement.html">dom::htmlelement</option>, <option value="classDOM_1_1HTMLFieldSetElement.html">dom::htmlfieldsetelement</option>, <option value="classDOM_1_1HTMLFontElement.html">dom::htmlfontelement</option>, <option value="classDOM_1_1HTMLFormElement.html">dom::htmlformelement</option>, <option value="classDOM_1_1HTMLFrameElement.html">dom::htmlframeelement</option>, <option value="classDOM_1_1HTMLFrameSetElement.html">dom::htmlframesetelement</option>, <option value="classDOM_1_1HTMLHeadElement.html">dom::htmlheadelement</option>, <option value="classDOM_1_1HTMLHeadingElement.html">dom::htmlheadingelement</option>, <option value="classDOM_1_1HTMLHRElement.html">dom::htmlhrelement</option>, <option value="classDOM_1_1HTMLHtmlElement.html">dom::htmlhtmlelement</option>, <option value="classDOM_1_1HTMLIFrameElement.html">dom::htmliframeelement</option>, <option value="classDOM_1_1HTMLImageElement.html">dom::htmlimageelement</option>, <option value="classDOM_1_1HTMLInputElement.html">dom::htmlinputelement</option>, <option value="classDOM_1_1HTMLIsIndexElement.html">dom::htmlisindexelement</option>, <option value="classDOM_1_1HTMLLabelElement.html">dom::htmllabelelement</option>, <option value="classDOM_1_1HTMLLayerElement.html">dom::htmllayerelement</option>, <option value="classDOM_1_1HTMLLegendElement.html">dom::htmllegendelement</option>, <option value="classDOM_1_1HTMLLIElement.html">dom::htmllielement</option>, <option value="classDOM_1_1HTMLLinkElement.html">dom::htmllinkelement</option>, <option value="classDOM_1_1HTMLMapElement.html">dom::htmlmapelement</option>, <option value="classDOM_1_1HTMLMenuElement.html">dom::htmlmenuelement</option>, <option value="classDOM_1_1HTMLMetaElement.html">dom::htmlmetaelement</option>, <option value="classDOM_1_1HTMLModElement.html">dom::htmlmodelement</option>, <option value="classDOM_1_1HTMLObjectElement.html">dom::htmlobjectelement</option>, <option value="classDOM_1_1HTMLOListElement.html">dom::htmlolistelement</option>, <option value="classDOM_1_1HTMLOptGroupElement.html">dom::htmloptgroupelement</option>, <option value="classDOM_1_1HTMLOptionElement.html">dom::htmloptionelement</option>, <option value="classDOM_1_1HTMLParagraphElement.html">dom::htmlparagraphelement</option>, <option value="classDOM_1_1HTMLParamElement.html">dom::htmlparamelement</option>, <option value="classDOM_1_1HTMLPreElement.html">dom::htmlpreelement</option>, <option value="classDOM_1_1HTMLQuoteElement.html">dom::htmlquoteelement</option>, <option value="classDOM_1_1HTMLScriptElement.html">dom::htmlscriptelement</option>, <option value="classDOM_1_1HTMLSelectElement.html">dom::htmlselectelement</option>, <option value="classDOM_1_1HTMLStyleElement.html">dom::htmlstyleelement</option>, <option value="classDOM_1_1HTMLTableCaptionElement.html">dom::htmltablecaptionelement</option>, <option value="classDOM_1_1HTMLTableCellElement.html">dom::htmltablecellelement</option>, <option value="classDOM_1_1HTMLTableColElement.html">dom::htmltablecolelement</option>, <option value="classDOM_1_1HTMLTableElement.html">dom::htmltableelement</option>, <option value="classDOM_1_1HTMLTableRowElement.html">dom::htmltablerowelement</option>, <option value="classDOM_1_1HTMLTableSectionElement.html">dom::htmltablesectionelement</option>, <option value="classDOM_1_1HTMLTextAreaElement.html">dom::htmltextareaelement</option>, <option value="classDOM_1_1HTMLTitleElement.html">dom::htmltitleelement</option>, <option value="classDOM_1_1HTMLUListElement.html">dom::htmlulistelement</option>, <option value="classDOM_1_1MediaList.html">dom::medialist</option>, <option value="classDOM_1_1MouseEvent.html">dom::mouseevent</option>, <option value="classDOM_1_1MutationEvent.html">dom::mutationevent</option>, <option value="classDOM_1_1NamedNodeMap.html">dom::namednodemap</option>, <option value="classDOM_1_1Node.html">dom::node</option>, <option value="classDOM_1_1NodeFilter.html">dom::nodefilter</option>, <option value="classDOM_1_1NodeIterator.html">dom::nodeiterator</option>, <option value="classDOM_1_1NodeList.html">dom::nodelist</option>, <option value="classDOM_1_1Notation.html">dom::notation</option>, <option value="classDOM_1_1ProcessingInstruction.html">dom::processinginstruction</option>, <option value="classDOM_1_1Rect.html">dom::rect</option>, <option value="classDOM_1_1RGBColor.html">dom::rgbcolor</option>, <option value="classDOM_1_1StyleSheet.html">dom::stylesheet</option>, <option value="classDOM_1_1StyleSheetList.html">dom::stylesheetlist</option>, <option value="classDOM_1_1Text.html">dom::text</option>, <option value="classDOM_1_1TextEvent.html">dom::textevent</option>, <option value="classDOM_1_1TreeWalker.html">dom::treewalker</option>, <option value="classDOM_1_1UIEvent.html">dom::uievent</option>, <option value="classKHTMLPageCache.html">khtmlpagecache</option>, <option value="classKHTMLPart.html">khtmlpart</option>, <option value="classKHTMLPartBrowserExtension.html">khtmlpartbrowserextension</option>, <option value="classKHTMLPartIface.html">khtmlpartiface</option>, <option value="classKHTMLSettings.html">khtmlsettings</option>, <option value="classKHTMLView.html">khtmlview</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../arts/html/index.html">arts</a></li><li><a href="../../dcop/html/index.html">dcop</a></li><li><a href="../../dnssd/html/index.html">dnssd</a></li><li><a href="../../interfaces/html/index.html">interfaces</a></li><li> <a href="../../interfaces/kimproxy/interface/html/index.html">interface</a></li><li> <a href="../../interfaces/kimproxy/library/html/index.html">library</a></li><li> <a href="../../interfaces/kspeech/html/index.html">kspeech</a></li><li> <a href="../../interfaces/ktexteditor/html/index.html">ktexteditor</a></li><li><a href="../../kabc/html/index.html">kabc</a></li><li><a href="../../kate/html/index.html">kate</a></li><li><a href="../../kcmshell/html/index.html">kcmshell</a></li><li><a href="../../kdecore/html/index.html">kdecore</a></li><li><a href="../../kded/html/index.html">kded</a></li><li><a href="../../kdefx/html/index.html">kdefx</a></li><li><a href="../../kdeprint/html/index.html">kdeprint</a></li><li><a href="../../kdesu/html/index.html">kdesu</a></li><li><a href="../../kdeui/html/index.html">kdeui</a></li><li><a href="../../kdoctools/html/index.html">kdoctools</a></li><li><a href="../../khtml/html/index.html">khtml</a></li><li><a href="../../kimgio/html/index.html">kimgio</a></li><li><a href="../../kinit/html/index.html">kinit</a></li><li><a href="../../kio/html/index.html">kio</a></li><li> <a href="../../kio/bookmarks/html/index.html">bookmarks</a></li><li> <a href="../../kio/httpfilter/html/index.html">httpfilter</a></li><li> <a href="../../kio/kfile/html/index.html">kfile</a></li><li> <a href="../../kio/kio/html/index.html">kio</a></li><li> <a href="../../kio/kioexec/html/index.html">kioexec</a></li><li> <a href="../../kio/kpasswdserver/html/index.html">kpasswdserver</a></li><li> <a href="../../kio/kssl/html/index.html">kssl</a></li><li><a href="../../kioslave/html/index.html">kioslave</a></li><li> <a href="../../kioslave/http/html/index.html">http</a></li><li><a href="../../kjs/html/index.html">kjs</a></li><li><a href="../../kmdi/html/index.html">kmdi</a></li><li> <a href="../../kmdi/kmdi/html/index.html">kmdi</a></li><li><a href="../../knewstuff/html/index.html">knewstuff</a></li><li><a href="../../kparts/html/index.html">kparts</a></li><li><a href="../../kresources/html/index.html">kresources</a></li><li><a href="../../kspell2/html/index.html">kspell2</a></li><li><a href="../../kunittest/html/index.html">kunittest</a></li><li><a href="../../kutils/html/index.html">kutils</a></li><li><a href="../../kwallet/html/index.html">kwallet</a></li><li><a href="../../libkmid/html/index.html">libkmid</a></li><li><a href="../../libkscreensaver/html/index.html">libkscreensaver</a></li>
</ul></div></div>
</td>
</tr>
</table>
<span class="doNotDisplay">
<a href="http://www.kde.org/" accesskey="8">KDE Home</a> |
<a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> |
<a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a>
</span>
<div style="height: 8px"></div>
<div id="footer">
<div id="footer_left">
Maintained by <a href="mailto:groot@kde.org">Adriaan de Groot</a>
and
<a href="mailto:winter@kde.org">Allen Winter</a>.
<br/>
KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
<a href="http://www.kde.org/contact/impressum.php">Legal</a>
</div>
<div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div>
</div>
<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a>
WARNING END
-->
</body>
</html>
