org.zkoss.poi.hslf.extractor

Class PowerPointExtractor

java.lang.Object

org.zkoss.poi.POITextExtractor

org.zkoss.poi.POIOLE2TextExtractor

org.zkoss.poi.hslf.extractor.PowerPointExtractor

public final class PowerPointExtractor
extends POIOLE2TextExtractor

This class can be used to extract text from a PowerPoint file. Can optionally also get the notes from one.

Author:

Nick Burch

Field Summary

Fields inherited from class org.zkoss.poi.POITextExtractor

document

Constructor Summary

Constructors

Constructor and Description
PowerPointExtractor(DirectoryNode dir) Creates a PowerPointExtractor, from a specific place inside an open NPOIFSFileSystem
PowerPointExtractor(DirectoryNode dir, POIFSFileSystem fs) Deprecated. Use PowerPointExtractor(DirectoryNode) instead
PowerPointExtractor(HSLFSlideShow ss) Creates a PowerPointExtractor, from a HSLFSlideShow
PowerPointExtractor(InputStream iStream) Creates a PowerPointExtractor, from an Input Stream
PowerPointExtractor(NPOIFSFileSystem fs) Creates a PowerPointExtractor, from an open NPOIFSFileSystem
PowerPointExtractor(POIFSFileSystem fs) Creates a PowerPointExtractor, from an open POIFSFileSystem
PowerPointExtractor(String fileName) Creates a PowerPointExtractor, from a file

Method Summary

Modifier and Type	Method and Description
String	getNotes() Fetches all the notes text from the slideshow, but not the slide text
List<OLEShape>	getOLEShapes()
String	getText() Fetches all the slide text from the slideshow, but not the notes, unless you've called setSlidesByDefault() and setNotesByDefault() to change this
String	getText(boolean getSlideText, boolean getNoteText) Fetches text from the slideshow, be it slide text or note text.
String	getText(boolean getSlideText, boolean getNoteText, boolean getCommentText, boolean getMasterText)
static void	main(String[] args) Basic extractor.
void	setCommentsByDefault(boolean commentsByDefault) Should a call to getText() return comments text? Default is no
void	setMasterByDefault(boolean masterByDefault) Should a call to getText() return text from master? Default is no
void	setNotesByDefault(boolean notesByDefault) Should a call to getText() return notes text? Default is no
void	setSlidesByDefault(boolean slidesByDefault) Should a call to getText() return slide text? Default is yes

Methods inherited from class org.zkoss.poi.POIOLE2TextExtractor

getDocSummaryInformation, getFileSystem, getMetadataTextExtractor, getRoot, getSummaryInformation

Methods inherited from class java.lang.Object

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

Constructor Detail

PowerPointExtractor

public PowerPointExtractor(String fileName)
                    throws IOException

Creates a PowerPointExtractor, from a file

Parameters:

fileName - The name of the file to extract from

Throws:

IOException

PowerPointExtractor

public PowerPointExtractor(InputStream iStream)
                    throws IOException

Creates a PowerPointExtractor, from an Input Stream

Parameters:

iStream - The input stream containing the PowerPoint document

Throws:

IOException

PowerPointExtractor

public PowerPointExtractor(POIFSFileSystem fs)
                    throws IOException

Creates a PowerPointExtractor, from an open POIFSFileSystem

Parameters:

fs - the POIFSFileSystem containing the PowerPoint document

Throws:

IOException

PowerPointExtractor

public PowerPointExtractor(NPOIFSFileSystem fs)
                    throws IOException

Creates a PowerPointExtractor, from an open NPOIFSFileSystem

Parameters:

fs - the NPOIFSFileSystem containing the PowerPoint document

Throws:

IOException

PowerPointExtractor

public PowerPointExtractor(DirectoryNode dir)
                    throws IOException

Creates a PowerPointExtractor, from a specific place inside an open NPOIFSFileSystem

Parameters:

dir - the POIFS Directory containing the PowerPoint document

Throws:

IOException

PowerPointExtractor

@Deprecated
public PowerPointExtractor(DirectoryNode dir,
                                       POIFSFileSystem fs)
                                throws IOException

Deprecated. Use PowerPointExtractor(DirectoryNode) instead

Throws:

IOException

PowerPointExtractor

public PowerPointExtractor(HSLFSlideShow ss)

Creates a PowerPointExtractor, from a HSLFSlideShow

Parameters:

ss - the HSLFSlideShow to extract text from

Method Detail

main

public static void main(String[] args)
                 throws IOException

Basic extractor. Returns all the text, and optionally all the notes

Throws:

IOException

setSlidesByDefault

public void setSlidesByDefault(boolean slidesByDefault)

Should a call to getText() return slide text? Default is yes

setNotesByDefault

public void setNotesByDefault(boolean notesByDefault)

Should a call to getText() return notes text? Default is no

setCommentsByDefault

public void setCommentsByDefault(boolean commentsByDefault)

Should a call to getText() return comments text? Default is no

setMasterByDefault

public void setMasterByDefault(boolean masterByDefault)

Should a call to getText() return text from master? Default is no

getText

public String getText()

Fetches all the slide text from the slideshow, but not the notes, unless you've called setSlidesByDefault() and setNotesByDefault() to change this

Specified by:

getText in class POITextExtractor

Returns:

All the text from the document

getNotes

public String getNotes()

Fetches all the notes text from the slideshow, but not the slide text

getOLEShapes

public List<OLEShape> getOLEShapes()

getText

public String getText(boolean getSlideText,
                      boolean getNoteText)

Fetches text from the slideshow, be it slide text or note text. Because the final block of text in a TextRun normally have their last \n stripped, we add it back

Parameters:

getSlideText - fetch slide text

getNoteText - fetch note text

getText

public String getText(boolean getSlideText,
                      boolean getNoteText,
                      boolean getCommentText,
                      boolean getMasterText)