Handbuch BasicMaker 2010 - SoftMaker

Die Objektvariable "pm" enthält nun eine Referenz auf PlanMaker.
Wichtig: PlanMaker sichtbar machen
Bitte beachten Sie: Wenn Sie PlanMaker wie gerade beschrieben starten, ist das Programmfenster standardmäßig unsichtbar.
Soll PlanMaker sichtbar gemacht werden, muss die Eigenschaft Visible auf True gesetzt werden. Der vollständige
Aufruf von PlanMaker sollte also lauten:
Dim pm as Object
Set pm = CreateObject("PlanMaker.Application")
pm.Application.Visible = True
Das Objekt "Application"
Das grundlegende Objekt, das PlanMaker für die Programmierung exponiert, ist Application. Alle anderen Objekte –
wie zum Beispiel die derzeit geöffneten Arbeitsmappen oder sämtliche Programmoptionen – "hängen" am Application-
Objekt.
Das Application-Objekt enthält einerseits eigene Eigenschaften (zum Beispiel Application.Left für die X-Koordinate
des Programmfensters) und Methoden (wie Application.Quit zum Beenden von PlanMaker), andererseits enthält es
Zeiger auf andere Objekte wie Application.Options, die wiederum eigene Eigenschaften und Methoden enthalten, und
Zeiger auf Sammlungen ("Collections") wie Workbooks (die Liste der gerade geöffneten Dokumente).
Schreibweisen
Wie Sie aus dem vorherigen Abschnitt schon ersehen können, ist für den Zugriff auf die bereitgestellten Eigenschaften,
Methoden usw. die bei OLE-Automation übliche Punktnotation zu verwenden.
Mit Application.Left wird beispielsweise die Eigenschaft Left des Objekts Application angesprochen. Application.Workbooks.Add
bezeichnet die Methode Add des Objekts Workbooks, das wiederum ein Objekt von Application
ist.
Eigenschaften (Properties) von PlanMaker auslesen und ändern
Wurde die Verbindung zu PlanMaker hergestellt, können Sie das Programm "fernsteuern". Dazu gibt es, wie im Abschnitt
"OLE Automation" beschrieben, Eigenschaften (Properties) und Methoden (Methods).
Beschäftigen wir uns zunächst mit den Eigenschaften. Als Eigenschaften bezeichnet man Optionen und Einstellungen,
die abgefragt und teilweise verändert werden können.
Möchten Sie zum Beispiel den Programmnamen von PlanMaker ermitteln, verwenden Sie die Eigenschaft Name des
Objekts Application:
MsgBox "Der Name der Applikation ist: " & pm.Application.Name
Bei Application.Name handelt es sich um eine Eigenschaft, die nur gelesen werden kann. Andere Eigenschaften lassen
sich sowohl auslesen als auch von einem BasicMaker-Script aus abändern. So sind die Koordinaten des PlanMaker-
Programmfensters in den Eigenschaften Left, Top, Width und Height des Application-Objekts abgelegt. Sie können sie
wieder auslesen:
MsgBox "Der linke Fensterrand liegt bei: " & pm.Application.Left
Sie können diese Eigenschaft aber auch verändern:
pm.Application.Left = 200
PlanMaker reagiert sofort und verschiebt den linken Fensterrand auf dem Bildschirm an die Pixelposition 200. Sie können
Lesen und Schreiben von Eigenschaften auch mischen, etwa:
pm.Application.Left = pm.Application.Left + 100
Hier wird der aktuelle linke Rand ausgelesen, um 100 erhöht und als neuer linker Rand an PlanMaker übergeben. Auch
hier reagiert PlanMaker sofort und schiebt seinen linken Fensterrand um 100 Pixel nach rechts.
Handbuch BasicMaker 2010 BasicMaker und PlanMaker 161