Die Onlinehilfe zu Texel
GEMScript ist ein Protokoll zur Kommunikation zwischen verschiedenen Applikationen. Es kann auf zwei Arten genutzt werden.
Die Kommandos, die Texel derzeit versteht, sind nachfolgend aufgeführt und untergliedert in den Bereich der Standardkommandos, die von jedem GEMScript-Programm unterstützt werden sollten, und den Bereich der Texel-Kommandos. Ist ein Parameter in eckigen Klammern angegeben, so ist er optional. Der Parameter "datei" sollte jedoch immer angegeben werden, da der Benutzer während der Ausführung des Skripts die Fensterreihenfolge ändern kann und somit nicht mehr das ursprünglich vorgesehene Blatt bearbeitet würde!
Jedes Texel-Skript, das per 'SkriptNr' aufgerufen wird, muß ReturnCellValue beinhalten!
Standard-Kommandos:
Texel-Kommandos:
Bei manchen Befehlen (z.B. GetCell) ist außer der Angabe der
Zelle (z.B. "B52") auch eine Angabe in Reihen und Spalten
("r"ows und "c"olumns) möglich. A1 entspricht
hierbei r=0 und c=0, B4 entspricht r=3 und c=1, also [0; n-1]
Wichtig ist auch, daß nur Recalc und ReturnCellValue zu
einer Neuberechnung des Blattes führen. Wer also Werte mit
Setcell ändert, die Formeln beeinflussen, auf die im Skript
zurückgegriffen wird, der muß ein Recalc aufrufen!
| Export | Exportiert ein Blatt in ein gewünschtes Zielformat. Der Name
bezeichnet den Namen der Exportdatei, "datei" das
Rechenblatt, auf das zugegriffen werden soll. Format spezifiziert die
gewünschte Exportart als ASCII-Kürzel: "SYLK",
"SLK"; "DIF"; "CSV"; "ASC" (=
"ASCII") "TXT"; "TEX"; "HTML"
(= "HTML-32" = HTML-3.2-Export); "HTML-30";
"HTML-40"; "UDO", "RTF"; "XLS"
(= "BIFF2", binary interchange file format, Excel 2.0),
"TEXEL" (= "TEXEL-16") und "TEXEL-20".
Syntax: Export format name [datei] Beispiel: Export HTML-40 mypage.html |
| Select | Selektiert den angegebenen Bereich in "datei", um ihn
bspw. zu kopieren. Ein Bereich wird beispielsweise als
"A4:D8" angegeben, natürlich ohne
Anführungszeichen.
Syntax: Select bereich [datei] |
| GetSelection | Liefert die aktuelle Selektion in "datei" zurück,
Syntax wie bei Select.
Syntax: GetSelection [datei] |
| GetCell | Liefert den Wert der Zelle "zelle" zurück.
Syntax: GetCell zelle [datei] bzw. Syntax: GetCell r c [datei] |
| SetCell | Setzt eine Zelle auf den Wert "inhalt". Dies kann ein
Wert, aber auch eine Formel sein.
Syntax: SetCell zelle inhalt [datei] bzw. Syntax: SetCell r c inhalt [datei] Beispiel: SetCell A4 =Summe(B3;B9) |
| GetCellFormula | Liefert die Formel einer Zelle statt deren Wert zurück.
Konstanten werden unformatiert und mit Punkt als Dezimaltrenner
zurückgeliefert, Texte mit Alignzeichen (',^,").
Syntax: GetCellFormula zelle [datei] bzw. Syntax: GetCellFormula r c [datei] |
| GetCellValue | Eentspricht GetCellFormula, liefert aber auch bei Formelzellen
eine unformatierte Zahl zurück.
Syntax: GetCellValue zelle [datei] bzw. Syntax: GetCellValue r c [datei] |
| ReturnCellValue | Liefert den Wert einer Scripter-Berechnung in die Zelle
zurück von der das Skript aufgerufen wurde, ohne dabei den
Skript-Aufruf 'SkriptNr' zu überschreiben. Außerdem wird
das Blatt komplett neu berechnet. ReturnCellValue ist für jedes
Skript Pflicht, das per 'SkriptNr' aufgerufen wird!
Syntax: ReturnCellValue datei zelle wert |
| GetVariable | Liefert den Wert der Variablen "variable" zurück.
Syntax: GetVariable variable [datei] |
| IsBlockUsed | Meldet, ob der Block im "bereich" überschrieben
werden kann, d.h. ob er leer ist. Ist er das nicht, so erscheint ein
Alert, das den Benutzer fragt, ob überschrieben werden darf.
Bestätigt er dies, so bekommt man (wie wenn der Bereich unbenutzt
wäre) FALSE (0) zurück, andernfalls TRUE (1).
Syntax: IsBlockUsed bereich [datei] |
| GetRange | bereich [datei] Rechnet eine Bereichsangabe in r-c-Werte um, aus
A1:B2 wird also r=0 c=0, r=1 c=1. Ein Beispiel findet sich im
beiliegenden Skript "-1.TSC".
Syntax: GetRange bereich [datei] |
| Cell | row col [datei] Rechnet eine r-c-Angabe in eine Zellangabe um,
also r=4 c=2 in "C5".
Syntax: Cell row col [datei] |
| IsCellText | Liefert zurück, ob die Zelle Text enthält. Text ist
alles, was weder Formel noch Zahl bzw. Konstante ist.
Syntax: IsCellText zelle [datei] bzw. Syntax: IsCellText r c [datei] |
| IsCellConst | Liefert zurück, ob die Zelle eine Konstante (eine fixe Zahl)
enthält.
Syntax: IsCellConst zelle [datei] bzw. Syntax: IsCellConst r c [datei] |
| IsCellFormula | Liefert zurück, ob die Zelle eine Formel enthält.
Syntax: IsCellFormula zelle [datei] bzw. Syntax: IsCellFormula r c [datei] |
| IsCellEmpty | Liefert zurück, ob die Zelle nichts enthält, d.h. leer
ist.
Syntax: IsCellEmpty zelle [datei] bzw. Syntax: IsCellEmpty r c [datei] |
| Recalc | Löst eine Neuberechnung des Blattes aus.
Syntax: Recalc [datei] |
| GetRows | Liefert die Y-Erstreckung, also die Anzahl Zeilen, des Blattes
zurück. Die Anzahl liegt zwischen 1 und n.
Syntax: GetRows [datei] |
| GetColumns | Analog für die X-Erstreckung, also die Anzahl Spalten. Die
Anzahl liegt zwischen 1 und n.
Syntax: GetColumns [datei] |
| SetColor | Entspricht dem Farbpopup der Werkzeugleiste und setzt somit die
Farbe für den selektierten Bereich.
Syntax: SetColor farbe [datei] |
| SetTextColor | Entspricht dem Textfarbenpopup der Werkzeugleiste und setzt somit
die Textfarbe im selektierten Bereich.
Syntax: SetTextColor farbe [datei] |
| Goto | Springt zur angegebenen Zelle.
Syntax: Goto zelle [datei] bzw. Syntax: Goto r c [datei] |
Referenz: 'SkriptNr', TEXELUSR.DAT
Dringend zu empfehlen: Der GEMScript-Hypertext von Manfred Lippert. Er ist in jeder besser sortierten MausNet-Mailbox zu finden (mindestens jedoch in der MAUS Freiburg: 0761-507394 unter GSCR*.LZH) sowie auf der Texel-Homepage.