openFile (PresentationUtils)
Versionshinweise | 22.1, 21.2.06, 21.1.11 |
---|
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.
- PresentationConstants.ERRORCODE_FILENOTFOUND
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);
}