Programmieren mit dBASE PLUS: Klasse Browse
Ein Werkzeug zur Datenbearbeitung, das mehrere Datensätze in Zeilen und Spalten anzeigt.
Syntax
[Bearbeiten][<oReferenz> =] new Browse(<Container> [,<Name AusdruckZ>])
<oReferenz>
Eine Variable oder Eigenschaft (normalerweise von <Container>), in der eine Referenz auf das neu erstellte Browse-Objekt gespeichert wird.
<Container>
Der Container (normalerweise ein Form-Objekt), mit dem das Browse-Objekt verbunden wird.
<Name AusdruckZ>
Ein optionaler Name für das Browse-Objekt. Wird dieser Name nicht angegeben, erzeugt die Klasse Browse automatisch einen Namen für das Objekt.
Spezielle Eigenschaften
[Bearbeiten]Die folgenden Tabellen enthalten die speziellen Eigenschaften, Events und Methoden der Klasse Browse.
| Eigenschaft | Vorgabe | Beschreibung |
| alias | Die Tabelle, auf die zugegriffen wird. | |
| allowDrop | false | Bestimmt, ob es ein Objekt zuläßt, dass gezogenen Objekte darauf abgelegt werden dürfen. |
| anchor | 0 - Nicht verankert | Die Art und Weise, in der das beschriebene Objekt in seinem Container verankert ist (0=Nicht verankert, 1=Unten, 2=Oben, 3=Links, 4=Rechts, 5=Mitte, 6=Container). |
| append | true | Gibt an, ob Zeilen hinzugefügt werden können. |
| baseClassName | BROWSE | Kennzeichnet das Objekt als Instanz der Klasse Browse. |
| className | BROWSE | Kennzeichnet das Objekt als Instanz der abgeleiteten benutzerdefinierten Klasse. Wenn keine benutzerdefinierte Klasse existiert, gilt die Voreinstellung von baseClassName. |
| colorHighlight | WindowText/Windows | Die Farbe einer optisch hervorgehobenen Zelle. |
| colorNormal | WindowText/Windows | Die Farbe für alle anderen Zellen. |
| cuaTab | true | Gibt an, ob das Drücken von Tab dem CUA-Verhalten entspricht und ein Wechsel zum nächsten Steuerelement erfolgt, oder ob auf der nächsten Zelle positioniert wird. |
| fields | Die anzuzeigenden Felder und die Optionen, die auf jedes Feld angewendet werden sollen. | |
| frozenColumn | Der Name der inneren Spalte auf die der Cursor begrenzt ist. | |
| lockedColumns | 0 | Die Anzahl der Spalten die auf der linken Seite des aktuellen Grids blockiert bleiben, während es horizontal gescrolled wird. |
| modify | true | Gibt an, ob der Benutzer Daten ändern kann, weil er entsprechende Rechte dazu hat. |
| scrollBar | Auto | Gibt an, wann für das Beschriebene-Objekt eine Bildlaufleiste angezeigt wird (0=Aus, 1=Ein, 2=Auto, 3=Deaktiviert). |
| text | Der Titel, der in der Überschrift angezeigt wird. |
| Event | Parameter | Beschreibung |
| onAppend | Wird nach dem Hinzufügen eines Datensatzes zur Tabelle ausgelöst. | |
| onChange | {{{Wert}}} | Wird nach der Änderung eines Wertes durch den Benutzer ausgelöst. |
| onDragEnter | <left expN> <top expN> <type expC> <name expC> |
Wenn die Maus im Anzeigefeld eines aktiven Drop Targets erscheint |
| onDragLeave | Wird ausgelöst, wenn die Maus ein aktives “Drop-Ziel” und den Bereich der Objektanzeige verlässt ohne das etwas reingezogen würde. | |
| onDragOver | <left expN> <top expN> <type expC> <name expC> |
Wird ausgelöst, während die Maus sich über dem Anzeigefeld eines aktiven Drop Target Objekts befindet. |
| onDrop | <left expN> <top expN> <type expC> <name expC> |
Wenn der Mausknopf während einer Drag&Copy Operation über einem aktiven Drop Target Objekt losgelassen wird. |
| onNavigate | Wird ausgelöst, nachdem der Benutzer den Mauszeiger auf einen anderen Datensatz verschoben hat. |
| Methode | Parameter | Beschreibung |
|---|---|---|
| copy( ) | Der ausgewählte Text wird in die Zwischenablage von Windows kopiert. | |
| cut( ) | Der ausgewählte Text wird ausgeschnitten und in die Zwischenablage von Windows eingefügt. | |
| keyboard( ) | <AusdruckZ> | Simulation von Benutzereingaben im Browse-Objekt. |
| paste( ) | Text wird aus der Windows-Zwischenablage an die aktuelle Cursorposition kopiert. | |
| undo( ) | Die zuletzt mit cut( ), copy( ) oder paste( ) ausgeführte Aktion wird rückgängig gemacht. |
Die folgende Tabelle enthält die Basis-Eigenschaften, -Events und -Methoden der Klasse Browse:
Beschreibung
[Bearbeiten]Das Objekt Browse wurde aus Gründen der Kompatibilität beibehalten. Es dient ausschließlich der Anzeige und Bearbeitung von Tabellen, die im Arbeitsbereichen geöffnet sind. Für Formulare, die mit Datenzugriffsobjekten arbeiten, verwenden Sie statt dessen ein Grid-Objekt. Die beiden folgenden Eigenschaften legen fest, welche Tabelle im Browse-Objekt angezeigt wird:
Mit Hilfe der Eigenschaft fields können Sie bestimmte Felder angeben, die angezeigt werden sollen. Wenn das Formular des Browse-Objekts beispielsweise auf einer Abfrage basiert, können Sie mit fields Felder aus den Tabellen der Abfrage anzeigen. (Sie müssen allerdings vor der Verwendung von fields mit Hilfe der Eigenschaft alias eine Datei angeben.)