HSLFSlideShow (POI API Documentation)

java.lang.Object
- org.apache.poi.hslf.usermodel.HSLFSlideShow

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, SlideShow<HSLFShape,HSLFTextParagraph>
```
public final class HSLFSlideShow
extends java.lang.Object
implements SlideShow<HSLFShape,HSLFTextParagraph>, java.io.Closeable
```
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 java.lang.String POWERPOINT_DOCUMENT
Powerpoint document entry/stream name

static java.lang.String PP95_DOCUMENT

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`POWERPOINT_DOCUMENT` Powerpoint document entry/stream name
`static java.lang.String`	`PP95_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(java.io.InputStream inputStream)` Constructs a Powerpoint document from an input stream.
`HSLFSlideShow(POIFSFileSystem poifs)` Constructs a Powerpoint document from an POIFSFileSystem.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`addControl(java.lang.String name, java.lang.String progId)` Add a control in this presentation
`int`	`addEmbed(POIFSFileSystem poiData)` Add a embedded object to this presentation
`HSLFFontInfo`	`addFont(FontInfo fontInfo)` Add a font in this presentation
`HSLFFontInfo`	`addFont(java.io.InputStream fontData)` Add a font in this presentation and also embed its font data
`int`	`addMovie(java.lang.String path, int type)` Add a movie in this presentation
`HSLFPictureData`	`addPicture(byte[] data, PictureData.PictureType format)`
`HSLFPictureData`	`addPicture(java.io.File pict, PictureData.PictureType format)` Adds a picture to the presentation.
`HSLFPictureData`	`addPicture(java.io.InputStream is, PictureData.PictureType format)` Adds a picture to the presentation.
`void`	`close()`
`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
`Document`	`getDocumentRecord()` Helper method for usermodel and model: Get the document record
`HSLFObjectData[]`	`getEmbeddedObjects()` Returns the data of all the embedded OLE object in the SlideShow
`HSLFFontInfo`	`getFont(int idx)` Get a font by index
`java.util.List<HSLFFontInfo>`	`getFonts()`
`HPSFPropertiesExtractor`	`getMetadataTextExtractor()`
`Record[]`	`getMostRecentCoreRecords()` Returns an array of the most recent version of all the interesting records
`java.util.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
`java.awt.Dimension`	`getPageSize()`
`java.lang.Object`	`getPersistDocument()`
`java.util.List<HSLFPictureData>`	`getPictureData()`
`HeadersFooters`	`getSlideHeadersFooters()` Return Header / Footer settings for slides
`java.util.List<HSLFSlideMaster>`	`getSlideMasters()` Returns an array of all the normal Slide Masters found in the slideshow
`java.util.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
`java.util.List<HSLFTitleMaster>`	`getTitleMasters()` Returns an array of all the normal Title Masters found in the slideshow
`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.
`void`	`setPageSize(java.awt.Dimension pgsize)`
`void`	`write(java.io.OutputStream out)`

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

- Field Detail
  - POWERPOINT_DOCUMENT
```
public static final java.lang.String POWERPOINT_DOCUMENT
```
    Powerpoint document entry/stream name
    
    See Also:
    
    Constant Field Values
  - PP95_DOCUMENT
```
public static final java.lang.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(java.io.InputStream inputStream)
              throws java.io.IOException
```
    Constructs a Powerpoint document from an input stream.
    
    Throws:
    
    java.io.IOException
  - HSLFSlideShow
```
public HSLFSlideShow(POIFSFileSystem poifs)
              throws java.io.IOException
```
    Constructs a Powerpoint document from an POIFSFileSystem.
    
    Throws:
    
    java.io.IOException
  - HSLFSlideShow
```
public HSLFSlideShow(DirectoryNode root)
              throws java.io.IOException
```
    Constructs a Powerpoint document from an DirectoryNode.
    
    Throws:
    
    java.io.IOException
- Method Detail
  - write
```
public void write(java.io.OutputStream out)
           throws java.io.IOException
```
    Specified by:
    
    write in interface SlideShow<HSLFShape,HSLFTextParagraph>
    
    Throws:
    
    java.io.IOException
  - getMostRecentCoreRecords
```
public Record[] getMostRecentCoreRecords()
```
    Returns an array of the most recent version of all the interesting records
  - getSlides
```
public java.util.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 java.util.List<HSLFNotes> getNotes()
```
    Returns an array of all the normal Notes found in the slideshow
  - getSlideMasters
```
public java.util.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 java.util.List<HSLFTitleMaster> getTitleMasters()
```
    Returns an array of all the normal Title Masters found in the slideshow
  - getPictureData
```
public java.util.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 java.awt.Dimension getPageSize()
```
    Specified by:
    
    getPageSize in interface SlideShow<HSLFShape,HSLFTextParagraph>
  - setPageSize
```
public void setPageSize(java.awt.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 java.io.IOException
```
    Specified by:
    
    addPicture in interface SlideShow<HSLFShape,HSLFTextParagraph>
    
    Throws:
    
    java.io.IOException
  - addPicture
```
public HSLFPictureData addPicture(java.io.InputStream is,
                                  PictureData.PictureType format)
                           throws java.io.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:
    
    java.io.IOException
    
    Since:
    
    3.15 beta 2
  - addPicture
```
public HSLFPictureData addPicture(java.io.File pict,
                                  PictureData.PictureType format)
                           throws java.io.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:
    
    java.io.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(java.io.InputStream fontData)
                     throws java.io.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:
    
    java.io.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 java.util.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(java.lang.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(java.lang.String name,
                      java.lang.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 java.io.IOException
```
    Specified by:
    
    close in interface java.io.Closeable
    
    Specified by:
    
    close in interface java.lang.AutoCloseable
    
    Throws:
    
    java.io.IOException
  - getPersistDocument
```
public java.lang.Object getPersistDocument()
```
    Specified by:
    
    getPersistDocument in interface SlideShow<HSLFShape,HSLFTextParagraph>

Class HSLFSlideShow

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

POWERPOINT_DOCUMENT

PP95_DOCUMENT

Constructor Detail

HSLFSlideShow

HSLFSlideShow

HSLFSlideShow

HSLFSlideShow

HSLFSlideShow

Method Detail

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