Auf Navigator-Inhalte zugreifen über Collections

Am Anfang meiner StarBasic-Bemühungen stand die Idee, alle Hyperlinks eines Dokumentes überprüfen zu lassen (daraus entstand der Hyperlink-AutoCheck). Die Hyperlinks sah ich also komplett im Navigator aufgelistet und wollte daher darauf zugreifen. Leider fand ich nirgends ein Objekt, das sich auf den Navigator bezog, bis ich merkte, dass dieser auch nur auf andere vorhandene Datenstrukturen zurückgreift: auf diverse Collections. Diese Inhalte des Navigators sind Thema dieses Abschnittes.

Collections allgemein

Eine Collection ist eine Ansammlung eines Objekt-Typs, die sich über einen Index ansprechen lassen. In der Collection Documents sind etwa alle im StarOffice gerade offenen Dokument-Objekte zusammengefasst. Den vollen Namen eines einzelnen dieser Dokumente erfährt man dann also über über Documents(1).FullName. Standardmässig lassen sich mit Add() neue Objekte hinzufügen, mit Remove() wieder entfernen. Leider ist Einfügen derzeit noch nicht möglich, was das Einsatzgebiet unter Umständen bereits wieder etwas einschränkt (z.B. für die allgemeine Strings-Collection).

Um auf alle Objekte einer Collection zugreifen zu können, reicht meist eine Schleife wie die folgende (am Beispiel der Documents):

...
For x% = 1 To Documents.Count
   MsgBox(Documents(x%).FullName)
Next
...

Diese Sammlungen eignen sich hervorragend, wenn man etwa auf alle Objekte eines Typs zugreifen will, so wie dies eingangs für die Hyperlinks eines Dokuments erwähnt wurde.

Navigator-Inhalte

Die im Navigator angezeigten Inhalte sind nun fast alle als Collection im StarOffice verfügbar. Ich möchte daher hier die wichtigsten Sammlungen, die ich finden konnte, kurz beschreiben. Die genaue Syntax der zugehörigen Methoden und Eigenschaften ist der Dokumentation zu entnehmen.

Letzte Änderung: 01.04.98
Copyright ©1998 by Michael Herger