Copyright: Copyright ® 1994 CK Softwareentwicklung


CKTBL.VBX Tabellen Control

Icon:

Beschreibung: Diese Windows Hilfedatei enthält das CKTBL Version 1.52 Referenzhandbuch in elektronischer Form.

Eigenschaften (Properties)

Ereignisse (Events)

Methoden (Methods)


Copyright (c)  1994 CK Softwareentwicklung,  D-71131 Jettingen,  Inhaber: Christian Kratzer. Alle Rechte vorbehalten.

Ohne ausdrückliche schriftliche Erlaubnis durch CK Softwareentwicklung dürfen diese Unterlagen, oder ein Teil davon, nicht für irgendwelche Zwecke vervielfältigt oder übertragen werden, unabhängig davon, auf welche Art und Weise oder mit welchen Mitteln, elektronisch oder mechanisch, dies geschieht.

Microsoft und Windows sind eingetragene Warenzeichen der Microsoft-Corporation.

Visual Basic ist ein eingetragenes Warenzeichen der Microsoft-Corporation.

Copyright (c)  1994 CK Softwareentwicklung,  D-71131 Jettingen, Christian Kratzer. All rights reserved..

No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, wiuthout the express written permission of CK Softwareentwicklung.

Microsoft und Windows are registered trademarks of Microsoft-Corporation.

Visual Basic is a registered trademark of Microsoft-Corporation.


Eigenschaften (Properties)

Im folgenden sind alle Eigenschaften (Properties) von CKTBL Alphabetisch sortiert aufgelistet.  Einige Eigenschaften werden wegen starker Ähnlichkeit zusammen erklärt.

Zu jeder Eigenschaft wird eine Bemerkung, bestehend aus folgenden Kürzeln aufgeführt:

ACTION	Schreiben der Eigenschaft lößt eine Aktion aus.

ARRAY	Es handelt sich bei der Eigenschaft um ein Property Array.

RUNTIME	Die Eigenschaft ist nur zur Laufzeit verfügbar.  D.h. für sie existiert kein Eintrag im Eigenschaftsfenster (Properties-Window) der Entwicklungsumgebung.

READWRITE	Eigenschaft kann jederzeit beschrieben und gelesen werden.

READONLY	Eigenschaft kann nur gelesen werden.

WRITEONLY	Eigenschaft kann nur beschrieben werden.

About

Action

AddColumns

AddRows

AllowColResize

AllowColSel

AllowEdit

AllowEditColLabels

AllowEditRowLabels

AllowExtendedSel

AllowFullSel

AllowRowResize

AllowRowSel

AllowMultipleSel

AllowSel

AttributeScope

AutoRowHeight

BackColor

CellAlign

CellFormat

CellType

Clip

ClipColSep

ClipLineSep

ClipRowSep

Col

ColLabel

ColLabelStyle

ColScrollMode

ColWidth

CurrentSel

DefaultColWidth

DefaultRowHeight

EditText

EditTextNoVeto

FillStyle

Flags

FontBold

FontItalic

FontName

FontSize

FontStrikethru

FontUnderline

ForeColor

GridLines

Highlight

InEdit

LabelHeight

LabelWidth

LeftCol

NumberOfSel

RemoveColumns

RemoveRows

Row

RowHeight

RowHeightPreferred

RowLabel

RowLabelStyle

RowScrollMode

RowText

ScrollBars

SelStartCol

SelEndCol

SelStartRow

SelEndRow

Text

TopRow

Veto


ACTION	Schreiben der Eigenschaft lößt eine Aktion aus.


ARRAY	Es handelt sich bei der Eigenschaft um ein Property Array.


RUNTIME	Die Eigenschaft ist nur zur Laufzeit verfügbar.  D.h. für sie existiert kein Eintrag im Eigenschaftsfenster (Properties-Window) der Entwicklungsumgebung.


READWRITE	Eigenschaft kann jederzeit beschrieben und gelesen werden.


READONLY	Eigenschaft kann nur gelesen werden.


WRITEONLY	Eigenschaft kann nur beschrieben werden.


About Eigenschaft
About

Beschreibung:	Zeigt in der Entwicklungsumgebung das "About" Fenster von CKTBL an.

Gebrauch:	Mit der Maus anklicken.


Action Eigenschaft
Action

Beschreibung:	Zuweisen eines Wertes an diese Eigenschaft lößt verschiedene Aktionen aus.

Bemerkung:	ACTION, WRITEONLY, RUNTIME

Datentyp:	Integer ( Aufzählung )

Wertebereich:	0 - Aktuelle Zelle wird editiert, vorher wird das  EditText Ereignis ausgelößt.

1 - Aktuelle Zelle wird editiert, es wird KEIN EditText Ereignis ausgelößt.

2 - Editieren der Aktuellen Zelle wird Beendet,  Text wird in Zelle gespeichert

3 - Editieren der Aktuellen Zelle wird Beendet,  Text wird NICHT in Zelle gespeichert

Gebrauch:	[form.]tabelle.Action [ = Wert ]


AddColumns, AddRows Eigenschaften
AddColumns, AddRows

Beschreibung:	Bei zuweisen einer Zahl n an diese Eigenschaften, werden n Spalten oder Zeilen hinter der aktuellen Zeile (Row) bzw. Spalte (Col) eingefügt. Um Zeilen bzw. Spalten am Anfang einzufügen setzen Sie Row bzw. Col auf 0.

Bemerkung:	ACTION, RUNTIME, WRITEONLY

Datentyp:	Integer

Gebrauch:	[form.]tabelle.AddColumns  = integer

[form.]tabelle.AddRows =  integer

Siehe auch:	AddItem Methode, RemoveItem Methode,  RemoveRows,  RemoveCols


AllowColResize, #AllowRowResize Eigenschaften
AllowColResize, AllowRowResize

Beschreibung:	Ermöglicht dem Benutzer das Verstellen der Spaltenbreite bzw. der Zeilenhöhe mit der Maus.

Bemerkung:	READWRITE

Datentyp:	Boolean

Default:	True

Gebrauch:	[form.]tabelle.AllowColResize [ = booleanexpression ]

[form.]tabelle.AllowRowResize [ = booleanexpression ]

Siehe auch:	AdjustRowHeight, AdjustColWidth Ereignisse

Hinweis: Über die AdjustRowHeight oder AdjustColWidth Ereignisse lassen sich Zeilen oder Spalten individuell für das Verstellen der Höhe oder Breite sperren.


AllowColSel, AllowRowSel Eigenschaften
AllowColSel, AllowRowSel

Beschreibung:	Ermöglicht dem Benutzer das Selektieren von ganzen Spalten bzw. Zeilen durch klicken auf den Spalten- oder Zeilentitel.

Bemerkung:	READWRITE

Datentyp:	Boolean

Default:	True

Gebrauch:	[form.]tabelle.AllowColSel [ = booleanexpression ]

[form.]tabelle.AllowRowSel [ = booleanexpression ]

Siehe auch:	AllowExtendedSel, AllowFullSel, AllowMultipleSel, AllowSel


AllowEdit Eigenschaft
AllowEdit

Beschreibung:	Ermöglicht dem Benutzer das Bearbeiten von Zellen.

Bemerkung:	READWRITE

Datentyp:	Boolean

Default:	True

Gebrauch:	[form.]tabelle.AllowEdit [ = booleanexpression ]

Siehe auch:	AllowEditColLabels, AllowEditRowLabels, EditColLabel Ereignis, EditRowLabel Ereignis, EditText

Hinweis: Über das EditText Ereignis lassen sich Zellen individuell für das Bearbeiten sperren.


AllowEditColLabels, AllowEditRowLabels Eigenschaften
AllowEditColLabels, AllowEditRowLabels

Beschreibung:	Ermöglicht das Bearbeiten von Spalten- bzw.  Zeilentitel.

Bemerkung:	READWRITE

Datentyp:	Boolean

Default:	False ( Beide )

Gebrauch:	[form.]tabelle.AllowEditColLabels [ = booleanexpression ]

[form.]tabelle.AllowEditRowLabels [ = booleanexpression ]

Siehe auch:	AllowEdit,  EditColLabel Ereignis, EditRowLabel Ereignis, EditText Ereignis

Hinweis: Über die EditColLabel und EditRowLabel  Ereignisse lassen sich Zeilen- oder Spaltentitel individuell für das Bearbeiten sperren.


AllowExtendedSel Eigenschaft
AllowExtendedSel

Beschreibung:	Ermöglicht dem Benutzer das Erweitern der aktuellen Selektion.

Bemerkung:	READWRITE

Datentyp:	Boolean

Default:	True

Gebrauch:	[form.]tabelle.AllowExtendedSel [ = booleanexpression ]

Siehe auch:	AllowColSel, AllowRowSel, AllowFullSel, AllowMultipleSel, AllowSel


AllowFullSel Eigenschaft
AllowFullSel

Beschreibung:	Ermöglicht dem Benutzer das vollständige Selektieren der Tabelle. Drücken Sie hierzu auf die Titelzelle im linken oberen Eck.

Bemerkung:	READWRITE

Datentyp:	Boolean

Default:	True

Gebrauch:	[form.]tabelle.AllowFullSel [ = booleanexpression ]

Siehe auch:	AllowColSel, AllowRowSel, AllowExtendedSel, AllowMultipleSel, AllowSel


AllowMultipleSel Eigenschaft
AllowMultipleSel

Beschreibung:	Ermöglicht dem Benutzer das gleichzeitige Selektieren von mehreren rechteckigen Bereichen.  Drücken Sie hierzu auf die Strg-(Ctrl) Taste während Sie einen weiteren Bereich selektieren.

Bemerkung:	READWRITE

Datentyp:	Boolean

Default:	True

Gebrauch:	[form.]tabelle.AllowFullSel [ = booleanexpression ]

Siehe auch:	AllowColSel, AllowExtendedSel, AllowRowSel, AllowMultipleSel, AllowSel


AllowSel Eigenschaft
AllowSel

Beschreibung:	Ermöglicht dem Benutzer das Selektieren von einzelnen Zellen in der Tabelle.

Bemerkung:	READWRITE

Datentyp:	Boolean

Default:	True

Gebrauch:	[form.]tabelle.AllowSel [ = booleanexpression ]

Achtung: Diese Eigenschaft muß auf True gesetzt sein um Zellen bearbeiten zu können.


AttributeScope Eigenschaft
AttributeScope

Beschreibung:	Definiert den Wirkungsbereich von Attribut Änderungen.

Anfangs besitzen alle Zellen die durch  0 (Standard Zellen) auswählbaren Attribute und alle Titel die durch 1 (Standard Titel) auswählbaren Attribute. Durch setzen von 2 (Aktuelle Zelle) oder 3 (Selektion) lassen sich Attribute individuell für Zellen oder Titel vergeben.

Da diese Eigenschaft im Eigenschaftsfenster der Entwicklungsumgebung nicht aufgeführt ist lassen sich dort nur die standard Zellen Attribute ändern.

Bemerkung:	READWRITE, RUNTIME

Datentyp:	Integer ( Aufzählung )

Wertebereich:	0 - Standard Zellen 	( noch nicht veränderte Zellen )

1 - Standard Titel 	( noch nicht veränderte Titel )

2 - Aktuelle Zelle	( durch Row und Col spezifizierte Zelle)

3 - Selektion  	( alle momentan selektierten Zellen )

Default: 	0 - Standard Zellen	( In der Entwicklungsumgebug )

3 - Selektion	( Zur Laufzeit )

Gebrauch:	[form.]tabelle.AttributeScope [ = Wert ]

Siehe auch:	ForeColor, BackColor, CellFormat, CellAlign, CellType, FontName, FontSize, FontBold, FontItalic, FontStrikethru, FontUnderline,

Konstanten für AttributeScope


AutoRowHeight Eigenschaft
AutoRowHeight

Beschreibung:	Wenn diese Eigenschaft auf True gesetzt ist wird nach jeder Zuweisung an eine Zelle die Höhe der Zelle neu angepaßt.

Bemerkung:	READWRITE

Datentyp:	Boolean

Default:	False

Gebrauch:	[form.]tabelle.AutoRowHeight [ = boolean ]

Sieh auch:	Text, Clip, RowText, RowLabel, ColLabel, RowHeightPreferred


BackColor Eigenschaft
BackColor

Beschreibung:	Verändert die Hintergrundfarbe der durch AttributeScope bezeichneten Zellen.

Bemerkung:	READWRITE

Datentyp:	Long

Default:	&H00FFFFFF& ( Weiß )

Gebrauch:	[form.]tabelle.BackColor [ = color ]

Siehe auch:	AttributeScope, ForeColor


CellAlign Eigenschaft
CellAlign

Beschreibung:	Verändert die Horizontale Ausrichtung der durch AttributeScope bezeichneten Zellen.

Bemerkung:	READWRITE

Datentyp:	Integer ( Aufzählung )

Wertebereich:	0 - Linksbündig  (Default)

1 - Zentriert

2 - Rechtsbündig

Gebrauch:	[form.]tabelle.CellAlign [ = Wert ]

Siehe auch:	AttributeScope, CellFormat, Kostanten für CellAlign


CellFormat Eigenschaft
CellFormat

Beschreibung:	Verändert die Eigenschaften der durch AttributeScope bezeichneten Zellen. Der Wert setzt sich aus einer Reihe von Schaltern (Flags) zusammen die Sie in CKTBL.TXT finden. Die relevanten Schalter werden im Anhang 1 eingehend erläutert.

Bemerkung:	READWRITE

Datentyp:	Long

Wertebereich:	Siehe Anhang

Gebrauch:	[form.]tabelle.CellFormat [ = Wert ]

Siehe auch:	AttributeScope, CellAlign, CellType, Konstanten für CellFormat (Grundbausteine), Konstanten für CellFormat (Kombinationen)

Hinweis: In der Regel genügt es die Eigenschaften CellAlign und CellType zu benutzen.  Sie sollten diese Eigenschaft nur dann verwenden wenn Sie spezielle Zelleneigenschaften benötigen die sie über CellAlign und CellType nicht erhalten.

Beispiel:

'Alle Zellen sollen Mehrzeilig sein.

'Beim bearbeiten soll rechts von der Zelle eine

'  Bildlaufleiste erscheinen.

'Die automatische Höhenanpassung wird ausgeschalten

Form1_Load()

  	Dim fmt As Long

Dim maskAll As Long

Dim mask As Long

Table1.AttributeScope = 0	'Standard Zellen

Table1.CellType = 1	'Mehrzeilig

fmt = Table1.CellFormat

' automatisches Vergrößern und Verkleinern 	' ausschalten

maskAll = &HFFFFFFFF&

mask = CKTBL_FMT_VGROW|CKTBL_FMT_VSHRINK

fmt = fmt AND (maskAll XOR mask)

' vertikale Bildlaufleiste (Scrollbar) dazuaddieren

mask = CKTBL_VSCROLL

fmt = fmt OR mask

Table1.CellFormat = fmt

Table1.AttributeScope = 3	'Selektion

End Sub


CellType Eigenschaft
CellType

Beschreibung:	Verändert den Typ der durch AttributeScope bezeichneten Zellen.

Bemerkung:	READWRITE

Datentyp:	Integer ( Aufzählung )

Wertebereich:	0 - Einzeilig

1 - Mehrzeilig

2 - Mehrzeilig mit automatischen Umbruch

Gebrauch:	[form.]tabelle.CellType [ = Wert ]

Siehe auch:	AttributeScope, CellAlign, CellFormat, Konstanten für CellType


Clip Eigenschaft
Clip

Beschreibung:	Ermöglicht das gleichzeitige Lesen oder Schreiben aller Zellen der aktuellen Selektion.  Die Zeilen und Spalten werden jeweils durch Tab (Chr$(9)) und Cr (Chr$(13)) Zeichen getrennt.

Hat die Selektion mehr Zeilen oder Spalten als der String so werden nicht erreichte Zellen gelöscht.

Zeilen oder Spalten die über die Selektion hinausgehen würden, werden ignoriert.

Bemerkung:	ACTION, RUNTIME, READWRITE

Datentyp:	String

Gebrauch:	[form.]tabelle.Clip [ =  string ]

Siehe auch:	ClipColSep, ClipRowSep, CurrentSel, SelStartCol, SelEndCol, SelStartRow, SelEndRow, Text

Hinweis: Die Zeilen- bzw. Spaltentrennzeichen könnnen über die ClipRowSep und ClipColSep Eigenschaft verändert werden.

Achtung: Die Länge des Strings ist auf 32000 Zeichen beschränkt.

Beispiel:

' füllt die Selektion mit Testdaten

s = ""

For r = 1 To Table1.Rows

For c = 1 To Table1.Cols

s = s & "Row: " & r & "Col:" & c

s = s & Chr$(9)	'Spalten Umbruch

Next c

s= s & Chr$(13)	'Zeilen Umbruch

Next r

Table1.Clip = s


ClipRowSep Eigenschaft
ClipRowSep

Beschreibung:	ANSI Wert des Zeilentrennzeichens für Clip

Bemerkung:	READWRITE

Datentyp:	Integer ( 0..255 )

Default:	13 ( Cr )

Gebrauch:	[form.]tabelle.ClipRowSep [ = number ]

Siehe auch:	ClipColSep, Clip


ClipColSep Eigenschaft
ClipColSep

Beschreibung:	ANSI Wert des Spaltentrennzeichens für Clip

Bemerkung:	READWRITE

Datentyp:	Integer ( 0..255 )

Default:	9 ( Tab )

Gebrauch:	[form.]tabelle.ClipColSep [ = number ]

Siehe auch:	AddItem Methode, ClipRowSep, Clip, RowText


ClipLineSep Eigenschaft
ClipLineSep

Beschreibung:	Wird von der AddItem MethodeAddItem und der RowText Eigenschaft verwendet um Zeilenumbrüche innerhalb der Zellen zu kennzeichnen.  Hierdurch wird es möglich Zeilen aus der Tabelle mittels Print in Dateien zu schreiben und mit Line Input aus Datein zu lesen. Zellen mit mehrzeiligen Text würden sonst zu ungewollten Zeilenumbrüchen führen.

Falls Sie dieses Verhalten nicht wünschen, genügt es der Eigenschaft -1 zu zuweisen.

Bemerkung:	READWRITE

Datentyp:	Integer ( 0..255 oder -1 )

Default:	5

Gebrauch:	[form.]tabelle.ClipColSep [ = number ]

Siehe auch:	AddItem Methode,  RowText


Col, Row Eigenschaften
Col, Row

Beschreibung:	Nummer der aktuellen Spalte (Col) oder Zeile (Row).  Die Spalten und Zeilen in der Tabelle werden von 1 .. Cols bzw.  1..Rows numeriert. Die Spalten oder Zeilen Titel werden durch den Index 0 bezeichnet.

Bemerkung:	READWRITE

Datentyp:	Integer

Wertebereich:	Col  ::= ( 0 .. tabelle.Cols )

Row ::= ( 0 .. tabelle.Rows )

Gebrauch:	[form.]tabelle.Col [ = number ]

[form.]tabelle.Row [ = number ]

Siehe auch:	Cols, Rows

Hinweis: Die Numerierung der Zeilen und Spalten unterscheidet sich vom der in GRID.VBX.  Die Numerierung in CKTBL.VBX läuft  immer von 1 bis Rows oder Cols, unabhängig davon ob die Titel ein oder ausgeblendet sind. .


ColLabel Eigenschaft
ColLabel

Beschreibung:	Titel der durch Index bezeichneten Spalte.

Bemerkung:	ARRAY, READWRITE, RUNTIME

Datentyp:	String

Gebrauch:	[form.]tabelle.ColLabel(Index) [ = string ]

Siehe auch:	RowLabel, Text


ColLabelStyle, RowLabelStyle Eigenschaften
ColLabelStyle, RowLabelStyle

Beschreibung:	Setzt den anfänglichen Inhalt der Spalten- bzw. Zeilentitel.  Da es sich nur um einen Anfangswert handelt, können Sie jederzeit in einzelne Titel beliebige Texte einsetzen.  Verwenden Sie hierzu die Text oder RowText Eigenschaften.

Bemerkung:	READWRITE

Datentyp:	Integer ( Aufzählung )

Wertebereich:	0 - Leer (Titel sind zwar vorhanden, enthalten aber keinen Text)

1 - Numerisch (1,2,3,.... )

2 - Alphanumerisch ( A,B,...,Z,AA,AB,...  )

Gebrauch:	[form.]tabelle.ColLabelStyle [ = integer ]

[form.]tabelle.RowLabelStyle [ = integer ]

Siehe auch:	LabelWidth, LabelHeight, Text, RowText

Hinweis: Verwenden Sie die LabelWidth bzw. LabelHeight Eigenschaften um die Titel ein- oder auszublenden in dem Sie der jeweiligen Eigenschaft 0 zuweisen.


Cols, Rows Eigenschaft
Cols, Rows

Beschreibung:	Anzahl der Spalten (Cols) und Zeilen (Rows) in der Tabelle.

Sie können diese Eigenschaften benutzen um die Größe der Tablelle dynamisch zur Laufzeit zu ändern.

Es werden lediglich Spalten oder Zeilen angehängt bzw. rechts oder unten abgezogen.  Die Texte und Attribute der restlichen Zellen sowie die Breiten und Höhen der restlichen Spalten und Zeilen bleiben dabei erhalten.

Bemerkung:	READWRITE

Datentyp:	Integer

Wertebereich:	1 .. 16384

Gebrauch:	[form.]tabelle.Cols [ = numericexpression ]

[form.]tabelle.Rows [ = numericexpression ]

Siehe auch:	AddRows, AddColumns, Col, RemoveRows, RemoveColumns, Row

Hinweis: Die Numerierung der Zeilen und Spalten unterscheidet sich vom der in GRID.VBX.  Die Numerierung in CKTBL.VBX läuft  immer von 1 bis Rows oder Cols, unabhängig davon ob die Titel ein oder ausgeblendet sind. .


ColScrollMode, RowScrollMode Eigenschaft
ColScrollMode, ColScrollMode

Beschreibung:	Bestimmt das Verhalten beim Erreichen der letzen Spalte bzw. Zeile.

Bemerkung:	READWRITE

Datentyp:	Integer ( Aufzählung )

Wertebereich:	0 - Es ist nicht möglich über die letzte Spalte bzw. Zeile hinaus zu 'scrollen'

1 - Nach erreichen der letzten Spalte bzw. Zeile ist es noch möglich eine halbe Bildschirmbreite bzw. Höhe weiter zu scrollen

Gebrauch:	[form.]tabelle.ColScrollMode [ = integer ]

[form.]tabelle.RowScrollMode [ = integer ]

Siehe auch:	ScrollOver* Ereignisse


ColWidth Eigenschaft
ColWidth

Beschreibung:	Breite der durch Index bezeichneten Spalte in Twips

Bemerkung:	ARRAY, READWRITE, RUNTIME

Datentyp:	Long ( Twips )

Gebrauch:	[form.]tabelle.ColWidth(Index) [ = numeric ]

Siehe auch:	RowHeight, LabelWidth


CurrentSel Eigenschaft
CurrentSel

Beschreibung:	Beinhaltet den Index der aktuellen Selektion.  Die aktuelle Selektion wird durch die SelStartCol, SelEndCol, SelStartRow, SelEndRow Eigenschaften bestimmt.

Bemerkung:	READWRITE, RUNTIME

Datentyp:	Integer

Wertebereich:	1 .. tabelle.NumberOfSel

Gebrauch:	[form.]tabelle.CurrentSel [ = numericexpression ]

Siehe auch:	AllowMultipleSel, NumberOfSel, SelStartCol, SelEndCol, SelStartRow, SelEndRow


DefaultColWidth, DefaultRowHeight Eigenschaft
DefaultColWidth, DefaultRowHeight

Beschreibung:	Standard Breite oder Höhe der Spalten bzw. der Zeilen.  Wird diese Eigenschaft zur Laufzeit verändert, so bezieht sie sich nur noch auf Zeilen oder Spalten die dynamisch der Tabelle hinzugefügt werden.

Bemerkung:	READWRITE

Datentyp:	Long ( Twips )

Gebrauch:	[form.]tabelle.DefaultColWidth  [ = numeric ]

[form.]tabelle.DefaultRowWidth  [ = numeric ]

Siehe auch:	AddRows, AddCols, Rows, Cols, AddItem Methode


EditText Eigenschaft
EditText

Beschreibung:	Öffnet ein Eingabefeld mit dem zugewiesenen Text auf der aktuellen Zelle (Row,Col).

Bemerkung:	ACTION, WRITEONLY, RUNTIME

Datentyp:	String

Gebrauch:	[form.]tabelle.EditText  = string

Siehe auch:	EditTextNoVeto,  EditText Ereignis

Beispiel:

'editiert den Wert der Zelle 3,4

Table1.Row = 3

Table1.Col = 4

Table1.EditText = Table1.Text


EditTextNoVeto Eigenschaft
EditTextNoVeto

Beschreibung:	Öffnet ein Eingabefeld mit dem zugewiesenen Text auf der aktuellen Zelle (Row,Col). Der Unterschied zu EditText besteht darin daß kein EditText Ereignis ausgelößt wird.

Bemerkung:	ACTION, WRITEONLY, RUNTIME

Datentyp:	String

Gebrauch:	[form.]tabelle.EditTextNoVeto  = string

Siehe auch:	EditText, EditText Ereignis


FillStyle Eigenschaft
FillStyle

Beschreibung:	Bestimmt welche Zellen durch schreiben der Text Eigenschaft gesetzt werden.

Bemerkung:	READWRITE, RUNTIME

Wertebereich:	0 - Aktuelle Zelle (Default)

1 - Alle Selektierten Zellen

Gebrauch:	[form.]tabelle.FillStyle  [ = numeric ]

Siehe auch:	Text, Konstanten für FillStyle


Flags Eigenschaft
Flags

Beschreibung:	Setzt die globalen Schalter (Flags) für die Tabelle.  Die Werte der Schalter sind in CKTBL.TXT angegeben. Die Beschreibungen der Schalter finden Sie im Anhang 1.

Bemerkung:	READWRITE

Datentyp:	Long

Gebrauch:	[form.]tabelle.Flags  [ = numeric ]

Siehe auch:	AllowEdit, AllowEditColLabels, AllowEditRowLabels, AllowExtendedSel, AllowFullSel, AllowRowResize, AllowRowSel, AllowMultipleSel, AllowSel, GridLines, Highlight, ScrollBars

Hinweis: für die meisten Schalter existiert bereits eine spezielle Eigenschaft (Property) so daß Sie die Flags Eigenschaft in der Regel nicht benötigen.


FontBold Eigenschaft
FontBold

Beschreibung:	Schaltet Fettschrift in den durch AttributeScope bezeichneten Zellen ein oder aus.

Bemerkung:	READWRITE

Datentyp:	Boolean

Gebrauch:	[form.]tabelle.FontBold  [ = boolean ]

Siehe auch:	AttributeScope, FontItalic, FontName, FontBold, FontSize, FontStrikethru, FontUnderline


FontItalic Eigenschaft
FontItalic

Beschreibung:	Schaltet Kursivschrift in den durch AttributeScope bezeichneten Zellen ein oder aus.

Bemerkung:	READWRITE

Datentyp:	Boolean

Gebrauch:	[form.]tabelle.FontItalic  [ = boolean ]

Siehe auch:	AttributeScope, FontBold, FontName, FontBold, FontSize, FontStrikethru, FontUnderline


FontName Eigenschaft
FontName

Beschreibung:	Bestimmt den Namen der Schriftart in der durch AttributeScope bezeichneten Zellen.

Bemerkung:	READWRITE

Datentyp:	Boolean

Gebrauch:	[form.]tabelle.FontBold  [ = boolean ]

Siehe auch:	AttributeScope, FontBold, FontItalic, FontSize, FontStrikethru, FontUnderline


FontSize Eigenschaft
FontSize

Beschreibung:	Bestimmt die Schriftgröße in Punkt der durch AttributeScope bezeichneten Zellen.

Bemerkung:	READWRITE

Datentyp:	Float

Gebrauch:	[form.]tabelle.FontSize  [ = boolean ]

Siehe auch:	AttributeScope, FontBold, FontItalic, FontName, FontStrikethru, FontUnderline

Hinweis: Die Angabe der Schriftgröße läßt sich in 0,1 Punkt Schritten variieren.


FontStrikethru Eigenschaft
FontStrikethru

Beschreibung:	Schaltet Durchsteichen in den durch AttributeScope bezeichneten Zellen ein oder aus.

Bemerkung:	READWRITE

Datentyp:	Boolean

Gebrauch:	[form.]tabelle.FontStrikethru [ = boolean ]

Siehe auch:	AttributeScope, FontBold, FontItalic, FontName, FontSize, FontUnderline


FontUnderline Eigenschaft
FontUnderline

Beschreibung:	Schaltet Unterstreichen in den durch AttributeScope bezeichneten Zellen ein oder aus.

Bemerkung:	READWRITE

Datentyp:	Boolean

Gebrauch:	[form.]tabelle.FontUnderline [ = boolean ]

Siehe auch:	AttributeScope, FontBold, FontItalic, FontName, FontSize, FontStrikethru


ForeColor Eigenschaft
ForeColor

Beschreibung:	Verändert die Vordergrundfarbe der durch AttributeScope bezeichneten Zellen.

Bemerkung:	READWRITE

Datentyp:	Long

Default:	&H000000& ( Schwarz )

Gebrauch:	[form.]tabelle.ForeColor [ = color ]

Siehe auch:	AttributeScope, BackColor


GridLines Eigenschaft
GridLines

Beschreibung:	Schaltet das Raster ein oder aus.

Bemerkung:	READWRITE

Datentyp:	Bool

Default:	True

Gebrauch:	[form.]tabelle.GridLines [ = bool ]

Siehe auch:	Flags


Highlight Eigenschaft
Highlight

Beschreibung:	Hervorhebung der selektierten Zellen ein und ausschalten.

Bemerkung:	READWRITE

Datentyp:	Bool

Default:	True

Gebrauch:	[form.]tabelle.Highlight [ = bool ]

Beispiel:

'Farbe eines Bereiches auf Rot ändern ohne daß die

'für das ändern notwendige Selektion sichtbar wird

Table1.Highlight = False	'Hervorhebung aus

'relevanten Ausschnitt selektieren

Table1.SelStartCol = 2

Table1.SelEndCol = 6

Table1.SelStartRow = 1

Table1.SelEndRow = 6

Table1.AttributeScope = 3 	'Selektion

Table1.ForeColor = 255;	'Rot

Table1.NumberOfSel = 0	'Selektion löschen

Table1.Highlight = True	 	'Hervorhebung wieder an


InEdit Eigenschaft
InEdit

Beschreibung:	Zeigt an ob gerade ein Eingabefeld aktiv ist.

Bemerkung:	READONLY, RUNTIME

Datentyp:	Bool

Gebrauch:	[form.]tabelle.InEdit


LabelHeight Eigenschaft
LabelHeight

Beschreibung:	Höhe der Titel in Twips. Um die Spaltentitel auszublenden weisen Sie dieser Eigenschaft den Wert 0 zu.

Bemerkung:	READWRITE

Datentyp:	Long ( Twips )

Gebrauch:	[form.]tabelle.LabelHeight [ = numeric ]

Siehe auch:	LabelWidth, ColWidth, RowHeight


LabelWidth Eigenschaft
LabelWidth

Beschreibung:	Breite der Titel in Twips. Um die Zeilentitel auszublenden weisen Sie dieser Eigenschaft den Wert 0 zu.

Bemerkung:	READWRITE

Datentyp:	Long ( Twips )

Gebrauch:	[form.]tabelle.LabelWidth [ = numeric ]

Siehe auch:	LabelHeight, ColWidth, RowHeight


LeftCol Eigenschaft
LeftCol

Beschreibung:	Index der ersten sichtbaren Spalte von links.

Bemerkung:	READWRITE, RUNTIME

Datentyp:	Integer

Gebrauch:	[form.]tabelle.LeftCol  [ =  numeric ]

Siehe auch:	TopRow

Hinweis: Verwenden Sie diese Eigenschaft um den sichtbaren Ausschnitt der Tabelle zu verschieben. (Scrollen)


NumberOfSel Eigenschaft
NumberOfSel

Beschreibung:	Anzahl der rechteckigen Teilselektionen in der Gesamtselektion.

Durch zuweisen von NumberOfSel+1 kann eine neue Selektion der Gesamtselektion hinzugefügt werden.

Durch zuweisen von 0 werden alle Teilselektionen gelöscht.

Bemerkung:	READWRITE, RUNTIME

Datentyp:	Integer

Wertebereich:	Lesen: 0 .. tabelle.NumberOfSel

Schreiben: 0 oder tabelle.NumberOfSel + 1

Gebrauch:	[form.]tabelle.NumberOfSel  [ =  numeric ]

Siehe auch:	AllowMultipleSel, CurrentSel, SelStartCol, SelEndCol, SelStartRow, SelEndRow


RemoveColumns, RemoveRows Eigenschaft
RemoveColumns, RemoveRows

Beschreibung:	Bei zuweisen einer Zahl n an diese Eigenschaften, werden n Spalten oder Zeilen ab aktuellen Zeile (Row) bzw. Spalte (Col) gelöscht.

Bemerkung:	ACTION, WRITEONLY, RUNTIME

Datentyp:	Integer

Default:	True

Gebrauch:	[form.]tabelle.TopRow  [ =  numeric ]

Siehe auch:	AddColumnsAddRows


RowHeight Eigenschaft
RowHeight

Beschreibung:	Höhe einer Zeile in Twips.

Bemerkung:	ARRAY, READWRITE, RUNTIME

Datentyp:	Long (Twips)

Default:	True

Gebrauch:	[form.]tabelle.RowHeight( index )  [ =  numeric ]

Siehe auch:	DefaultRowHeight, RowHeightPreferred


RowHeightPreferred Eigenschaft
RowHeightPreferred

Beschreibung:	Diese Eigenschaft errechnet die geringste Höhe bei der alle Zellen einer Zeile komplett angezeigt werden können.  Sie können das Ergebnis direkt an die RowHeight Eigenschaft zuweisen.

Bemerkung:	ARRAY, READWRITE, RUNTIME

Datentyp:	Integer

Default:	True

Gebrauch:	[form.]tabelle.RowHeightPreferred( Index )

Siehe auch:	AutoRowHeight, RowHeight, LabelHeight


RowLabel Eigenschaft
RowLabel

Beschreibung:	Titel der durch Index bezeichneten Zeile.

Bemerkung:	ARRAY, READWRITE, RUNTIME

Datentyp:	String

Gebrauch:	[form.]tabelle.RowLabel(Index) [ = string ]

Siehe auch:	ColLabel, Text


RowText Eigenschaft
RowText

Beschreibung:	Inhalt einer Zeile als String. Die Einzelnen Spalten werden wie bei Clip durch Zeichen mit dem Wert Chr$(ClipColSep) getrennt.  Bei mehrzeiligen Feldern werden Zeilenumbrüche innerhalb der Zellen durch ein Zeichen mit dem Wert Chr$(ClipLineSep) dargestellt.

Bemerkung:	ARRAY, READWRITE

Datentyp:	String

Gebrauch:	[form.]tabelle.RowText( Index ) [ = string ]

Siehe auch:	AddItem Methode, Clip, ClipColSep, ClipLineSep

Hinweis: Verwenden Sie diese Eigenschaft in einer Schleife mit Line Input um Dateien zeilenweise zu lesen oder zu schreiben.


ScrollBars Eigenschaft
ScrollBars

Beschreibung:	Verändert die Anzeige von Bildlaufleisten (ScrollBars).

Bemerkung:	READWRITE

Datentyp:	Integer ( Aufzählung )

Wertebereich:	0 - Keine Bildlaufleisten

1 - Nur Horizontale Bildlaufleisten

     	2 - Nur Vertikale Bildlaufleisten

     	3 - Horizontale und Vertikale Bildlaufleisten

Default: 	3 - Horizontale und vertikale Bildlaufleisten

Gebrauch:	[form.]tabelle.ScrollBars  [ =  numeric ]

Siehe auch:	Flags, Konstanten für ScrollBars


SelStartCol, SelEndCol, SelStartRow, SelEndRow Eigenschaften
SelStartCol, SelEndCol, SelStartRow, SelEndRow

Beschreibung:	Die aktuelle Teilselektion beinhaltet die Spalten von SelStartCol bis SelEndCol und die Zeilen von SelStartRow bis SelEndRow. Eine 0 in SelStartCol bzw. SelStartRow bewirkt die Selektion der gesamten Spalte bzw. Zeile.

Bemerkung:	READWRITE, RUNTIME

Datentyp:	Integer

Wertebereich:	SelStartCol  	0 .. Cols	( 0 ::= ganze Spalte )

SelStartRow  	1 .. Cols

SelEndCol  	0 .. Rows ( 0 ::= ganze Zeile )

SelEndRow  	1 .. Rows

Gebrauch:	[form.]tabelle.SelStartCol  [ =  numeric ]

[form.]tabelle.SelStartRow  [ =  numeric ]

[form.]tabelle.SelEndCol  [ =  numeric ]

[form.]tabelle.SelEndRow  [ =  numeric ]

Siehe auch:	CurrentSel, Highlight, NumberOfSel

Hinweis: Verwenden Sie die Highlight Eigenschaft um die Darstellung der Selektion bei umfangreichen Operationen zu unterdrücken.


Text Eigenschaft
Text

Beschreibung:	Text in der durch Row, Col bezeichneten Zelle. Durch setzen der FillStyle Eigenschaft auf 1 können alle selektierten Zellen gleichzeitig beschrieben werden.

Bemerkung:	READWRITE, RUNTIME

Datentyp:	String

Gebrauch:	[form.]tabelle.Text  [ =  string ]

Siehe auch:	Row, Col, Clip, FillStyle


TopRow Eigenschaft
TopRow

Beschreibung:	Index der obersten sichtbaren Zeile.

Bemerkung:	READWRITE, RUNTIME

Datentyp:	Integer

Gebrauch:	[form.]tabelle.TopRow  [ =  numeric ]

Siehe auch:	LeftCol

Hinweis: Verwenden Sie diese Eigenschaft um den sichtbaren Ausschnitt der Tabelle zu verschieben. (Scrollen)


Veto Eigenschaft
Veto

Beschreibung:	Setzen Sie diese Eigenschaft auf True um die Vollendung eines Ereignisses zu verhindern. Näheres zu dieser Eigenschaft finden Sie bei den Beschreibungen der Einzelnen Ereignisse.

Bemerkung:	WRITEONLY, RUNTIME

Datentyp:	Boolean

Gebrauch:	[form.]tabelle.Veto = True

Siehe auch:	AdjustColWidth Ereignis, AdjustRowHeight Ereignis, ChangeColLabel Ereignis, ChangeColWidth Ereignis, ChangeRowLabel Ereignis, ChangeRowHeight Ereignis, ChangeText Ereignis, EditColLabel Ereignis, EditRowLabel_Ereignis, EditText  Ereignisse


Ereignisse (Events)

Im folgenden sind alle Ereignisse (Events) die von CKTBL ausgelößt werden Alphabetisch sortiert aufgelistet.  Einige Ereignisse werden wegen starker Ähnlichkeit zusammen erklärt.

Einige der folgenden Ereignisse lassen sich durch setzen der Veto Eigenschaft in der jeweiligen Behandlungsroutine in Ihrem verhalten ändern.  Der Veto Abschnitt in der Beschreibung der Ereignisse gibt an welche Aktionen durch setzen der Veto Eigenschaft verhindert werden können.

AdjustColWidth

AdjustRowHeight

ChangeColLabel

ChangeColWidth

ChangeRowLabel

ChangeRowHeight

ChangeText

ClickedCell

ClickedCol

ClickedRow

DoubleClickedCell

DoubleClickedCol

DoubleClickedRow

EditCancelled

EditColLabel

EditRowLabel

EditText

KeyDown

KeyPressed

KeyUp

MouseDown

MouseMove

MouseUp

RowColChange

SelChange

ScrollOverFirstCol

ScrollOverFirstRow

ScrollOverLastCol

ScrollOverLastRow


AdjustColWidth Ereignis

Beschreibung:	Wird ausgelößt wenn sich die Maus in der Titelzeile zwischen zwei Spalten befindet.

Veto:	Durch setzen der Veto Eigenschaft auf True wird das Verstellen der Spaltenbreite verhindert.

Syntax:	Sub Tabelle_AdjustColWidth( Col As Integer )

Siehe auch:	AdjustRowHeight,  AllowRowResize, AllowColResize,  ChangeColWidth Ereignis, ChangeRowHeight Ereignis, Veto

Hinweis: Die AllowColResize Eigenschaft muß auf True gesetzt sein falls dieses Ereignis ausgelößt werden soll !


AdjustRowHeight Ereignis

Beschreibung:	Wird ausgelößt wenn sich die Maus in der Titelspalte zwischen zwei Zeilen befindet.

Veto:	Durch setzen der Veto Eigenschaft auf True wird das Verstellen der Zeilenhöhe verhindert.

Syntax:	Sub Tabelle_AdjustRowHeight( Row As Integer )

Siehe auch:	AdjustColWidth, AllowRowResize, AllowColResize Eigenschaft,  ChangeColWidth Ereignis, ChangeRowHeight Ereignis, Veto

Hinweis: Die AllowRowResize Eigenschaft muß auf True gesetzt sein falls dieses Ereignis ausgelößt werden soll !


ChangeColLabel, ChangeRowLabel Ereignisse

Beschreibung:	Wird ausgelößt wenn der Benutzer einen Spalten- bzw Zeilentitel bearbeitet hat und das Eingabefeld zu Verlassen versucht. Wird nicht ausgelößt wenn der Anwender das Eingabefeld mit der 'Esc' Taste verläßt.

Veto:	Durch setzen der Veto Eigenschaft auf True wird das Speichern des bearbeiteten Textes in der Zelle verhindert.

Syntax:	Sub Tabelle_ChangeColLabel( Col As Integer, Text As String )

Sub Tabelle_ChangeRowLabel( Row As Integer, Text As String  )

Siehe auch:	AdjustRowHeight Ereignis,  AllowColResize, Veto


ChangeColWidth Ereignis

Beschreibung:	Wird ausgelößt nachdem der Benutzer die Spaltenbreite eingestellt hat und die Maustaste losläßt.

Veto:	Durch setzen der Veto Eigenschaft auf True wird das Einstellen der gewünschten Spaltenbreite verhindert.

Syntax:	Sub Tabelle_ChangeColWidth( Col As Integer, w As Long )

Siehe auch:	AdjustRowHeight Ereignis,  AllowColResize


ChangeRowHeight Ereignis

Beschreibung:	Wird ausgelößt nachdem der Benutzer die Zeilenhöhe eingestellt hat und die Maustaste losläßt.

Veto:	Durch setzen der Veto Eigenschaft auf True wird das Einstellen der gewünschten Spaltenhöhe verhindert.

Syntax:	Sub Tabelle_ChangeRowHeight( Row As Integer, h As Long )

Siehe auch:	AdjustRowHeight Ereignis,  AllowColResize


ChangeText Ereignis

Beschreibung:	Wird ausgelößt wenn der Benutzer eine Zelle bearbeitet hat und das Eingabefeld zu verlassen versucht. Wird nicht ausgelößt wenn der Anwender das Eingabefeld mit der 'Esc' Taste verläßt. .

Veto:	Durch setzen der Veto Eigenschaft auf True wird das Speichern des bearbeiteten Textes in die Zelle verhindert.

Syntax:	Sub Tabelle_ChangeText( Row As Integer, Col As Integer, 	NewText As Integer )

Siehe auch:	ChangeColLabel Ereignis, ChangeRowLabel Ereignis


EditCancelled Ereignis
EditCancelled

Beschreibung:	Wird ausgelößt wenn der Benutzer Beim bearbeiten einer  Zelle auf die Esc Taste gedrückt hat.  In diesem Fall wird die Zelle in dem Zustand belassen in dem sie war bevor der Benutzer sie zu editieren begann.  Das Ereignis kann auch programmgesteuert über die Action Eigenschaft ausgelößt werden.

Syntax:	Sub Tabelle_EditCancelled( Col As Integer, Text As String )

Siehe auch:	Action, ChangeText Ereignis, ChangeColLabel Ereignis, ChangeRowLabel Ereignis, EditText Ereignis


EditColLabel, EditRowLabel Ereignisse

Beschreibung:	Wird ausgelößt wenn der Benutzer die Spalten bzw. Zeilen Titel zu bearbeiten versucht.

Veto:	Durch setzen der Veto Eigenschaft auf True wird das Öffnen eines Eingabefeldes auf dem Spalten- bzw. Zeilentitel verhindert.

Syntax:	Sub Tabelle_EditColLabel( Col As Integer, Text As String )

Sub Tabelle_EditRowLabel( Row As Integer, Text As String  )

Siehe auch:	AdjustRowHeight Ereignis,  AllowColResize, Veto, EditText Ereignis


EditText Ereignis

Beschreibung:	Wird ausgelößt wenn der Benutzer eine Zelle zu bearbeiten versucht.

Veto:	Durch setzen der Veto Eigenschaft auf True wird das Öffnen eines Eingabefeldes auf der Zelle verhindert.

Syntax:	Sub Tabelle_AdjustColWidth( Col As Integer )

Siehe auch:	AdjustRowHeight Ereignis,  AllowColResize,  EditColLabel Ereignis,  EditRowLabel Ereignis


RowColChange Ereignis

Beschreibung:	Wird ausgelößt wenn die Aktuelle Zelle (Row, Col ) verändert worden ist.

Syntax:	Sub Tabelle_RowColChange()

Siehe auch:	SelChange_Ereignis


SelChange Ereignis

Beschreibung:	Wird ausgelößt wenn die Selektion verändert worden ist.

Syntax:	Sub Tabelle_SelChange( Col As Integer )

Siehe auch:	RowColChange Ereignis


ScrollOver* Ereignisse

Beschreibung:	Werden ausgelößt wenn  der Benutzer versucht über den Rand der Tabelle hinaus zu 'Scrollen'.   Verwenden sie diese Ereignisse um die Tabelle gegebenenfalls dynamisch zu erweitern.

Syntax:	Sub Tabelle_ScrollOverFirstCol()

Sub Tabelle_ScrollOverFirstRow()

Sub Tabelle_ScrollOverLastCol()

Sub Tabelle_ScrollOverLastRow()

Siehe auch:	ColScrollMode, RowScrollMode

Beispiel:

Sub Table1_ScrollOverLastRow()

'Am ende der Tabelle eine Leerzeile einfügen

Table1.AddItem ""

End Sub


Methoden (Methods)

Im folgenden sind die von CKTBL unterstüzten Methoden (Methods) Alphabetisch sortiert aufgelistet.  Visual Basic standard Methoden werden hier nicht beschrieben.

AddItem

Clear

Drag

Move

Referesh

RemoveItem

SetFocus

ZOrder


AddItem Methode

Beschreibung:	Fügt eine neue Zeile in die Tabelle ein  Der Titel der neuen Zeile wird gemäß der RowLabelStyle Eigenschaft gesetzt.  Einzelne Spalten werden wie bei der RowText Eigenschaft durch Chr$(ClipColSep) getrennt. Zeilenumbrüche in mehrzeiligen Zellen werden durch Chr$(ClipLineSep) getrennt.

Syntax:	[form].tabelle.AddItem( string As String )

[form].tabelle.AddItem( string As String, index As Integer )

Siehe auch:	AddRows, AddColumns


Clear Methode

Beschreibung:	Löscht alle Zelleninhalte

Syntax:	[form].tabelle.Clear()

Siehe auch:	RemoveColumns, RemoveRows


RemoveItem Methode

Beschreibung:	Entfernt eine Zeile aus der Tabelle

Syntax:	[form].tabelle.RemoveItem( index As Integer )

Siehe auch:	RemoveColumns, RemoveRows