GAMBAS BOOK 3.18.4

These are the main grid properties that you can set or read:

Table: 17.7.2.1 Description Grid property .Header.

The properties can apply to all columns or only to selected columns:

tablelayout

Table: 17.7.2.2 Description of selected grid properties - columns

The same applies to the rows in the GridView:

tablelayout

Table: 17.7.2.3 Description of selected grid properties - rows

The description of further properties of the GridView follows:

tablelayout

Table: 17.7.2.4 Description of selected grid properties

These two methods are of particular interest:

Table: 17.7.2.5 Description of selected methods

It has proved to be advantageous to set the grid properties in a separate procedure, as shown in the following excerpts from two different source texts. The number of columns is known in the first section:

PRIVATE SUB SetGridProperty() 
  GridView1.Resizable = TRUE  ' Muss vor allen anderen Eigenschaften gesetzt werden
  GridView1.Mode = Select.Single
  GridView1.Columns.Count = 4 
  GridView1.Header = GridView1.Both 
  GridView1.Columns[0].Width = 110 
  GridView1.Columns[0].Title = "Zahl" 
  GridView1.Columns[1].Width = 120 
  GridView1.Columns[1].Title = "Wahrheitswert" 
  ...
END ' SetGridProperty()

In the second source code excerpt, the number of columns is determined and the column headers are generated dynamically:

PUBLIC SUB SetGridViewProperty() 
  DIM iDatensatzNummer, iSpaltenNummer AS Integer   
 
GridView.Header = 1 ' GridView.Horizontal
  GridView.Columns.Count = rDBResult.Fields.Count 
  GridView.Columns[0].Width = 25 
  GridView.Columns[0].Resizable = FALSE ' Nur diese Feldbreite ist fix
' GridView-Spalten-Bezeichner ermitteln und eintragen 
  FOR iSpaltenNummer = 0 TO rDBResult.Fields.Count - 1 
      GridView.Columns[iSpaltenNummer].Title = rDBResult.Fields[iSpaltenNummer].Name 
  NEXT ' Feldname 
END ' SetGridViewProperty

The following sections describe projects that use a GridView to display data from different sources and offer various options for inserting the data:

• GridView with fixed number of columns; insertion of data without buffering
• Display of data from a database table, where the number of rows and columns - depending on the SQL query - is not known at program start.
• Export data from a GridView to a csv file.
• Data import from a csv file and display the data in a GridView.

The next two projects only make sense if you can save the manipulated data in the grid view, for example, in a csv file or read it in again:

• Change of contents of selected cells in a GridView,
• Change selected cells in a GridView using a special class.

The final project requires Gambas 3 - at least in revision 4715:

• Sorting of data in a GridView

The source code is only fully specified and explained for those procedures and functions that are necessary for understanding the properties and methods used in GridView.

Das sind die wesentlichen Gittereigenschaften, die Sie setzen oder auslesen können:

Tabelle: 17.7.2.1 Beschreibung Gittereigenschaft .Header

Die Eigenschaften können für alle Spalten oder nur für ausgewählte gelten:

Tabelle: 17.7.2.2 Beschreibung ausgewählter Gittereigenschaften – Spalten

Für die Zeilen in der GridView gilt Analoges:

Tabelle: 17.7.2.3 Beschreibung ausgewählter Gittereigenschaften - Zeilen

Es folgt die Beschreibung weiterer Eigenschaften der GridView:

Tabelle: 17.7.2.4 Beschreibung ausgewählter Gittereigenschaften

Interessant sind vor allem diese beiden Methoden:

Tabelle: 17.7.2.5 Beschreibung ausgewählter Methoden

Es hat sich als vorteilhaft erwiesen, das Setzen der Gittereigenschaften in einer eigenen Prozedur zu realisieren, wie es die folgenden Auszüge aus zwei verschiedenen Quelltexten zeigen. Im ersten Ausschnitt ist die Anzahl der Spalten bekannt:

PRIVATE SUB SetGridProperty() 
  GridView1.Resizable = TRUE  ' Muss vor allen anderen Eigenschaften gesetzt werden
  GridView1.Mode = Select.Single
  GridView1.Columns.Count = 4 
  GridView1.Header = GridView1.Both 
  GridView1.Columns[0].Width = 110 
  GridView1.Columns[0].Title = "Zahl" 
  GridView1.Columns[1].Width = 120 
  GridView1.Columns[1].Title = "Wahrheitswert" 
  ...
END ' SetGridProperty()

Im zweiten Quelltext-Auszug werden die Anzahl der Spalten ermittelt sowie die Spaltenüberschriften dynamisch generiert:

PUBLIC SUB SetGridViewProperty() 
  DIM iDatensatzNummer, iSpaltenNummer AS Integer   
 
GridView.Header = 1 ' GridView.Horizontal
  GridView.Columns.Count = rDBResult.Fields.Count 
  GridView.Columns[0].Width = 25 
  GridView.Columns[0].Resizable = FALSE ' Nur diese Feldbreite ist fix
' GridView-Spalten-Bezeichner ermitteln und eintragen 
  FOR iSpaltenNummer = 0 TO rDBResult.Fields.Count - 1 
      GridView.Columns[iSpaltenNummer].Title = rDBResult.Fields[iSpaltenNummer].Name 
  NEXT ' Feldname 
END ' SetGridViewProperty

In den folgenden Kapiteln werden Ihnen Projekte vorgestellt, die eine GridView zur Anzeige von Daten aus unterschiedlichen Quellen nutzen und verschiedene Möglichkeiten zum Einfügen der Daten bieten:

• GridView mit fester Anzahl der Spalten; Einfügen der Daten ohne Zwischenspeicherung
• GridView mit fester Anzahl der Spalten; Speichern der Daten in einer Matrix und Einfügen der Daten mit dem Ereignis GridView_Data(Row AS Integer, Column AS Integer) – verbunden mit Möglichkeiten, zum Beispiel die Gitterzeilen oder Gitterzellen in besonderer Weise farblich auszuzeichnen.
• Anzeige von Daten aus einer Datenbank-Tabelle, wobei die Anzahl der Zeilen und Spalten – abhängig von der SQL-Anfrage – beim Programmstart nicht bekannt ist.
• Daten-Export aus einer GridView in eine csv-Datei.
• Daten-Import aus einer csv-Datei und Anzeige der Daten in einer GridView.

Die nächsten zwei Projekte machen nur dann Sinn, wenn Sie die manipulierten Daten in der Gitteransicht zum Beispiel in einer csv-Datei speichern oder aus dieser wieder einlesen können:

• Änderung von Inhalten ausgewählter Zellen in einer GridView,
• Änderung ausgewählter Zellen in einer GridView unter Verwendung einer speziellen Klasse.

Das abschließende Projekt benötigt Gambas 3 – mindestens in der Revision 4715:

• Sortierung von Daten in einer GridView

Der Quelltext wird nur für jene Prozeduren und Funktionen vollständig angegeben und erläutert, die für das Verständnis der verwendeten Eigenschaften und der eingesetzten Methoden der GridView notwendig sind.