Zum Inhalt springen

Programmieren mit dBASE PLUS: Klasse Browse

Aus Wikibooks


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:
Eigenschaft Event Methode

before
borderStyle
dragEffect
enabled
fontBold
fontItalic
fontName
fontSize
form
height
helpFile
helpId
hWnd
id
left
mousePointer
name
pageno
parent
printable
statusMessage
tabStop
top
visible
width

onDesignOpen
onDragBegin
onGotFocus
onHelp
onLeftDblClick
onLeftMouseDown
onLeftMouseUp
onLostFocus
onMiddleDblClick
onMiddleMouseDown
onMiddleMouseUp
onMouseMove
onOpen
onRightDblClick
onRightMouseDown
onRightMouseUp
when

drag( )
move( )
release( )
setFocus( )

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:

  • Die Eigenschaft view des übergeordneten Formulars.
  • Die Eigenschaft alias des Browse-Objekts.

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.)