Navigation:  bBrowser >

bBrowser:Use()

Diese Seite drucken    Vorherige SeiteZurück zum Anfang des KapitelsNächste Seite

Zweck

Verknüpft einen Datenserver mit einen Browser.

Klasse

bBrowser

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.

 

Der Browser erzeugt für alle unterstützten Felder automatisch Datenspalte. Wird ein leeres Array {} angegeben, dann werden keine Datenspalten erzeugt.

 

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

lSuccessLogischer Wert der definiert, ob der Datenserver mit dem Browser verknüpft werden konnte.
TRUEDer Datenserver konnte verknüpft werden.
FALSEDer 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

bBrowser:AddColumn()

bBrowser:AutoClose

bBrowser:Clear()

bBrowser:FormatColumns()

bBrowser:InitRecordScope()

bBrowser:OpenColumn()

bBrowser:Server

bBrowser:ServerType

bBrowser:Used

bBrowserColumn:Destroy()

 


Page url: http://www.YOURSERVER.com/index.html?bbrowser_use.htm