Die Eigenschaften des Bauelements SQL-Tabelle

Bei folgenden werden die Eigenschaften des Bauelements beschrieben.

 

Datenquelle

Als Datenquelle kann entweder eine verwaltete Datenquelle (siehe Systemsteuerung->Verwaltung->Datenquellen (ODBC)) oder eine Sqlite-Datenbankdatei angegeben werden.
Eine verwaltete Datenquelle kann über die Schaltfläche '...' ausgewählt werden (siehe auch Bauelement ODBC-Tabelle -> Verwaltete Datenquelle anbinden).

Alternativ kann die Datenquelle auch als Text oder über eine String-Variable angegeben werden.

SQL-Select

Die hier hinterlegte SQL-Abfrage legt den dargestellten Inhalt der Tabelle fest. Sie bestimmt welche Spalten in der SQL-Tabelle angezeigt werden sollen. In der Standarddarstellung können die Spaltentitel nur über den SQL-Ausdruck 'AS' umbenannt werden. In der 'Virtuellen Darstellung' kann ein Spaltentitel zusätzlich mit der Callback-Funktion _onSqlGridGetColumnTitle geändert werden.

Beispiel einer Umbenennung von Spalten über einen SELECT Ausdruck:

"SELECT OrderNo AS AuftragsNr, Customer AS Kunde, ProductNo AS ProduktNr, Count AS Anzahl FROM OrdersView";

Sind für die Darstellung von Spalteninhalten spezielle Formatierungen notwendig, so müssen diese im SQL-Select Befehl entsprechend abgehandelt werden.

ReadOnly

Legt fest, ob der Inhalt der SQL-Tabelle editiert werden kann. Wird der Inhalt einer Zelle editiert, so wird beim Verlassen der Zelle der neue Inhalt in die Datenbank geschrieben. Es ist zu beachten, dass der Inhalt eines View nicht ediert werden kann.

Virtuelle Darstellung verwenden

Wird die virtuelle Darstellung aktiviert, so werden immer nur die Reihen aus der Datenbank ausgelesen, die für die Darstellung notwendig sind. Auf diese Weise werden umfangreiche Abfrageergebnisse schnell aktualisiert dargestellt. Jedoch können wegen dieser Ausschnittsabfrage keine Gruppierungen anhand der Spalten vorgenommen werden, da hierzu sämtliche Ergebnisse der Abfrage notwendig wären.
Da für die virtuelle Darstellung intern auf die SQL-Kommandos OFFSET und LIMIT zurückgegriffen wird, kann keine Microsoft Access Datenbank als Datenquelle verwendet werden, da diese Datenbank diese SQL-Kommandos nicht unterstützt.

'Dauerhaftes Gruppieren anhand einer Spalte' verwenden

Diese Eigenschaft schaltet die Rubrik 'Gruppieren anhand einer Spalte' frei. Hierin lässt sich eine einfache Gruppierung von Abfrageergebnissen über eine Spalte realisieren, die der Bediener weder deaktivieren noch ändern kann.

Zusätzlich können in die resultierenden Gruppierungszeilen Schaltflächen eingeblendet werden, die dann zur weiteren Verarbeitung zur Verfügung stehen. Beim Betätigen einer Gruppen-Schaltfläche wird die Callback-Funktion _onSqlGridGroupButtonClicked aufgerufen.

Spalte

In der Eigenschaft 'Spalte' wird die Spalte eingetragen, die zur Gruppierung der Abfrageergebnisse verwendet werden soll.

Gruppen-Schaltflächen

Über diese Eigenschaft können Schaltflächen hinzugefügt werden, die in Gruppierungszeilen eingeblendet werden. Die Darstellung der einzelnen Schaltflächen (gesperrt, unsichtbar/sichtbar, Farbe, Beschriftung) kann über die Callback-Funktion _onSqlGridGetGroupButtonProperties gesteuert werden.

(Name)

Der Name wird zum Identifizieren der Gruppen-Schaltfläche verwendet, wenn für diese die Callback-Funktion _onSqlGridGroupButtonClicked bzw. _onSqlGridGetGroupButtonProperties aufgerufen wird.

Beschriftung

Der String Wert dieser Eigenschaft wird zum Beschriften der Gruppen-Schaltfäche verwendet.

Schriftart

Legt die Schriftart fest, mit der sämtlicher Inhalt der Tabelle gezeichnet werden sollen.

Spaltenüberschrift darstellen

Legt fest, ob Spaltenüberschriften dargestellt werden sollen.

Zeilennummerierung darstellen

Legt fest, ob eine Zeilennummerierung dargestellt werden soll.

Wechselnde Zeilenfarben darstellen

Legt fest, ob die Hintergrundfarbe der Zeilen im Wechsel eingefärbt werden sollen.

Zeilenfärbung durch Spalteninhalt steuern

Wird diese Eigenschaft aktiviert, so kann die Hintergrundfarbe und/oder die Textfarbe einer ganzen Zeile über den Inhalt einer bzw. zweier Spalten gesteuert werden. Hierzu ist es notwendig, dass jeweils eine entsprechende Spalte existiert, die die zu darzustellende Farbinformation enthält. Der Farbwert der Spalte muss das Format GRB (Green-Red-Blue) besitzen - wie sie auch die Farbkonstanten von Victory besitzen.
Dieses Verfahren ist die geeignetste Variante um auch umfangreiche Abfrageergebnisse schnell aufgefrischt darzustellen.

Spalte für Hintergrundfarbe

Gibt die Spalte an, deren Inhalt für die Hintergrundfarbe der ganzen Zeile verwendet werden soll. Diese Spalte muss im Ergebnis der SQL-Select Abfrage enthalten sein. Sie wird automatisch ausgeblendet, d.h. sie wir nicht als eigenständige Spalte in der Tabelle zu sehen sein.

Spalte für Textfarbe

Gibt die Spalte an, deren Inhalt für die Textfarbe der ganzen Zeile verwendet werden soll. Diese Spalte muss im Ergebnis der SQL-Select Abfrage enthalten sein. Sie wird automatisch ausgeblendet, d.h. sie wir nicht als eigenständige Spalte in der Tabelle zu sehen sein.

Gruppierungsfenster einblenden

Diese Eigenschaft kann nur aktiviert werden, wenn die SQL-Tabelle keine 'Virtuelle Darstellung' verwendet wird und das 'Dauerhafte Gruppieren anhand einer Spalte' deaktiviert ist. Ist diese Eigenschaft aktiv, kann der Bediener durch Drag&Drop der Spaltentitel in das Gruppierungsfenster, eine gruppierte Datendarstellung erzeugen.

Auf diese Weise lassen sich auch gestaffelte Gruppierungen erzeugen.

Erlaube Drag&Drop der Spalten

Ist diese Eigenschaft aktiviert, so kann der Bediener die Reihenfolge der Spalten durch Drag&Drop der Spaltentitel ändern.

Erlaube Entfernen von Spalten

Ist diese Eigenschaft aktiviert, so kann der Bediener Spalten aus der SQL-Tabelle durch Drag&Drop der Spaltentitel entfernen. Durch einen Rechtsklick auf die Spaltentitelleiste, erscheint das "Feldauswahl" Fenster, von dem aus die entfernten Spalten per Drag&Drop wieder eingefügt werden können.

Erlaube Mehrfachauswahl von Zeilen

Ist diese Eigenschaft aktiv, so können per Maus und Tastatur mehrere Zeilen bzw. Zeilenblöcke ausgewählt werden. Die aktuell selektierte Zeile bzw. selektierten Zeilen können mit der Funktion SqlGridStartIteration abfragt werden.

Erlaube das Löschen von Zeilen

Ist diese Eigenschaft aktiv, so klappt bei Rechtsklicken in die SQL-Tabelle ein Menü auf, von dem aus alle selektierten Zeilen sofort gelöscht werden können. Die entsprechenden Zeilen werden auch in der Datenbank gelöscht.