Browse() – Tabelle im Datenbrowser anzeigen
Die Funktion öffnet ein Fenster in welchem eine Tabelle mit den angegebenen Feldern angezeigt wird.
Parameter | Beschreibung |
---|
aParent:U | Container-Objekt (WinControl), in dem der Datenbankbrowser angezeigt werden soll. default = nil. Dies kann z.B. auch das GetForm-Objekt einer GetList sein. - Ist aParent:U nicht vom Typ Objekt, dann wird ein modales Anzeigefenster mit einem Browser generiert. - Ist aParent:U ein Text, dient er als Überschrift für das Browserfenster. - Ist aParent:U leer, wird die Eigenschaft 'DisplayLabel' der Tabelle als Überschrift verwendet. - Ist 'DisplayLabel' leer oder nicht vorhanden, wird die Eigenschaft 'AliasName' eingesetzt. - Ist 'AliasName' ebenfalls leer oder nicht vorhanden, wird 'TableName' verwendet. |
aTable:U | Bezugstabelle; default = nil Es ist auch möglich, ein Array mit Tabellen zu übergeben, die für die Codeblöcke des Browsers zur Verfügung stehen sollen. Dies ist nur dann gültig, wenn der 3. Parameter eine Browser-ID darstellt. |
aFields:U | Feldname oder FeldnamenArray oder BrowserID ("@" + max. 6 Zeichen); default = alle Felder der Bezugstabelle Feldname kann selbst auch ein Array mit folgenden Parametern sein 1. Feldname oder Feldfunktion (selbständiger Codeblock) 2. Spaltenbezeichnung (optional) 3. Spaltenbreite (optional) |
aPosition:U | Position des Browsers im Container-Objekt oder Position des Browserfensters selbst. 1. Handelt es sich bei diesem Parameter um einen einzelnen Wert, wird dieser als Alignment (Ausrichtung) betrachtet. Folgende Konstante können eingesetzt werden: alNone keinen Bezug zu den Begrenzungen des Container-Objektes alLeft immer linksbündig im Container-Objekt alRight immer rechtsbündig im Container-Objekt alTop immer an der Oberkante des Container-Objektes alBottom an der Unterkante des Container-Objektes alClient Browser füllt nach Möglichkeit das ganze Container-Objekt 2. Handelt es sich um ein Array mit zwei Elementen, dann wird das erste Element als Alignment betrachtet. Im Falle von alLeft oder alRight wird das zweite Element als Breite eingesetzt, in den Fällen alTop und alBottom als Höhe, ansonsten wird es ignoriert. 3. Handelt es sich um ein Array mit vier Elementen 1. Element: X-Position der linken oberen Ecke, 2. Element: Y-Position der linken oberen Ecke 3. Element: Breite 4. Element: Höhe Andere Arraydimensionierungen werden ignoriert. Wird der Browser in einem eigenständigen Fenster angezeigt (1. Parameter Empty), dann gelten Positionsangaben als Desktop-Koordinaten des Container-Fensters. Der Browser selbst füllt in diesem Fall immer das gesamte Fenster aus. Angaben zum Alignment bleiben bei dieser Aufrufvariante unberücksichtigt. Werden keine Desktopkoordinaten angegeben, wird das Fenster auf 6/8 der Bildschirmfläche zentriert angezeigt. |
aReadOnly:L | ReadOnly; default = true true – Lesemodus kein editieren möglich false – editierbar solange die Änderungen nicht den Feldrechten wieder sprechen |
aDeleteLock:L | DeleteLock; default = true true – es können keine Datensätze gelöscht werden false – Datensätze können gelöscht werden |
aInsertLock:L | Insert Lock; default = true true – es können keine neuen Datensätze erzeugt werden false – Neue Datensätze können erzeugt werden |
aAutoCancel:L | AutoCancel; default = true Setzt die Grid-Eigenschaft dgCancelOnExit, also das Abbrechen eines Editmodus, falls das Grid den Fokus verliert (z.B. das modale Fenster geschlossen wird) |
Rückgabewert
Tabellenbrowser-Objekt
Beispiel
CODE
| oDab000:DB := 'waDAB000', aFields |
aFields := <code>'KDNR', 'Kunden-Nummer', 100}, {'NAME1', 'Name', 300</code>,
Browse("Kunde mit Kundennummer", oDab000, aFields),
Weitere Verknüpfungen