Package org.apache.poi.poifs.property

Class DirectoryProperty

java.lang.Object

org.apache.poi.poifs.property.Property

org.apache.poi.poifs.property.DirectoryProperty

All Implemented Interfaces:

Iterable<Property>, POIFSViewable, Child, Parent

Direct Known Subclasses:

RootProperty

public class DirectoryProperty
extends Property
implements Parent, Iterable<Property>

Directory property

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DirectoryProperty.PropertyComparator

Constructor Summary

Constructors

Constructor	Description
DirectoryProperty(String name)	Default constructor

Method Summary

Modifier and Type	Method	Description
void	addChild(Property property)	Add a new child to the collection of children
boolean	changeName(Property property, String newName)	Change a Property's name
boolean	deleteChild(Property property)	Delete a Property
Iterator<Property>	getChildren()	Get an iterator over the children of this Parent; all elements are instances of Property.
boolean	isDirectory()
Iterator<Property>	iterator()	Get an iterator over the children of this Parent, alias for getChildren() which supports foreach use
Spliterator<Property>	spliterator()	Get a spliterator over the children of this Parent; all elements are instances of Property.

Methods inherited from class org.apache.poi.poifs.property.Property

getName, getNextChild, getPreviousChild, getShortDescription, getSize, getStartBlock, getStorageClsid, getViewableArray, getViewableIterator, isSmall, preferArray, setNextChild, setPreviousChild, setStartBlock, setStorageClsid, shouldUseSmallBlocks, writeData

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.poi.poifs.property.Child

getNextChild, getPreviousChild

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface org.apache.poi.poifs.property.Parent

setNextChild, setPreviousChild

Constructor Details

DirectoryProperty

public DirectoryProperty(String name)

Default constructor

Parameters:

name - the name of the directory

Method Details

changeName

public boolean changeName(Property property,
 String newName)

Change a Property's name

Parameters:

property - the Property whose name is being changed

newName - the new name for the Property

Returns:

true if the name change could be made, else false

deleteChild

public boolean deleteChild(Property property)

Delete a Property

Parameters:

property - the Property being deleted

Returns:

true if the Property could be deleted, else false

isDirectory

public boolean isDirectory()

Specified by:

isDirectory in class Property

Returns:

true if a directory type Property

getChildren

public Iterator<Property> getChildren()

Get an iterator over the children of this Parent; all elements are instances of Property.

Specified by:

getChildren in interface Parent

Returns:

Iterator of children; may refer to an empty collection

iterator

public Iterator<Property> iterator()

Get an iterator over the children of this Parent, alias for getChildren() which supports foreach use

Specified by:

iterator in interface Iterable<Property>

spliterator

public Spliterator<Property> spliterator()

Get a spliterator over the children of this Parent; all elements are instances of Property.

Specified by:

spliterator in interface Iterable<Property>

Returns:

Spliterator of children; may refer to an empty collection

Since:

POI 5.2.0

addChild

public void addChild(Property property)
              throws IOException

Add a new child to the collection of children

Specified by:

addChild in interface Parent

Parameters:

property - the new child to be added; must not be null

Throws:

IOException - if we already have a child with the same name