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 Description

static String POWERPOINT_DOCUMENT
Powerpoint document entry/stream name

static String PP95_DOCUMENT

static String PP97_DOCUMENT

Constructor Summary

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

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`int`	`addControl(String name, String progId)`	Add a control in this presentation
`int`	`addEmbed(POIFSFileSystem poiData)`	Add a embedded object to this presentation
`HSLFFontInfo`	`addFont(InputStream fontData)`	Add a font in this presentation and also embed its font data
`HSLFFontInfo`	`addFont(FontInfo fontInfo)`	Add a font in this presentation
`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 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
    
    RuntimeException - 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
    
    RuntimeException - 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
    
    RuntimeException - 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 a 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 AutoCloseable
    
    Specified by:
    
    close in interface Closeable
    
    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

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

Class HSLFSlideShow

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

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

Field Detail

POWERPOINT_DOCUMENT

PP97_DOCUMENT

PP95_DOCUMENT

Constructor Detail

HSLFSlideShow

HSLFSlideShow

HSLFSlideShow

HSLFSlideShow

HSLFSlideShow

Method Detail

setMaxRecordLength

getMaxRecordLength

getCoreRecordForSAS

getCoreRecordForRefID

write

getMostRecentCoreRecords

getSlides

getNotes

getSlideMasters

getTitleMasters

getPictureData

getEmbeddedObjects

getSoundData

getPageSize

setPageSize

getDocumentRecord

reorderSlide

removeSlide

createSlide

addPicture

addPicture

addPicture

findPictureData

addFont

addFont

getFont

getNumberOfFonts

getFonts

getSlideHeadersFooters

getNotesHeadersFooters

addMovie

addControl

addEmbed

getMetadataTextExtractor

createMasterSheet

getSlideShowImpl

close

getPersistDocument

getGenericProperties

getGenericChildren

write

write

getDocumentSummaryInformation

getSummaryInformation

createInformationProperties

readProperties

getPropertySet

getPropertySet

writeProperties

writeProperties

writeProperties

validateInPlaceWritePossible

getDirectory

clearDirectory

initDirectory

replaceDirectory

getEncryptedPropertyStreamName

getEncryptionInfo