Show TOC

Wichtige TabellenstrukturenLocate this document in the navigation structure

Verwendung

Die Methoden zum Setzen und Holen der Daten aus einem benannten Bereich eines Arbeitsblatts verwenden die Trennung zwischen Beschreibung des Bereiches und den eigentlichen Daten. Dabei ist zu beachten, dass die Reihenfolge in der Bereichsbeschreibung (Struktur soi_range_list ) auch bei den Daten (Struktur soi_generic_table ) eingehalten werden muß. Dies bedeutet, dass in der Datentabelle zuerst alle Daten des ersten Bereichs gelistet werden müssen, bevor Daten des zweiten Bereichs eingefügt werden können.

Feld

Typ

Beschreibung

name

C

Name des Arbeitsbereichs

rows

C

Anzahl der Zeilen

columns

C

Anzahl der Spalten

code

C

Funktion auf den Bereich:

  • SPREADSHEET->SPREADSHEET_CLEAR : Deletes range

  • SPREADSHEET->SPREADSHEET_COLUMNSHIDE : Hides columns

  • SPREADSHEET->SPREADSHEET_ROWSHIDE : Hides rows

  • SPREADSHEET->SPREADSHEET_PROTECT : Range is protected

  • SPREADSHEET->SPREADSHEET_UNPROTECT : Range is not protected

  • SPREADSHEET->SPREADSHEET_COLUMNSSHOW : Columns are displayed.

  • SPREADSHEET->SPREADSHEET_ROWSSHOW : Rows are displayed.

  • SPREADSHEET->SPREADSHEET_INSERTALL : The entire table is inserted, regardless of the size of the area

  • SPREADSHEET->SPREADSHEET_NEWRANGE : Creates a new range

Der Name identifiziert den Bereich im Arbeitsblatt. Es ist sozusagen der Schlüssel, über den immer auf diesen Bereich zugegriffen wird. Die Größe des Bereiches wird jeweils nur in Spalten- und Zeilenanzahl angegeben.

Über bestimmte Funktionen kann auf einen Bereich in einem Arbeitsblatt gesondert zugegriffen werden. Welche Funktionen implementiert sind, lässt sich aus der Tabelle ersehen.

Beschreibung des Datentyps soi_generic_table

In dieser Tabelle werden die Daten der Bereiche gespeichert und über den Data Provider an das Frontend übertragen oder von dort geholt. Die Daten werden als Zeichenkette ohne Typinformation übertragen.

Feld

Typ

Beschreibung

row

C(4)

Row

column

C(4)

Spalte

value

C(256)

Wert
Achtung

Die Reihenfolge der Daten muss der Reihenfolge der Bereichsbeschreibung entsprechen, d.h. zuerst wird z.B. der Bereich range1, dann der Bereich range2 beschrieben. Die Datentabelle muss dann die Daten auch in der Reihenfolge range1, range2 enthalten.

Beschreibung des Datentyps soi_format_table

Mit Hilfe dieser Tabelle lässt sich das Format eines Bereiches angeben. Das Format besteht aus verschiedenen Eigenschaften, die alle innerhalb einer Zeile gesetzt werden können. Dabei entspricht jede veränderbare Eigenschaft einer Spalte der Zeile.

Einen Arbeitsbereich für diese Tabelle legen Sie mit Bezug auf die Struktur soi_format_item an.

Hinweis

Der Eintrag "-1" deutet jeweils darauf hin, dass der bestehende Wert des Bereiches nicht verändert werden soll.

Feld

Typ

Beschreibung

name

C(256)

Name des Arbeitsbereichs

front

I

Farbe der Schrift (siehe Farbpalette)

back

I

Farbe des Hintergrunds (siehe Farbpalette)

font

C(256)

Name der Fontfamilie. Folgende Werte sind erlaubt:

Arial

Courier New

Times New Roman

size

I

Schriftgröße

-1 : Keine Veränderung

bold

I

1 : Bold

0 : Normal

-1 : Keine Veränderung

italic

I

1 : Kursiv

0 : Normal

-1 : Keine Veränderung

align

I

Ausrichtung:

  • -1 : Keine Veränderung

  • 0 : Rechtsbündig

  • 1 : Zentriert

  • 2 : Linksbündig

frametype

I

Steuerbyte zum Setzen des Rahmens

-1 : Keine Veränderung

framecolor

I

Farbe des Rahmens (siehe Farbpalette)

-1 : Keine Veränderung

currency

C(3)

Währung gemäß ISO-Norm

number

I

Legt das Format einer Zelle des Bereiches fest.

  • 1 bezeichnet eine einfache Zahl

  • 2 bezeichnet die wissenschaftliche Darstellung

  • 3 bezeichnet die Prozentdarstellung
Hinweis

Folgende Farben sind erlaubt:

Das Steuerbyte type setzt sich aus folgenden Bits zusammen. Ein gesetztes Bit bedeutet immer, dass der entsprechende Strich gezogen wird. Die Liniendicke kann über Bit 6 und 7 zwischen vier Dicken variiert werden:

Bit

Beschreibung

0

Linker Rand

1

Oberer Rand

2

Unterer Rand

3

Rechter Rand

4

Horizontaler Strich

5

Linker Rand

6

Liniendicke

7

Liniendicke

Beschreibung des Datentyps soi_full_range_table

Jede Zeile einer Tabelle vom Typ soi_full_range_table gibt die volle Definition eines Bereichs an. Die einzelnen Zeilen haben den Datentyp soi_full_range_item .

Feld

Typ

Beschreibung

name

C(128)

Name des Arbeitsbereichs

top

I

Oberste Zeile des Bereichs

left

I

Äußerste linke Spalte des Bereichs

rows

I

Anzahl der Zeilen im Bereich

columns

I

Anzahl der Spalten im Bereich

sheets

C(128)

Arbeitsblatt, auf dem der Bereich definiert ist

Beschreibung des Datentyps soi_cell_table

Jede Zeile einer Tabelle vom Typ soi_cell_table gibt die Attribute eines Bereichs von Zellen an. Es wird jedoch kein Bereichsname verwendet. Stattdessen wird der Zellenbereich auf der Grundlage seiner Startposition und der Anzahl seiner Zeilen und Spalten definiert. Die einzelnen Zeilen haben den Datentyp soi_cell_item .

Feld

Typ

Beschreibung

top

I

Oberste Zeile des Bereichs

left

I

Äußerste linke Spalte des Bereichs

rows

I

Anzahl der Zeilen im Bereich

I

Anzahl der Spalten im Bereich

front

I

Farbe der Schrift (siehe Farbpalette)

back

I

Farbe des Hintergrunds (siehe Farbpalette)

font

C(256)

Schriftart. Folgende Werte sind erlaubt:

  • Arial

  • Courier New

  • Times Roman

size

I

Schriftgröße

Verwenden Sie -1 , wenn die Schriftgröße unverändert bleiben soll.

bold

I

  • 1 : Bold

  • 0 : Normal

  • -1 : Keine Veränderung

italic

I

1 : Kursiv

0 : Normal

-1 : Keine Veränderung

align

I

Ausrichtung:

  • -1 : Keine Veränderung

  • 0 : Rechtsbündig

  • 1 : Zentriert

  • 2 : Linksbündig

frametype

I

Steuerbyte zum Setzen des Rahmens

-1 : Keine Veränderung

framecolor

I

Farbe des Rahmens (siehe Farbpalette)

-1 : Keine Veränderung

currency

C(3)

Währung gemäß ISO-Norm

number

I

Legt das Format einer Zelle des Bereiches fest.

  • 1 bezeichnet eine einfache Zahl

  • 2 bezeichnet die wissenschaftliche Darstellung

  • 3 bezeichnet die Prozentdarstellung

decimals

I

Anzahl der Nachkommastellen

input

I

  • 0 : Input aus

  • 1 : Input an
Hinweis

Folgende Farben sind erlaubt:

Beschreibung des Datentyps soi_dimension_table

Mit einer internen Tabelle dieses Typs können Sie einen Bereich definieren, indem Sie die Koordinaten der oberen linken Ecke, seine Länge und seine Bereite angeben. Die Zeilen von soi_dimension_table haben den Zeilentyp soi_dimension_item .

Feld

Typ

Beschreibung

top

I

Oberste Zeile des Bereichs

left

I

Äußerste linke Spalte des Bereichs

rows

I

Anzahl der Zeilen

columns

I

Anzahl der Spalten