Zweck
Verknüpft einen Datenserver mit einen Browser.
Klasse
Typ
Methode
Syntax
<oBrowser>:Use(
[<oServer>],
[<auField>],
[<auFieldOpen>],
[<auFormat>]
) Æ lSuccess
Argumente
<oServer> | Datenserver, der mit dem Browser verknüpft werden soll. Wenn der Browser bereits mit einem Datenserver verknüpft ist, wird zuerst diese Verbindung aufgehoben. Wenn dieses Argument nicht angegeben wird, dann wird nur die Verbindung mit einem bereits verknüpften Datenserver aufgehoben. In diesem Fall werden die restlichen Argumente nicht berücksichtigt. |
Datentyp: | Object |
<auField> | Array der Felder, die der Browser unterstützen soll. Das Array kann sowohl Feldnummern als auch Feldnamen (String oder Symbol) enthalten. Wird dieses Argument nicht angegeben, dann unterstützt der Browser alle Felder des übergebenen Datenserver. |
Datentyp: | Array |
<auFieldOpen> | Array der Felder, die im Browser automatisch geöffnet und angezeigt werden sollen. Das Array kann sowohl Feldnummern als auch Feldnamen (String oder Symbol) enthalten. |
Wird dieses Argument nicht angegeben, dann werden alle unterstützten Felder (siehe Argument <auField>) angezeigt.
Wird ein leeres Array {} angegeben, dann werden keine Spalten angezeigt.
Es sind nur Felder erlaubt, die durch das Argument <auField> definiert sind.
Datentyp: | Array |
<auFormat> | Array mit Formatierungen für die Spalten. Wird dieses Argument angegeben, dann wird die Methode bBrowser:FormatColumns() mit diesem Argument aufgerufen. Eine genaue Beschreibung zu dem Array kann der Methode bBrowser:FormatColumns()entnommen werden. |
Datentyp: | Array |
Rückgabewert
lSuccess | Logischer Wert der definiert, ob der Datenserver mit dem Browser verknüpft werden konnte. |
TRUE | Der Datenserver konnte verknüpft werden. |
FALSE | Der Datenserver konnte nicht verknüpft werden. |
Datentyp: | Logic |
Beschreibung
bBrowser:Use() verknüpft einen Datenserver mit dem Browser und registriert den Browser über die Methode oServer:RegisterClient() als Client des Servers. Zusätzlich werden zu den Feldern aus dem Argument <auField> Datenspalten erzeugt. Wurde dieses Argument nicht angegeben, werden zu allen Feldern des Datenserver Datenspalten erzeugt. Anschließend werden die Datenspalten zu den Feldern aus dem Argument <auFieldOpen> im Browser geöffnet und angezeigt. Wurde dieses Argument nicht angegeben, werden die Spalten zu allen unterstützten Feldern geöffnet und angezeigt. Sollen keine Spalten geöffnet werden, muss in <auFieldOpen> ein leeres Array ( {} ) übergeben werden.
Der bBrowser verwaltet zwei Listen. Die erste Liste definiert die Datenspalten (Felder), die der Browser unterstützt. Die zweite Liste ist eine Untermenge der ersten Liste und definiert die Datenspalten (Felder), die der Browser geöffnet (angezeigt) hat und zu denen der Anweder die Daten sieht bzw. in denen er navigieren kann.
Um die Zugriffe auf den Datenserver zu optimieren, sollte vor dem Aufruf der Methode bBrowser:Use() der bBrowser:ServerType definiert werden. Wenn kein Server-Typ definiert ist, versucht die Methode bBrowser:Use() den Typ des Datenserver anhand der Server-Klasse zu ermitteln. Die folgenden Klassen werden automatisch erkannt:
Klasse |
ServerType |
DBServer |
#Dbase |
SQLSelect |
#SQL |
ADOServer |
#SQL |
ADORecordSet |
#SQL |
Soll der Datenserver automatisch geschlossen werden, sobald der Browser zerstört oder mit einem neuen Datenserver verknüpft wird, muss dem Zugriff bBrowser:AutoClose der Wert TRUE zugewiesen werden.
Hinweise!
Wenn der Browser bereits mit einem Datenserver verknüpft ist, dann werden alle bereits vorhandenen Datenspalten aus dem Browser entfernt und mit der Methode bBrowserColumn:Destroy() zerstört. Außerdem wird der Browser über die Methode oServer:UnregisterClient() als Client des Servers abgemeldet.
Beispiele
In dem folgenden Beispiel werden alle Felder der Datenbank 'KUNDE.DBF' im Browser angezeigt.
odbsCUSTOMER := DBServer{"CUSTOMER"}
oBrowser := bBrowser{oOwner,;
1000,;
Point{0, 0},;
Dimension{300, 250}}
oBrowser:ServerType := #DBase
oBrowser:Use(odbsCUSTOMER)
oBrowser:Show()
In dem folgenden Beispiel wird davon ausgegangen das die Datenbank 'CUSTOMER.DBF' die Felder 'ID', 'LASTNAME', 'FIRSTNAME', 'STREET', 'ZIP' und 'CITY' enthält. Die Datenbank wird mit dem Browser verknüpft, wobei aber nur die Felder 'ID', 'LASTNAME' und 'FIRSTNAME' angezeigt werden.
odbsCUSTOMER := DBServer{"CUSTOMER"}
IF odbsCUSTOMER:Used
oBrowser := bBrowser{oOwner,;
1000,;
Point{0, 0},;
Dimension{300, 250}}
oBrowser:ServerType := #DBase
oBrowser:Use(odbsCUSTOMER,, {#ID, #LASTNAME, #FIRSTNAME})
oBrowser:Show()
ENDIF
In dem folgenden Beispiel werden keine Spalten im Browser angezeigt.
odbsCUSTOMER := DBServer{"CUSTOMER"}
IF odbsCUSTOMER:Used
oBrowser := bBrowser{oOwner,;
1000,;
Point{0, 0},;
Dimension{300, 250}}
oBrowser:ServerType := #DBase
oBrowser:Use(odbsCUSTOMER,, {})
oBrowser:Show()
ENDIF
Siehe auch
Page url: http://www.YOURSERVER.com/index.html?bbrowser_use.htm