Handbuch BasicMaker 2010 - SoftMaker

Set tm = CreateObject("TextMaker.Application")
Wenn TextMaker bereits läuft, wird dadurch lediglich eine Verbindung zu ihm aufgebaut; wenn TextMaker noch nicht
gestartet ist, wird er automatisch gestartet.
Die Objektvariable "tm" enthält nun eine Referenz auf TextMaker.
Wichtig: TextMaker sichtbar machen
Bitte beachten Sie: Wenn Sie TextMaker wie gerade beschrieben starten, ist das Programmfenster standardmäßig unsichtbar.
Soll TextMaker sichtbar gemacht werden, muss die Eigenschaft Visible auf True gesetzt werden.
Der vollständige Aufruf von TextMaker sollte also lauten:
Dim tm as Object
Set tm = CreateObject("TextMaker.Application")
tm.Application.Visible = True
Das Objekt "Application"
Das grundlegende Objekt, das TextMaker für die Programmierung exponiert, ist Application. Alle anderen Objekte –
wie zum Beispiel Listen der geöffneten Dokumente und Fenster – "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 TextMaker), andererseits enthält es
Zeiger auf andere Objekte wie Application.Options, die wiederum eigene Eigenschaften und Methoden enthalten, und
Zeiger auf Sammlungen ("Collections") wie Documents (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.Documents.Add
bezeichnet die Methode Add der Sammlung Documents, die wiederum ein Objekt von Application
ist.
Eigenschaften (Properties) von TextMaker auslesen und ändern
Wurde die Verbindung zu TextMaker 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 TextMaker ermitteln, verwenden Sie die Eigenschaft Name des
Objekts Application:
MsgBox "Der Name dieser Applikation ist: " & tm.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 TextMaker-
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: " & tm.Application.Left
Sie können diese Eigenschaft aber auch verändern:
tm.Application.Left = 200
TextMaker reagiert sofort und verschiebt den linken Fensterrand der Applikation auf dem Bildschirm an die Pixelposition
200. Sie können Lesen und Schreiben von Eigenschaften auch mischen, etwa:
52 BasicMaker und TextMaker Handbuch BasicMaker 2010