This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.


javax.swing.text
class ElementIterator

java.lang.Object extended by javax.swing.text.ElementIterator
All Implemented Interfaces:
Cloneable

Most common way to construct:

Document doc = …;

ElementIterator it = new ElementIterator(doc);

Based on 34 examples


public class ElementIterator
extends Object
implements Cloneable

ElementIterator, as the name suggests, iteratates over the Element tree. The constructor can be invoked with either Document or an Element as an argument. If the constructor is invoked with a Document as an argument then the root of the iteration is the return value of document.getDefaultRootElement(). The iteration happens in a depth-first manner. In terms of how boundary conditions are handled: a) if next() is called before first() or current(), the root will be returned. b) next() returns null to indicate the end of the list. c) previous() returns null when the current element is the root or next() has returned null. The ElementIterator does no locking of the Element tree. This means that it does not track any changes. It is the responsibility of the user of this class, to ensure that no changes happen during element iteration. Simple usage example: public void iterate() { ElementIterator it = new ElementIterator(root); Element elem; while (true) { if ((elem = next()) != null) { // process element System.out.println("elem: " + elem.getName()); } else { break; } } }


Constructor Summary

          Creates a new ElementIterator.

          Creates a new ElementIterator.
 
Method Summary
 Object

          Clones the ElementIterator.
 Element

          Fetches the current Element.
 int

          Fetches the current depth of element tree.
 Element

          Fetches the first element.
 Element

          Fetches the next Element.
 Element

          Fetches the previous Element.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ElementIterator

public ElementIterator(Document document)
Creates a new ElementIterator. The root element is taken to get the default root element of the document.

Parameters:
document - a Document.

ElementIterator

public ElementIterator(Element root)
Creates a new ElementIterator.

Parameters:
root - the root Element.
Method Detail

clone

public synchronized Object clone()
Clones the ElementIterator.

Overrides:
clone in class Object
Returns:
a cloned ElementIterator Object.

current

public Element current()
Fetches the current Element.

Returns:
element on top of the stack or null if the root element is null

depth

public int depth()
Fetches the current depth of element tree.

Returns:
the depth.

first

public Element first()
Fetches the first element.

Returns:
an Element.

next

public Element next()
Fetches the next Element. The strategy used to locate the next element is a depth-first search.

Returns:
the next element or null at the end of the list.

previous

public Element previous()
Fetches the previous Element. If howver the current element is the last element, or the current element is null, then null is returned.

Returns:
previous Element if available


This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.
This page displays the Jadeite version of the documention, which is derived from the offical documentation that contains this copyright notice:
Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
The official Sun™ documentation can be found here at http://java.sun.com/javase/6/docs/api/.