openFile (PresentationUtils)

Code

IPresentationResult openFile(String fileName)

Beschreibung

Öffnet eine bestehende Präsentationsdatei. Folgende Eingabeformate werden hierbei unterstützt:

• Microsoft Powerpoint: PPTX, PPSX, PPTM, PPSM, POTX, POTM, PPS, PPT, POT
• OpenOffice: ODP

Parameter

• fileName
  Name der zu öffnenden Präsentationsdatei (mit vollständiger Pfadangabe). Die angegebene Präsentationsdatei muss vorhanden sein.

Rückgabe
Ergebnis des Öffnens der Präsentationsdatei.
Folgende Methoden stehen für den Zugriff auf Rückgabeobjekt IPresentationResult zur Verfügung

• PresentationDocument PresentationUtils.getPresentationDocument(IPresentationResult result)
  Repräsentiert die Präsentationsdatei
• String PresentationUtils.getFileName(IPresentationResult result)
  Liefert den Namen der geöffneten Präsentationsdatei (entspricht dem übergebenen Parameter "fileName")
• boolean PresentationUtils.isSuccessful(IPresentationResult result)
  War das Öffnen der Präsentationsdatei erfolgreich?
• String PresentationUtils.getErrorCode(IPresentationResult result)
  Liefert den Fehlercode, falls das Öffnen der Präsentationsdatei nicht erfolgreich war. Die Fehlercodes stehen als Konstanten in der Klasse PresentationConstants zur Verfügung, z.B. PresentationConstants.ERRORCODE_GENERAL. Mit Hilfe der Fehlercodes können individuelle Ausgaben im Scripting hinterlegt werden. Folgende Fehlercodes stehen zur Verfügung:
  • PresentationConstants.ERRORCODE_FILENOTFOUND
    Die angegebene Datei konnte nicht gefunden werden.
  • PresentationConstants.ERRORCODE_NOTSUPPORTED_FILETYPE
    Dieser Dateityp wird als Präsentationsdatei nicht unterstützt.
  • PresentationConstants.ERRORCODE_GENERAL
    Ein allgemeiner Fehler ist bei der Bearbeitung der Präsentationsdatei aufgetreten.

Beispiele

IPresentationResult openResult = PresentationUtils.openFile("C:\\Work\\myFirstPresentation.pptx");

if (!PresentationUtils.isSuccessful(openResult))
{
    String errorCode = PresentationUtils.getErrorCode(openResult);
    
    if (PresentationConstants.ERRORCODE_FILE_NOTFOUND.equals(errorCode))
    {
      //...handle FILE_NOTFOUND
      ScriptUtils.debug("Error: Given presentation file " + openResult.getFileName() + " could not be found.");
    }
    else if (PresentationConstants.ERRORCODE_NOTSUPPORTED_FILETYPE.equals(errorCode))
    {
      //... handle NOTSUPPORTED_FILETYPE
    }
    else
    {
      //....handle PresentationConstants.ERRORCODE_GENERAL
    }
	/** do furthermore */
    return;
}

PresentationDocument presentation = null;
try
{
  presentation = PresentationUtils.getPresentationDocument(openResult);
  ...
}
finally
{
  PresentationUtils.close(presentation);
}