Makro-Kochbuch - WollMux

spezifische Namen gibt. Die Funktion erwartet vier Parameter, wobei lediglich der letzte (eineListe von Property-Values) interessant ist, jedoch selten bei der Ersterzeugung eingesetzt wird(Ausnahme siehe Kapitel 3.2.5 – unsichtbares Dokument). Alle theoretisch zu übergebendenParameter können auch nachträglich gesetzt werden – das ist der Vorteil eines neuenDokumentes.Beispiel der Erzeugung eines Writer-Dokumentes:oDoc = StarDesktop.loadComponentFromURL("private:factory/swriter", "_blank", 0, array())Man kann – muss aber nicht – das erzeugte Dokument gleich einer Variablen zuordnen. In derRegel macht dies natürlich Sinn, nur so kann direkt mit dem Dokument weitergearbeitet werden.Noch ein Hinweis: Typischerweise erhält das neu erzeugte Dokument sofort den Fokus und liegtsomit „oben auf“. Auch die vordefinierte Variable „ThisComponent“ verweist jetzt auf das neueDokument.Im Einzelfall kann es Sinn machen, eine „Wait“-Funktion nach der Erzeugung anzugeben, umdem Dokument die komplette Erstellung zu ermöglichen und erst dann Manipulationen imDokument durchzuführen. Zwar bleibt das Makro an der Erzeugungszeile so lange stehen, bisOOo meldet, dass das Dokument erzeugt ist, die Praxis zeigte jedoch, dass manche interneObjekte noch nicht unmittelbar zur Verfügung stehen. In der Regel reicht eine Wartezeit von 100ms (wait(100)).Alle neuen Dokumente werden auf der Basis der hinterlegten Standard-Vorlagen erzeugt.3.2 Öffnen von bestehenden DokumentenDas Öffnen von Dokumenten benutzt die selbe Methode wie das Erzeugen – dennoch sindhierbei viele Punkte zunächst zu beachten:• Ein Dokument kann nur geöffnet werden, wenn es überhaupt existiert – es muss alsounbedingt vorher eine Prüfung sowohl des Pfades als auch des Dateinamen erfolgen.• Ein Dokument könnte bereits auf dem aktuellen Bildschirm geöffnet sein – dann führt dieMethode ebenfalls zu einem Fehler. Abhilfe: siehe Abschnitt „Prüfung, ob Datei schongeöffnet ist“.• Auch wenn ein Dokument existiert, ist es möglicherweise nicht direkt zu öffnen. Eskönnte sein, dass dieses Dokument derzeit von einer anderen Person bearbeitet wird.Dies ist insbesondere bei Netzwerk-Dokumenten zu beachten. Leider gibt es keinedirekte Prüfung, ob dies der Fall ist. Allerdings legt OOo eine versteckte Lock-Datei an,die den/die Benutzer/in und die Uhrzeit der Benutzung enthält. Eine Möglichkeit wäre diePrüfung auf das Vorhandensein der Lock-Datei (siehe Abschnitt Lock-Datei prüfen).Dieser Weg ist jedoch nicht „wasserdicht“, da nicht immer gewährleistet ist, dass eineLock-Datei auch wieder gelöscht wird.LHM – Makro-Kochbuch 2012 41