org.apache.poi.hslf.usermodel

Class HSLFSlideShow

java.lang.Object

org.apache.poi.POIDocument

org.apache.poi.hslf.usermodel.HSLFSlideShow

All Implemented Interfaces:

Closeable, AutoCloseable, GenericRecord, SlideShow<HSLFShape,HSLFTextParagraph>

public final class HSLFSlideShow
extends POIDocument
implements SlideShow<HSLFShape,HSLFTextParagraph>, Closeable, GenericRecord

This class is a friendly wrapper on top of the more scary HSLFSlideShow. TODO: - figure out how to match notes to their correct sheet (will involve understanding DocSlideList and DocNotesList) - handle Slide creation cleaner

Field Summary

Fields

Modifier and Type	Field and Description
static String	POWERPOINT_DOCUMENT Powerpoint document entry/stream name
static String	PP95_DOCUMENT
static String	PP97_DOCUMENT

Constructor Summary

Constructors

Constructor and Description
HSLFSlideShow() Constructs a new, empty, Powerpoint document.
HSLFSlideShow(DirectoryNode root) Constructs a Powerpoint document from an DirectoryNode.
HSLFSlideShow(HSLFSlideShowImpl hslfSlideShow) Constructs a Powerpoint document from the underlying HSLFSlideShow object.
HSLFSlideShow(InputStream inputStream) Constructs a Powerpoint document from an input stream.
HSLFSlideShow(POIFSFileSystem poifs) Constructs a Powerpoint document from an POIFSFileSystem.

Method Summary

Modifier and Type	Method and Description
int	addControl(String name, String progId) Add a control in this presentation
int	addEmbed(POIFSFileSystem poiData) Add an embedded object to this presentation
HSLFFontInfo	addFont(FontInfo fontInfo) Add a font in this presentation
HSLFFontInfo	addFont(InputStream fontData) Add a font in this presentation and also embed its font data
int	addMovie(String path, int type) Add a movie in this presentation
HSLFPictureData	addPicture(byte[] data, PictureData.PictureType format)
HSLFPictureData	addPicture(File pict, PictureData.PictureType format) Adds a picture to the presentation.
HSLFPictureData	addPicture(InputStream is, PictureData.PictureType format) Adds a picture to the presentation.
protected void	clearDirectory()
void	close()
void	createInformationProperties()
MasterSheet<HSLFShape,HSLFTextParagraph>	createMasterSheet()
HSLFSlide	createSlide() Create a blank Slide.
HSLFPictureData	findPictureData(byte[] pictureData) check if a picture with this picture data already exists in this presentation
Record	getCoreRecordForRefID(int refID) For a given refID (the internal, 0 based numbering scheme), return the core record
Record	getCoreRecordForSAS(SlideListWithText.SlideAtomsSet sas) For a given SlideAtomsSet, return the core record, based on the refID from the SlidePersistAtom
DirectoryNode	getDirectory()
Document	getDocumentRecord() Helper method for usermodel and model: Get the document record
DocumentSummaryInformation	getDocumentSummaryInformation()
HSLFObjectData[]	getEmbeddedObjects() Returns the data of all the embedded OLE object in the SlideShow
protected String	getEncryptedPropertyStreamName()
EncryptionInfo	getEncryptionInfo()
HSLFFontInfo	getFont(int idx) Get a font by index
List<HSLFFontInfo>	getFonts()
List<? extends GenericRecord>	getGenericChildren()
Map<String,Supplier<?>>	getGenericProperties()
static int	getMaxRecordLength()
HPSFPropertiesExtractor	getMetadataTextExtractor()
Record[]	getMostRecentCoreRecords() Returns an array of the most recent version of all the interesting records
List<HSLFNotes>	getNotes() Returns an array of all the normal Notes found in the slideshow
HeadersFooters	getNotesHeadersFooters() Return Header / Footer settings for notes
int	getNumberOfFonts() get the number of fonts in the presentation
Dimension	getPageSize()
Object	getPersistDocument()
List<HSLFPictureData>	getPictureData()
protected PropertySet	getPropertySet(String setName)
protected PropertySet	getPropertySet(String setName, EncryptionInfo encryptionInfo)
HeadersFooters	getSlideHeadersFooters() Return Header / Footer settings for slides
List<HSLFSlideMaster>	getSlideMasters() Returns an array of all the normal Slide Masters found in the slideshow
List<HSLFSlide>	getSlides() Returns an array of all the normal Slides found in the slideshow
HSLFSlideShowImpl	getSlideShowImpl()
HSLFSoundData[]	getSoundData() Returns the data of all the embedded sounds in the SlideShow
SummaryInformation	getSummaryInformation()
List<HSLFTitleMaster>	getTitleMasters() Returns an array of all the normal Title Masters found in the slideshow
protected boolean	initDirectory()
void	readProperties()
HSLFSlide	removeSlide(int index) Removes the slide at the given index (0-based).
void	reorderSlide(int oldSlideNumber, int newSlideNumber) Re-orders a slide, to a new position.
protected void	replaceDirectory(DirectoryNode newDirectory)
static void	setMaxRecordLength(int length)
void	setPageSize(Dimension pgsize)
protected void	validateInPlaceWritePossible()
void	write()
void	write(File newFile)
void	write(OutputStream out)
protected void	writeProperties()
void	writeProperties(POIFSFileSystem outFS)
protected void	writeProperties(POIFSFileSystem outFS, List<String> writtenEntries)

Methods inherited from class org.apache.poi.POIDocument

readProperties

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.poi.common.usermodel.GenericRecord

getGenericRecordType

Field Detail

POWERPOINT_DOCUMENT

public static final String POWERPOINT_DOCUMENT

Powerpoint document entry/stream name

See Also:

Constant Field Values

PP97_DOCUMENT

public static final String PP97_DOCUMENT

See Also:

Constant Field Values

PP95_DOCUMENT

public static final String PP95_DOCUMENT

See Also:

Constant Field Values

Constructor Detail

HSLFSlideShow

public HSLFSlideShow(HSLFSlideShowImpl hslfSlideShow)

Constructs a Powerpoint document from the underlying HSLFSlideShow object. Finds the model stuff from this

Parameters:

hslfSlideShow - the HSLFSlideShow to base on

HSLFSlideShow

public HSLFSlideShow()

Constructs a new, empty, Powerpoint document.

HSLFSlideShow

public HSLFSlideShow(InputStream inputStream)
              throws IOException

Constructs a Powerpoint document from an input stream.

Throws:

IOException - If reading data from the stream fails

IllegalStateException - a number of runtime exceptions can be thrown, especially if there are problems with the input format

HSLFSlideShow

public HSLFSlideShow(POIFSFileSystem poifs)
              throws IOException

Constructs a Powerpoint document from an POIFSFileSystem.

Throws:

IOException - If reading data from the file-system fails

IllegalStateException - a number of runtime exceptions can be thrown, especially if there are problems with the input format

HSLFSlideShow

public HSLFSlideShow(DirectoryNode root)
              throws IOException

Constructs a Powerpoint document from an DirectoryNode.

Throws:

IOException - If reading data from the DirectoryNode fails

IllegalStateException - a number of runtime exceptions can be thrown, especially if there are problems with the input format

Method Detail

setMaxRecordLength

public static void setMaxRecordLength(int length)

Parameters:

length - the max record length allowed for HSLFSlideShow

getMaxRecordLength

public static int getMaxRecordLength()

Returns:

the max record length allowed for HSLFSlideShow

getCoreRecordForSAS

public Record getCoreRecordForSAS(SlideListWithText.SlideAtomsSet sas)

For a given SlideAtomsSet, return the core record, based on the refID from the SlidePersistAtom

getCoreRecordForRefID

public Record getCoreRecordForRefID(int refID)

For a given refID (the internal, 0 based numbering scheme), return the core record

Parameters:

refID - the refID

write

public void write(OutputStream out)
           throws IOException

Specified by:

write in interface SlideShow<HSLFShape,HSLFTextParagraph>

Specified by:

write in class POIDocument

Throws:

IOException

getMostRecentCoreRecords

public Record[] getMostRecentCoreRecords()

Returns an array of the most recent version of all the interesting records

getSlides

public List<HSLFSlide> getSlides()

Returns an array of all the normal Slides found in the slideshow

Specified by:

getSlides in interface SlideShow<HSLFShape,HSLFTextParagraph>

getNotes

public List<HSLFNotes> getNotes()

Returns an array of all the normal Notes found in the slideshow

getSlideMasters

public List<HSLFSlideMaster> getSlideMasters()

Returns an array of all the normal Slide Masters found in the slideshow

Specified by:

getSlideMasters in interface SlideShow<HSLFShape,HSLFTextParagraph>

getTitleMasters

public List<HSLFTitleMaster> getTitleMasters()

Returns an array of all the normal Title Masters found in the slideshow

getPictureData

public List<HSLFPictureData> getPictureData()

Specified by:

getPictureData in interface SlideShow<HSLFShape,HSLFTextParagraph>

getEmbeddedObjects

public HSLFObjectData[] getEmbeddedObjects()

Returns the data of all the embedded OLE object in the SlideShow

getSoundData

public HSLFSoundData[] getSoundData()

Returns the data of all the embedded sounds in the SlideShow

getPageSize

public Dimension getPageSize()

Specified by:

getPageSize in interface SlideShow<HSLFShape,HSLFTextParagraph>

setPageSize

public void setPageSize(Dimension pgsize)

Specified by:

setPageSize in interface SlideShow<HSLFShape,HSLFTextParagraph>

getDocumentRecord

public Document getDocumentRecord()

Helper method for usermodel and model: Get the document record

reorderSlide

public void reorderSlide(int oldSlideNumber,
                         int newSlideNumber)

Re-orders a slide, to a new position.

Parameters:

oldSlideNumber - The old slide number (1 based)

newSlideNumber - The new slide number (1 based)

removeSlide

public HSLFSlide removeSlide(int index)

Removes the slide at the given index (0-based).

Shifts any subsequent slides to the left (subtracts one from their slide numbers).

Parameters:

index - the index of the slide to remove (0-based)

Returns:

the slide that was removed from the slide show.

createSlide

public HSLFSlide createSlide()

Create a blank Slide.

Specified by:

createSlide in interface SlideShow<HSLFShape,HSLFTextParagraph>

Returns:

the created Slide

addPicture

public HSLFPictureData addPicture(byte[] data,
                                  PictureData.PictureType format)
                           throws IOException

Specified by:

addPicture in interface SlideShow<HSLFShape,HSLFTextParagraph>

Throws:

IOException

addPicture

public HSLFPictureData addPicture(InputStream is,
                                  PictureData.PictureType format)
                           throws IOException

Adds a picture to the presentation.

Specified by:

addPicture in interface SlideShow<HSLFShape,HSLFTextParagraph>

Parameters:

is - The stream to read the image from

format - The format of the picture.

Returns:

the picture data.

Throws:

IOException

Since:

3.15 beta 2

addPicture

public HSLFPictureData addPicture(File pict,
                                  PictureData.PictureType format)
                           throws IOException

Adds a picture to the presentation.

Specified by:

addPicture in interface SlideShow<HSLFShape,HSLFTextParagraph>

Parameters:

pict - the file containing the image to add

format - The format of the picture.

Returns:

the picture data.

Throws:

IOException

Since:

3.15 beta 2

findPictureData

public HSLFPictureData findPictureData(byte[] pictureData)

check if a picture with this picture data already exists in this presentation

Specified by:

findPictureData in interface SlideShow<HSLFShape,HSLFTextParagraph>

Parameters:

pictureData - The picture data to find in the SlideShow

Returns:

null if picture data is not found in this slideshow

Since:

3.15 beta 3

addFont

public HSLFFontInfo addFont(FontInfo fontInfo)

Add a font in this presentation

Parameters:

fontInfo - the font to add

Returns:

the registered HSLFFontInfo - the font info object is unique based on the typeface

addFont

public HSLFFontInfo addFont(InputStream fontData)
                     throws IOException

Add a font in this presentation and also embed its font data

Specified by:

addFont in interface SlideShow<HSLFShape,HSLFTextParagraph>

Parameters:

fontData - the EOT font data as stream

Returns:

the registered HSLFFontInfo - the font info object is unique based on the typeface

Throws:

IOException

Since:

POI 4.1.0

getFont

public HSLFFontInfo getFont(int idx)

Get a font by index

Parameters:

idx - 0-based index of the font

Returns:

of an instance of PPFont or null if not found

getNumberOfFonts

public int getNumberOfFonts()

get the number of fonts in the presentation

Returns:

number of fonts

getFonts

public List<HSLFFontInfo> getFonts()

Specified by:

getFonts in interface SlideShow<HSLFShape,HSLFTextParagraph>

getSlideHeadersFooters

public HeadersFooters getSlideHeadersFooters()

Return Header / Footer settings for slides

Returns:

Header / Footer settings for slides

getNotesHeadersFooters

public HeadersFooters getNotesHeadersFooters()

Return Header / Footer settings for notes

Returns:

Header / Footer settings for notes

addMovie

public int addMovie(String path,
                    int type)

Add a movie in this presentation

Parameters:

path - the path or url to the movie

Returns:

0-based index of the movie

addControl

public int addControl(String name,
                      String progId)

Add a control in this presentation

Parameters:

name - name of the control, e.g. "Shockwave Flash Object"

progId - OLE Programmatic Identifier, e.g. "ShockwaveFlash.ShockwaveFlash.9"

Returns:

0-based index of the control

addEmbed

public int addEmbed(POIFSFileSystem poiData)

Add an embedded object to this presentation

Returns:

0-based index of the embedded object

getMetadataTextExtractor

public HPSFPropertiesExtractor getMetadataTextExtractor()

Specified by:

getMetadataTextExtractor in interface SlideShow<HSLFShape,HSLFTextParagraph>

createMasterSheet

public MasterSheet<HSLFShape,HSLFTextParagraph> createMasterSheet()

Specified by:

createMasterSheet in interface SlideShow<HSLFShape,HSLFTextParagraph>

getSlideShowImpl

@Internal
public HSLFSlideShowImpl getSlideShowImpl()

Returns:

the handler class which holds the hslf records

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class POIDocument

Throws:

IOException

getPersistDocument

public Object getPersistDocument()

Specified by:

getPersistDocument in interface SlideShow<HSLFShape,HSLFTextParagraph>

getGenericProperties

public Map<String,Supplier<?>> getGenericProperties()

Specified by:

getGenericProperties in interface GenericRecord

getGenericChildren

public List<? extends GenericRecord> getGenericChildren()

Specified by:

getGenericChildren in interface GenericRecord

write

public void write()
           throws IOException

Specified by:

write in class POIDocument

Throws:

IOException

write

public void write(File newFile)
           throws IOException

Specified by:

write in class POIDocument

Throws:

IOException

getDocumentSummaryInformation

public DocumentSummaryInformation getDocumentSummaryInformation()

Overrides:

getDocumentSummaryInformation in class POIDocument

getSummaryInformation

public SummaryInformation getSummaryInformation()

Overrides:

getSummaryInformation in class POIDocument

createInformationProperties

public void createInformationProperties()

Overrides:

createInformationProperties in class POIDocument

readProperties

public void readProperties()

Overrides:

readProperties in class POIDocument

getPropertySet

protected PropertySet getPropertySet(String setName)
                              throws IOException

Overrides:

getPropertySet in class POIDocument

Throws:

IOException

getPropertySet

protected PropertySet getPropertySet(String setName,
                                     EncryptionInfo encryptionInfo)
                              throws IOException

Overrides:

getPropertySet in class POIDocument

Throws:

IOException

writeProperties

protected void writeProperties()
                        throws IOException

Overrides:

writeProperties in class POIDocument

Throws:

IOException

writeProperties

public void writeProperties(POIFSFileSystem outFS)
                     throws IOException

Overrides:

writeProperties in class POIDocument

Throws:

IOException

writeProperties

protected void writeProperties(POIFSFileSystem outFS,
                               List<String> writtenEntries)
                        throws IOException

Overrides:

writeProperties in class POIDocument

Throws:

IOException

validateInPlaceWritePossible

protected void validateInPlaceWritePossible()
                                     throws IllegalStateException

Overrides:

validateInPlaceWritePossible in class POIDocument

Throws:

IllegalStateException

getDirectory

public DirectoryNode getDirectory()

Overrides:

getDirectory in class POIDocument

clearDirectory

protected void clearDirectory()

Overrides:

clearDirectory in class POIDocument

initDirectory

protected boolean initDirectory()

Overrides:

initDirectory in class POIDocument

replaceDirectory

protected void replaceDirectory(DirectoryNode newDirectory)
                         throws IOException

Overrides:

replaceDirectory in class POIDocument

Throws:

IOException

getEncryptedPropertyStreamName

protected String getEncryptedPropertyStreamName()

Overrides:

getEncryptedPropertyStreamName in class POIDocument

getEncryptionInfo

public EncryptionInfo getEncryptionInfo()

Overrides:

getEncryptionInfo in class POIDocument