Copyright: Copyright © 1995 Gfi mbH
Citation: Copyright © 1995 Gfi mbH


Inhalt

Unit

DBExtend

Der TDBExtender :

Die Komponente TDBExtender erweitert die datenbankbezogenen Möglichkeiten von Delphi und deren Komponenten um ein Vielfaches. "Standard"-Datenbankfunktionen, wie Datensatzwechsel durch Tastensteuerung innerhalb datensensitiver Dialogobjekte, Feldwertsuche auf Nicht-Schlüsselfeldern, Nachschlagen mittels Anzeige der in der Tabellenstruktur referenzierten Tabelle und Übernahme gleichnamiger Felder, etc., werden erst mit Einsatz dieser Komponente ohne zusätzlichen Programmieraufwand möglich.

Sämtliche Funktionen wurden auf die mit Delphi mitgelieferten Komponenten abgestimmt, ohne diese zu modifizieren. Hierraus resultiert die Sicherstellung, Updates von BORLAND bezüglich Delphi und deren Komponenten ohne Anpassung aufspielen zu können.

Der TDBENavigator :

Der TDBENavigator entspricht im Prinzip dem Standardcontrol TDBNavigator, nutzt jedoch die erweiterten Funktionen des TDBExtenders. Alle Funktionen, die durch den TDBExtender mittels Tastendruck erreichbar sind, können durch dieses Control via Speedbuttons mittels Mausklick ausgelöst werden.

Durch seine Bindung an den im Formular plazierten TDBExtender ist eine Anbindung an eine DataSource nicht nötig. Auch wird nicht pro DataSource jeweils ein Navigator benötigt. Der TDBENavigator wird durch den TDBExtender automatisch auf die DataSource des aktiven Dialogelements geschaltet; der besondere Clou : diese Aufschaltung funktioniert auch bei der Plazierung des Navigators im Rahmenformular einer MDI-Anwendung, d.b. plazieren Sie den Navigator im Speedbarpanel des Rahmenformulars und steuern Sie damit die Datenbanken innerhalb des jeweils aktiven MDI-Child-Fensters !

Funktionsumfang :

Online-Hilfe in die IDE integrierbar

Feldwechsel mittels [Enter] (TAB-Ersatz in BEIDE Richtungen)

Feldwertsuche auf Nichtschlüsselfeldern (inkl. Teilstringsuche und Memofeldern)

Suchrichtung festlegbar (für Weitersuchen auch temporär)

Lesezeichenverwaltung (Bookmarks)

Tabellenfilter (verwendet Highspeed BDE-Filter)

Tabellenansicht (mit Unterscheidung fsNormal, fsMDIChild)

Gruppenweises Manövrieren

Feldwert duplizieren

Datensatz duplizieren

Feldwert nachschlagen im Paradox-Stil (Aufgrund der Tabellendefinition)

Formular-Globales Editieren ein-/ausschalten

Vertikaler Navigator

Automatische Navigatorverwaltung bei MDI-Anwendungen

Tabellen-Statusanzeige in einem Panel (RecNo, RecCount, Tablename, TableState)

DBExceptionhandling in Form von Meldungen in einem Panel

 = Fertiges Dialogfenster


Eigenschaft DataSource

Verwendet für

TDBENavigator, Komponente

Deklaration

property DataSource : TDataSource;

Beschreibung

Nur zur Laufzeit und nur Lesen. Diese Eigenschaft gibt die DataSource zurück, auf die der Navigator aktuell angewendet wird.


Eigenschaft VisBtnsRecord

Verwendet für

TDBENavigator, Komponente

Deklaration

property VisBtnsRecord : TRecordBtnSet;

Beschreibung

Über den Satz VisBtnsRecord legen Sie fest, welche Speedbuttons in der Funktionsgruppe Record sichtbar sind.

Mögliche Werte, die eingeschlossen werden können :

Wert	Sichtbarer Speedbutton

rnbInsert	Datensatz einfügen

rnbDelete	Datensatz löschen

rnbEdit	Datensatz in den Editmodus bringen

rnbPost	Datensatzänderungen bestätigen

rnbCancel	Datensatzänderungen verwerfen

rnbRefresh	Datenquelle erneuern


Eigenschaft VisBtnsSearch

Verwendet für

TDBENavigator, Komponente

Deklaration

property VisBtnsSearch : TSrchBtnSet;

Beschreibung

Über den Satz VisBtnsSearch legen Sie fest, welche Speedbuttons in der Funktionsgruppe Suchen sichtbar sind.

Mögliche Werte, die eingeschlossen werden können :

Wert	Sichtbarer Speedbutton

snbSearch	Feldwert suchen

snbSearchNext	Letzte Suche wiederholen

snbSetBookmark	Lesezeichen setzen

snbGotoBookmark	Gehe zu Lesezeichen

snbTblFilter	Tabellenfilter bearbeiten

snbActiveFilter	Tabellenfilter aktivieren / deaktivieren

snbTableView	Schalte in Tabellenansicht um


TDBExtender Komponente

Eigenschaften	Methoden	Ereignisse	Tastaturbelegung

Unit

DBExtend

Beschreibung

Verwenden Sie die Komponente TDBExtender, um allen TTables, TQueries, TDataSources und datensensitiven Dialogelementen innerhalb eines Formulares eine umfangreiche Funktionserweiterung zukommen zu lassen.

Plazieren Sie einen TDBExtender im Formular. Angaben zu den verwendeten Datenquellen sind nicht nötig, da TDBExtender automatisch die verwendeten Datenquellen ermittelt und intern verwaltet.

Bearbeiten Sie die Eigenschaft AllowKeys, um festzulegen, welche Tastenkombinationen zur Datenbanksteuerung von TDBExtender behandelt werden sollen. Handelt es sich bei dem fokussiertem Dialogobjekt um ein TDBEdit, TDBMemo, TDBRadioGroup, TDBCheckBox, TDBGrid oder TDBImage werden die Aktionen auf die dem Dialogobjekt angebundene DataSource (bzw. DataSet) ausgeführt.

Maussteuerung für den TDBExtender erhalten Sie über den TDBENavigator. Wie bei dem Zusammenspiel zwischen TNavigator und TDataSource übernimmt der TDBExtender die Aktualisierung der Buttonstati der angeschlossenen TDBENavigatoren.

Setzen Sie die Eigenschaft MoveBy auf die Anzahl von Datensätzen, die bei einem Datensatzgruppenwechsel übersprungen werden sollen.

Die Eigenschaften TVReadonly und TVAutoEdit stellen Vorgabewerte für Tabellenansichten dar. Wünschen Sie eine genaue Steuerung des Erscheinungsbildes und des Verhaltens für Tabellenansichten, verwenden Sie OnTableView.

Haben Sie StatusPanel einen Panel zugewiesen, können Sie über ShowStatusOptions festlegen, welche Statusinformationen der aktuellen Datenquelle angezeigt werden sollen.

Verwenden Sie MessagePanel, um aktuelle Informationen und Datenbankfehler (wenn HandleDBExceptions gesetzt ist) angezeigt zu bekommen

Mit der Eigenschaft MasterSource können Sie eine DataSource festlegen, auf die sich Tastaturaktionen und TDBENavigator-aktionen beziehen sollen, wenn zur Laufzeit aktuell kein datensensitives Dialogelement den Focus besitzt.

Ist ManageGlobalEdit auf TRUE gesetzt, können Sie mittels GlobalEdit einen für das gesamte Formular und alle enthaltenen Datenquellen gültigen Editiermodus ein und ausschalten.


TDBENavigator Komponente

Eigenschaften	Methoden	Ereignisse	Speedbuttons

Unit

DBExtend

Beschreibung

Die Komponente TDBENavigator (TDBExtender-Navigator) wird zum Steuern der aktuellen Datenquelle, die durch den angeschlossenen TDBExtender bestimmt wird, verwendet. Sie projeziert die Aktionen, die durch den TDBExtender mittels Tastatur erreicht werden können, auf eine Reihe von Speedbuttons.

Verknüpfen Sie den TDBENavigator mittels der Eigenschaft DBExtender mit einem TDBExtender. Die einzelnen Schalter werden durch den TDBExtender aktiviert bzw. deaktiviert.

Verwenden Sie die Eigenschaften VisBtnsSearch, VisBtnsMove, VisBtnsRecord und VisBtnsExtend um die anzuzeigenden Speedbuttons der einzelnen Funktionsgruppen festzulegen.

Verwenden Sie die Eigenschaften GroupSpace1, GroupSpace2 und GroupSpace3, um die Abstände zwischen den einzelnen Funktionsgruppen festzulegen.

Verwenden Sie die Eigenschaft HorizOrientation, um den Navigator horizontal bzw. vertikal darzustellen.


TDBExtender Methoden
Methoden

Create	DuplicateFromPrior	SelectBookmark

Destroy	DuplicateRecFromPrior	LUDlg

AddNavigator	TableView

RemoveNavigator	LocatePattern

ShowStatus	LocateNextPattern

PanelMessage	LocateNextPatternReverse

ControlIsDBAware	LocateViaDlg

HandleNBBtn

GetDSFromControl

GetDS_Tbl_Fld


Eigenschaft DBExtender

Verwendet für

TDBENavigator, Komponente

Deklaration

property DBExtender : TDBExtender;

Beschreibung

Verwenden Sie die Eigenschaft DBExtender, um den Navigator an einen TDBExtender zu binden. Dieses Vorgehen entspricht der DataSource-Bindung des TDBNavigators.


Methode Create

Verwendet für

TDBExtender, Komponente

Deklaration

constructor Create(AOwner : TComponent);

Beschreibung


Methode AddNavigator

Verwendet für

TDBExtender, Komponente

Deklaration

procedure AddNavigator(Nav: TDBENavigator);

Beschreibung


Methode Destroy

Verwendet für

TDBExtender, Komponente

Deklaration

destructor Destroy;

Beschreibung


Methode RemoveNavigator

Verwendet für

TDBExtender, Komponente

Deklaration

procedure RemoveNavigator(Nav: TDBENavigator);

Beschreibung


Methode ShowStatus

Verwendet für

TDBExtender, Komponente

Deklaration

procedure ShowStatus(DS : TDataSource);

Beschreibung


Methode PanelMessage

Verwendet für

TDBExtender, Komponente

Deklaration

procedure PanelMessage( msg : String );

Beschreibung


Methode ControlIsDBAware

Verwendet für

TDBExtender, Komponente

Deklaration

function ControlIsDBAware( Control : TControl ) : Boolean;

Beschreibung


Methode HandleNBBtn

Verwendet für

TDBExtender, Komponente

Deklaration

procedure HandleNBBtn( Btn : TDBENavigateBtn; Shift: TShiftState; Info : Longint);

Beschreibung


Methode GetDSFromControl

Verwendet für

TDBExtender, Komponente

Deklaration

function GetDSFromControl( AControl : TObject; Var DS : TDataSource) : Boolean;

Beschreibung


Methode GetDS_Tbl_Fld

Verwendet für

TDBExtender, Komponente

Deklaration

function GetDS_Tbl_Fld(	AControl : TObject;

Var DS : TDataSource;

Var Tbl : TDBDataSet;

Var Fld : TField;

Var FldNo : Integer;

Var IsReadOnly : Boolean):Boolean;

Beschreibung


TDBENavigator Eigenschaften
Eigenschaften

DataSource

DBExtender

VisBtnsSearch

VisBtnsMove

VisBtnsRecord

VisBtnsExtend

GroupSpace1

GroupSpace2

GroupSpace3

HorizOrientation

ButtonWidth

ButtonHeight

Align

DragCursor

DragMode

Enabled

Ctl3D

Hints

ParentCtl3D

ParentShowHint

PopupMenu

ConfirmDelete

ShowHint

TabOrder

TabStop

Visible

Hinweis : Eigenschaften ohne Sprungmarke entsprechen denen des TDBNavigators.


Methode DuplicateFromPrior

Verwendet für

TDBExtender, Komponente

Deklaration

function DuplicateFromPrior(Fld : TField; Confirm : Boolean) : Boolean;

Beschreibung


Methode DuplicateRecFromPrior

Verwendet für

TDBExtender, Komponente

Deklaration

function DuplicateRecFromPrior(DTbl : TDBDataSet; Confirm : Boolean):Boolean;

Beschreibung

DuplicateRecFromPrior erzeugt einen neuen Datensatz, kopiert alle freigegebenen Felder des vorherigen aktuellen Datensatzes auf den neuen, und macht ihn zum aktuellen Datensatz.


Methode LocatePattern
Methode LocatePattern,

Verwendet für

TDBExtender, Komponente

Deklaration

function LocatePattern(	Tbl : TDBDataSet;

FldName,

SrchStr : String;

IgnoreCase,

SrchDown : Boolean ) : Boolean;

Beschreibung


Methode LocateNextPattern

Verwendet für

TDBExtender, Komponente

Deklaration

function LocateNextPattern( Tbl : TDBDataSet ) : Boolean;

Beschreibung


Methode LocateNextPatternReverse

Verwendet für

TDBExtender, Komponente

Deklaration

function LocateNextPatternReverse( Tbl : TDBDataSet ) : Boolean;

Beschreibung


Methode LocateViaDlg

Verwendet für

TDBExtender, Komponente

Deklaration

procedure LocateViaDlg( Tbl : TDBDataSet; FldName : String );

Beschreibung


Methode SelectBookmark

Verwendet für

TDBExtender, Komponente

Deklaration

procedure SelectBookmark(Tbl : TDBDataSet);

Beschreibung


Methode LUDlg

Verwendet für

TDBExtender, Komponente

Deklaration

procedure LUDlg(	DTbl : TDBDataSet;

LUType : LKUPType;

TblName : TFileName;

Var Fld : TField);

Beschreibung


Methode TableView

Verwendet für

TDBExtender, Komponente

Deklaration

procedure TableView(Tbl : TDBDataSet; KeepSynchron : Boolean);

Beschreibung


TDBExtender Eigenschaften
Eigenschaften

OwnerForm

GlobalEdit

AktDataSource

AktFieldHasLU

SrchPossible

NextSrchPossible

TblViewPossible

AktFilterState

MoveBy

AllowKeys

ConfirmDelete

ConfDelQuestion

ConfirmOverride

ConfOverQuestion

TVReadonly

TVAutoEdit

HandleDBExceptions

ShowStatusOptions

StatusPanel

MessagePanel

MasterSource

ManageGlobalEdit


TDBENavigator Ereignisse
Ereignisse

OnClick;

OnDblClick;

OnDragDrop;

OnDragOver;

OnEndDrag;

OnEnter;

OnExit;

OnResize;

Hinweis : Ereignisse ohne Sprungmarke entsprechen denen des TDBNavigators.


Eigenschaft MoveBy
MoveBy, Eigenschaft

Verwendet für

TDBExtender, Komponente

Deklaration

property MoveBy : Integer;

Beschreibung

Diese Eigenschaft legt fest, um wieviel Datensätze sich der Tabellenzeiger bei einem Datensatzgruppenwechsel bewegen soll. Der Vorgabewert ist 5.


TDBExtender Ereignisse
Ereignisse

AppOnMessage

AppOnException

ScreenOnACChange

FormOnActivate

FormOnDeactivate

FormOnKeyPhysical

FormOnFocusControl

FormOnException

OnActiveChanged

OnDataSetChanged

OnDataSetScrolled

OnEditingChanged

OnTableView


Eigenschaft AllowKeys

Verwendet für

TDBExtender, Komponente

Deklaration

property AllowKeys : TAllowKeys;

Beschreibung

Über den Satz AllowKeys legen Sie fest, welche Aktionen für für den Benutzer freigegeben sind. Nicht enthaltene Werte unterbinden die Tasteninterpretation und deaktivieren die entsprechenden Buttons der angeschlossenen TDBENavigatoren.

Mögliche Werte, die eingeschlossen werden können :

Wert	Bedeutung

akSelectNext	Falls True, kann der Anwender mittels [Enter] / [Alt]- oder [Ctrl]-[Enter] das nächste bzw. vorherige Dialogobjekte selektieren. (Für diese Aktion gibt es keinen Button im TDBENavigator)

akDBMove	Falls True, kann der Anwender durch die Datenquelle manövrieren. Falls False, kann der aktuelle Datensatz nur noch programmgesteuert gewechselt werden.

akLookUp	Falls True, kann der Anwender den Feldwert nachschlagen, wenn das Feld der Tabelle als Nachschlagefeld mit Hilfe definiert ist.

akSearch	Falls True, ist dem Anwender ein Suchen, bzw. Weitersuchen auf Feldern gestattet.

akBookmark	Falls True, kann der Anwender Lesezeichen setzen und auf definierten Lesezeichen zurückspringen.

akFilter	Falls True, kann der Anwender Filter bearbeiten, aktivieren und deaktivieren

akDuplicate	Falls True, kann der Anwender den Feldinhalt eines Feldes oder aber den gesamten Datensatz aus dem vorherigen Datensatz übernehmen.

akCancel	Falls True, kann der Anwender Änderungen an einem Datensatz zurücknehmen.

akDelete	Falls True, kann der Anwender einen Datensatz löschen.

akInsert	Falls True, kann der Anwender einen Datensatz einfügen.

akTableView	Falls True, kann der Anwender in die Tabellenansicht der akteullen Datenquelle umschalten.

akGlobalEdit	Falls True und ManageGlobalEdit=True, kann der Anwender den formularglobalen Editiermodus ein- und ausschalten.


Eigenschaft OwnerForm

Verwendet für

TDBExtender, Komponente

Deklaration

property OwnerForm : TForm;

Beschreibung


Eigenschaft GlobalEdit

Verwendet für

TDBExtender, Komponente

Deklaration

property GlobalEdit : Boolean;

Beschreibung

Diese Eigenschaft schaltet den formularglobalen Editiermodus ein oder aus, wenn ManageGlobalEdit auf TRUE gesetzt ist.

Bei alle Datenquellen sollte die Eigenschaft AutoEdit=TRUE gesetzt sein. Der globale Editiermodus wird über ein Setzen oder Löschen der Readonly-Eigenschaften der datensensitiven Dialogelemente innerhalb des Formulers erreicht. Hierbei werden nur die Dialogelemente berücksichtigt, deren Readonly-Attribut im Entwurfsmodus nicht auf Readonly=TRUE gesetzt wurde.


Eigenschaft AktDataSource

Verwendet für

TDBExtender, Komponente

Deklaration

property AktDataSource: TDataSource;

Beschreibung


Eigenschaft AktFieldHasLU

Verwendet für

TDBExtender, Komponente

Deklaration

property AktFieldHasLU : Boolean;

Beschreibung


Eigenschaft SrchPossible

Verwendet für

TDBExtender, Komponente

Deklaration

property SrchPossible : Boolean;

Beschreibung


Eigenschaft NextSrchPossible

Verwendet für

TDBExtender, Komponente

Deklaration

property NextSrchPossible : Boolean;

Beschreibung


Eigenschaft ConfirmDelete

Verwendet für

TDBExtender, Komponente

Deklaration

property ConfirmDelete: Boolean;

Beschreibung


Eigenschaft ConfDelQuestion

Verwendet für

TDBExtender, Komponente

Deklaration

property ConfDelQuestion : String;

Beschreibung

Die Eigenschaft ConfDelQuestion legt den Meldetext fest, der erscheint, wenn der Anwender einen Datensatz löscht. Ist diese Eigenschaft nicht gesetzt, wird der Standardtext verwendet.


Eigenschaft ConfirmOverride

Verwendet für

TDBExtender, Komponente

Deklaration

property ConfirmOverride : Boolean;

Beschreibung


Eigenschaft ConfOverQuestion

Verwendet für

TDBExtender, Komponente

Deklaration

property ConfOverQuestion : String;

Beschreibung

Die Eigenschaft ConfOverQuestion legt den Meldetext fest, der erscheint, wenn der Anwender einen Feldwert dupliziert und das Duplizieren einen bestehenden Eintrag überschreiben würde. Ist diese Eigenschaft nicht gesetzt, wird der Standardtext verwendet.


Eigenschaft TVReadonly

Verwendet für

TDBExtender, Komponente

Deklaration

property TVReadonly : Boolean;

Beschreibung

Schaltet der Anwender in die Tabellenansicht, legt diese Eigenschaft den Wert der Readonly-Eigenschaft des TDBGrids innerhalb des Tabellenfensters fest. Die Vorgabe ist True.


Eigenschaft TVAutoEdit

Verwendet für

TDBExtender, Komponente

Deklaration

property TVAutoEdit : Boolean;

Beschreibung

Schaltet der Anwender in die Tabellenansicht, legt diese Eigenschaft den Wert der AutoEdit-Eigenschaft der TDataSource innerhalb des Tabellenfensters fest. Die Vorgabe ist False.


Eigenschaft HandleDBExceptions

Verwendet für

TDBExtender, Komponente

Deklaration

property HandleDBExceptions : Boolean;

Beschreibung

Ist HandleDBExceptions True, bearbeitet der TDBExtender Exceptions der angeschlossenen Datenquellen selbstständig und zeigt die von der BDE vordefinierten Fehlermeldungen im MessagePanel an.


Eigenschaft ShowStatusOptions

Verwendet für

TDBExtender, Komponente

Deklaration

property ShowStatusOptions : TDBShowStatusSet;

Beschreibung


Eigenschaft StatusPanel

Verwendet für

TDBExtender, Komponente

Deklaration

property StatusPanel : TPanel;

Beschreibung

Weisen Sie StatusPanel einen TPanel zu, um die über ShowStatusOptions festgelegten Statusinformationen der aktuellen Datenquelle anzeigen zu lassen.


Eigenschaft MessagePanel

Verwendet für

TDBExtender, Komponente

Deklaration

property MessagePanel : TPanel;

Beschreibung

Weisen Sie MessagePanel einen TPanel zu, um aktuelle Informationen der Datenquelle angezeigt zu bekommen. Hat die Eigenschaft HandleDBExceptions den Wert True, werden hier auch die Datenbankfehlermeldungen aufgeführt.


Eigenschaft MasterSource

Verwendet für

TDBExtender, Komponente

Deklaration

property MasterSource : TDataSource;

Beschreibung

Über die Eigenschaft MasterSource können Sie eine TDataSource festlegen, die für Aktionen referenziert wird, wenn im Formular der Focus auf einem nicht-datensensitivem Dialogobjekt liegt.


Eigenschaft ManageGlobalEdit

Verwendet für

TDBExtender, Komponente

Deklaration

property ManageGlobalEdit : Boolean;

Beschreibung

Die Eigenschaft MangeGlobalEdit schaltet die Steuerung für das globale Editieren ein oder aus. Falls True, kann mit der Eigenschaft GlobalEdit der Editmodus getoggelt werden. Der Anwender erreicht dies mit F9 (bzw. mit dem TDBENavigator), sofern die Eigenschaft AllowKeys den Wert akGlobalEdit enthält.


Ereignis AppOnMessage

Verwendet für

TDBExtender, Komponente

Deklaration

property AppOnMessage : TMessageEvent;

Beschreibung

Diese Eigenschaft enthält den Wert der Eigenschaft OnMessage des Objekts Application, wie sie zum Zeitpunkt der Formularaktivierung gesetzt war.

Ändern Sie nie direkt die Eigenschaft OnMessage von Application wenn ein TDBExtender im aktuellen Formular enthalten ist. Sie können die Ereignisroutine mittels AppOnMessage neu setzten.


Ereignis AppOnException

Verwendet für

TDBExtender, Komponente

Deklaration

property AppOnException : TExceptionEvent;

Beschreibung

Diese Eigenschaft enthält den Wert der Eigenschaft OnException des Objekts Application, wie sie zum Zeitpunkt der Formularaktivierung gesetzt war.

Ändern Sie nie direkt die Eigenschaft OnException von Application wenn ein TDBExtender im aktuellen Formular enthalten ist. Sie können die Ereignisroutine mittels AppOnException neu setzten.


Ereignis FormOnActivate

Verwendet für

TDBExtender, Komponente

Deklaration

property FormOnActivate: TNotifyEvent;

Beschreibung

Diese Eigenschaft enthält den Wert der Eigenschaft OnActivate des aktuellen Formulars, wie sie zum Zeitpunkt der Erzeugung von TDBExtender gesetzt war.

Ändern Sie nie direkt die Eigenschaft OnActivate von Form wenn ein TDBExtender im Formular enthalten ist. Sie können die Ereignisroutine mittels FormOnActivate neu setzten.


Ereignis FormOnDeactivate

Verwendet für

TDBExtender, Komponente

Deklaration

property FormOnDeactivate: TNotifyEvent

Beschreibung

Diese Eigenschaft enthält den Wert der Eigenschaft OnDeactivate des aktuellen Formulars, wie sie zum Zeitpunkt der Erzeugung von TDBExtender gesetzt war.

Ändern Sie nie direkt die Eigenschaft OnDeactivate von Form wenn ein TDBExtender im Formular enthalten ist. Sie können die Ereignisroutine mittels FormOnDeactivate neu setzten.


Ereignis FormOnKeyPhysical

Verwendet für

TDBExtender, Komponente

Deklaration

property FormOnKeyPhysical : TKeyPhysical;

Beschreibung

Diese Eigenschaft entspricht dem Ereignis OnKeyDown von Form, wenn KeyPreview True ist. Zu dem originalen Formularereignis bestehen zwei Unterschiede :

-	die Steuerungstasten ([Enter], Cursor, etc.) werden auch gemeldet, wenn das fokussierte Objekt diese Tasten nicht anfordert.

-	Der Tastendruck läßt sich mittels dem Var-Parameter Handled als bearbeitet kennzeichnen. In diesem Fall wird er nicht mehr dem fokussiertem Objekt gemeldet.


Ereignis FormOnFocusControl

Verwendet für

TDBExtender, Komponente

Deklaration

property FormOnFocusControl : TNotifyEvent;

Beschreibung

Das Ereignis FormOnFocusControl tritt ein, wenn ein neues Control im Formular den Focus erhält, befor es fokussiert wird. Der Parameter Sender enthält das zu fokussierende Objekt.


Ereignis FormOnException

Verwendet für

TDBExtender, Komponente

Deklaration

property FormOnException : TExceptionEvent;

Beschreibung

Mittels FormOnException erhalten Sie die Möglichkeit, direkt auf Formularebene auf Exceptions zu reagieren.


Ereignis OnActiveChanged

Verwendet für

TDBExtender, Komponente

Deklaration

property OnActiveChanged : TDSNotification;

Beschreibung


Ereignis OnDataSetChanged

Verwendet für

TDBExtender, Komponente

Deklaration

property OnDataSetChanged : TDSNotification;

Beschreibung


Ereignis OnDataSetScrolled

Verwendet für

TDBExtender, Komponente

Deklaration

property OnDataSetScrolled : TDSNotification;

Beschreibung


Ereignis OnEditingChanged

Verwendet für

TDBExtender, Komponente

Deklaration

property OnEditingChanged : TDSNotification;

Beschreibung


Ereignis OnTableView

Verwendet für

TDBExtender, Komponente

Deklaration

property OnTableView : TTVNotification;

Beschreibung

Das Ereignis OnTableView tritt ein, wenn der Anwender versucht in die Tabellenansicht zu schalten. Verwenden Sie das Ereignis OnTableView, wenn Sie das Erscheinungsbild des Tabellenfensters individuell steuern möchten, oder sonstige Vorgänge steuern müssen.


Eigenschaft VisBtnsMove

Verwendet für

TDBENavigator, Komponente

Deklaration

property VisBtnsMove : TMoveBtnSet;

Beschreibung

Über den Satz VisBtnsMove legen Sie fest, welche Speedbuttons in der Funktionsgruppe Bewegung sichtbar sind.

Mögliche Werte, die eingeschlossen werden können :

Wert	Sichtbarer Speedbutton

mnbFirst	Bewegen zum ersten Datensatz

mnbPGroup	Um eine Datensatzgruppe zum Tabellenanfang bewegen

mnbPrior	Um einen Datensatz zum Tabellenanfang bewegen

mnbNext	Um einen Datensatz zum Tabellenende bewegen

mnbNGroup	Um eine Datensatzgruppe zum Tabellenende bewegen

mnbLast	Bewegen zum letzten Datensatz


Eigenschaft VisBtnsExtend

Verwendet für

TDBENavigator, Komponente

Deklaration

property VisBtnsExtend : TExtBtnSet;

Beschreibung

Über den Satz VisBtnsRecord legen Sie fest, welche Speedbuttons in der Funktionsgruppe Record sichtbar sind.

Mögliche Werte, die eingeschlossen werden können :

Wert	Sichtbarer Speedbutton

enbDupField	Wert des Felder vom vorherigen Datensatz übernehmen

enbDupRecord	Alle Felderwerte des Records vom vorherigen Datensatz übernehmen

enbLookUp	Feldwert nachschlagen

enbGlobalEdit	Globales Editieren ein-/ausschalten


Eigenschaft GroupSpace1

Verwendet für

TDBENavigator, Komponente

Deklaration

property GroupSpace1 : Integer;;

Beschreibung

Verwenden Sie die Eigenschaft GroupSpace1, um den Abstand zwischen den Funktionsgruppen Suchen und Bewegen festzulegen.


Eigenschaft GroupSpace2

Verwendet für

TDBENavigator, Komponente

Deklaration

property GroupSpace2 : Integer;

Beschreibung

Verwenden Sie die Eigenschaft GroupSpace2, um den Abstand zwischen den Funktionsgruppen Bewegen und Record festzulegen.


Eigenschaft GroupSpace3

Verwendet für

TDBENavigator, Komponente

Deklaration

property GroupSpace3 : Integer;

Beschreibung

Verwenden Sie die Eigenschaft GroupSpace3, um den Abstand zwischen den Funktionsgruppen Record und Extend festzulegen.


Eigenschaft ButtonWidth

Verwendet für

TDBENavigator, Komponente

Deklaration

property ButtonWidth : Integer;

Beschreibung

Verwenden Sie die Eigenschaft ButtonWidth, um die Breite der einzelnen Speedbuttons festzulegen. Die Gesamtbreite der Komponente wird dementsprechend angepaßt.


TDBENavigator Methoden
Methoden

Create

Destroy

SetBounds

BtnClick

Hinweis : Methoden ohne Sprungmarke entsprechen denen des TDBNavigators.


Methode BtnClick

Verwendet für

TDBENavigator, Komponente

Deklaration

procedure BtnClick(Index: TDBENavigateBtn);

Beschreibung

Die Methode BtnClick simuliert einen Schalterklick im Navigator und ruft dadurch die Aktion des Schalters auf. Auf welchen

Schalter BtnClick wirken soll, geben Sie als Wert des Parameters Index an.


Typ TAllowKeys

Unit

DBExtend

Deklaration

TAllowKey  = (	akSelectNext, akDBMove, akLookUp, akSearch, akBookmark, akFilter,

akDuplicate, akCancel, akDelete, akInsert, akTableView,

akGlobalEdit );

TAllowKeys = set of TAllowKey;

Beschreibung

TAllowKeys ist die Menge der Werte der Eigenschaft AllowKeys, die die Komponente TDBExtender haben kann.


DBExtend Unit

Objekte

TDBExtender

TDBENavigator

Typen

TAllowKey

TAllowKeys

TDBENavigateBtn

TDBShowStatus

TDBShowStatusSet

TDSNotification

TExtNavBtn

TExtBtnSet

TKeyPhysical

TMoveNavBtn

TMoveBtnSet

TRecordNavBtn

TRecordBtnSet

TSrchNavBtn

TSrchBtnSet

TTVNotification

TFilterState

Exceptions

EDBEFilter

Konstanten

Routinen

GetDuplicateTable


Typ TDBShowStatusSet

Unit

DBExtend

Deklaration

TDBShowStatus = (ssRecNo, ssRecCount, ssTblName, ssEdit, ssInsert);

TDBShowStatusSet = set of TDBShowStatus;

Beschreibung


Typ TDBENavigateBtn

Unit

DBExtend

Deklaration

TDBENavigateBtn = (	nbSearch, nbSearchNext, nbSetBookmark, nbGotoBookmark,

nbTblFilter, nbActiveFilter, nbTableView,

nbFirst, nbPGroup, nbPrior, nbNext, nbNGroup, nbLast,

nbInsert, nbDelete, nbEdit, nbPost, nbCancel, nbRefresh,

nbDupField, nbDupRecord, nbLookUp, nbGlobalEdit);

Beschreibung


Typ LKUPType

Unit

DBiTypes

Deklaration

LKUPType = (	{ Paradox Lookup type }

lkupNONE,	{ Has no lookup }

lkupPRIVATE,	{ Just Current Field + Private }

lkupALLCORRESP,	{ All Corresponding + No Help }

lkupHELP,	{ Just Current Fld + Help and Fill }

lkupALLCORRESPHELP	{ All Corresponging + Help }

);

Beschreibung


Typ TKeyPhysical

Unit

DBExtend

Deklaration

TKeyPhysical = procedure(	Key: Word;

Shift: TShiftState;

Var Handled : Boolean) of object;

Beschreibung


Typ TDSNotification

Unit

DBExtend

Deklaration

TDSNotification = procedure( Sender : TObject; DS : TDataSource) of object;

Beschreibung


Typ TTVNotification

Unit

DBExtend

Deklaration

TTVNotification = procedure(	Sender : TObject;

Var aBorderStyle : TFormBorderStyle;

Var aFormStyle : TFormStyle;

Var isReadonly : Boolean;

Var isAutoEdit : Boolean) of object;

Beschreibung


Typ TSrchBtnSet

Unit

DBExtend

Deklaration

TSrchNavBtn = (snbSearch, snbSearchNext, snbSetBookmark, snbGotoBookmark,

snbTblFilter, snbActiveFilter, snbTableView);

TSrchBtnSet = Set of TSrchNavBtn;

Beschreibung

TSrchBtnSet ist die Menge der Werte der Eigenschaft VisBtnsSearch, die die Komponente TDBENavigator haben kann.


Typ TMoveBtnSet

Unit

DBExtend

Deklaration

TMoveNavBtn = (mnbFirst, mnbPGroup, mnbPrior, mnbNext, mnbNGroup, mnbLast);

TMoveBtnSet = set of TMoveNavBtn;

Beschreibung


Typ TRecordBtnSet

Unit

DBExtend

Deklaration

TRecordNavBtn = (rnbInsert, rnbDelete, rnbEdit, rnbPost, rnbCancel, rnbRefresh);

TRecordBtnSet = set of TRecordNavBtn;

Beschreibung


Typ TExtBtnSet

Unit

DBExtend

Deklaration

TExtNavBtn = (enbDupField, enbDupRecord, enbLookUp, enbGlobalEdit);

TExtBtnSet = set of TExtNavBtn;

Beschreibung


Ereignis ScreenOnACChange

Verwendet für

TDBExtender, Komponente

Deklaration

property ScreenOnACChange : TNotifyEvent;

Beschreibung

Diese Eigenschaft enthält den Wert der Eigenschaft OnActiveControlChange des Objekts Screen, wie sie zum Zeitpunkt der Formularaktivierung gesetzt war.

Ändern Sie nie direkt die Eigenschaft OnActiveControlChange von Screen wenn ein TDBExtender im aktuellen Formular enthalten ist. Sie können die Ereignisroutine mittels ScreenOnACChange neu setzten.


Funktion GetDuplicateTable

Unit

DBExtend

Deklaration

function GetDuplicateTable(AOwner : TComponent; STbl : TTable) : TTable;

Beschreibung


Tastaturbelegung TDBExtender

Mittels den aufgeführten Tastencodes steuert der Anwender die erweiterten Datenquellenfunktionen. Eine Funktion ist verfügbar, wenn : 	- das fokussierte Dialogobjekt ein datensensitives ist oder
- die Eigenschaft MasterSource gesetzt ist,
- die Eigenschaft AllowKeys die Aktion zuläßt.

Taste	Aktion

[Enter]	Selektiert das nächste Dialogobjekt (entspricht der [TAB]-Taste)

[Alt]oder[Ctrl]-[Enter]	Selektiert das vorherige Dialogobjekt (entspricht der [Shift]-[TAB]-Taste)

[Ctrl]-S	Dialogfenster zur Feldwertsuche öffnen

F3	Nächsten Feldwert suchen

[Ctrl]-F3	Nächsten Feldwert in entgegengesetzter Richtung suchen

[Ctrl]-K-n	Lesezeichen auf aktuellen Datensatz setzen (n:1-9)

[Ctrl]-Q-n	Bewegen zum Lesezeichen n (n:1-9)

[Ctrl]-Q-0	Öffnen der Lesezeichenverwaltung (Dialogfenster mit Anzeiger def. Lesezeichen)

[Ctrl]-F	Dialogfenster zur Filterbearbeitung öffnen

F7	In Tabellenansicht umschalten

[Ctrl]-F7	In Tabellenansicht umschalten (Tabelle des Grid und das Formular sind synchronisiert)

[Ctrl]-PageUp	Bewegen zum Tabellenanfang

[Shift]-PageUp	Bewegen um eine Datensatzgruppe Richtung Tabellenanfang

PageUp	Bewegen um einen Datensatz Richtung Tabellenanfang

PageDown	Bewegen um einen Datensatz Richtung Tabellenende

[Shift]-PageDown	Bewegen um eine Datensatzgruppe Richtung Tabellenende

[Ctrl]-PageDown	Bewegen zum Tabellenende

[Ins]	Datensatz einfügen

[Ctrl]-[Del]	Datensatz löschen

[Ctrl]-Back	Änderungen am Datensatz zurücknehmen

[Ctrl]-D	Feldwert duplizieren (Übernahme aus vorherigem Datensatz)

[Ctrl]-[Shift]-D	Datensatz duplizieren (Übernahme des gesamten vorherigen Datensatzes)

[Ctrl]-[Space]	Feldwert nachschlagen (Nachschlagedialogfenster wird geöffnet)

F9	Globalen Editiermodus ein-/ausschalten


Speedbuttons TDBENavigator

Mittels den aufgeführten Speedbuttons steuert der Anwender die erweiterten Datenquellenfunktionen. Ob ein Speedbutton aktiviert ist, wird vom angeschlossenen TDBExtender gesteuert.

Button	Aktion

Dialogfenster zur Feldwertsuche öffnen

Nächsten Feldwert suchen

-[Ctrl]	Nächsten Feldwert in entgegengesetzter Richtung suchen

Lesezeichen auf aktuellen Datensatz setzen

Öffnen der Lesezeichenverwaltung (Dialogfenster mit Anzeiger def. Lesezeichen)

Dialogfenster zur Filterbearbeitung öffnen

Filter aktivieren / deaktivieren

In Tabellenansicht umschalten

-[Ctrl]	In Tabellenansicht umschalten (Tabelle des Grid und das Formular sind synchronisiert)

Bewegen zum Tabellenanfang

Bewegen um eine Datensatzgruppe Richtung Tabellenanfang

Bewegen um einen Datensatz Richtung Tabellenanfang

Bewegen um einen Datensatz Richtung Tabellenende

Bewegen um eine Datensatzgruppe Richtung Tabellenende

Bewegen zum Tabellenende

Datensatz einfügen

Datensatz löschen

Änderungen am Datensatz zurücknehmen

Datenbank aktualisieren

Feldwert duplizieren (Übernahme aus vorherigem Datensatz)

Datensatz duplizieren (Übernahme des gesamten vorherigen Datensatzes)

Feldwert nachschlagen (Nachschlagedialogfenster wird geöffnet)

Globalen Editiermodus ein-/ausschalten


Tabellenansicht

In der Tabellenansicht werden die Datensätze des durch das aktuelle Dialogobjekt referenzierte DataSet in einem TDBGrid innerhalb eines eigenen Fensters dargestellt.

Es gibt zwei Arten von Tabellensichten : die normale und die synchronisierte. Bei der normalen Tabellensicht bezieht sich das TDBGrid des Tabellenfensters auf einen eigenen TTable, der an der gleichen Position aufsetzt wie der des Dialogobjektes. Bei der synchronisierten verwendet das TDBGrid den gleichen TTable des Dialogobjektes, was dazu führt, das Bewegungen innerhalb des Tabellenfensters direkt zu Bewegungen innerhalb des Formulares des Dialogobjektes führen.


Type TFilterState

Unit

DBExtend

Deklaration

TFilterState = (ftsNA, ftsDropped, ftsAdded, ftsActive);

Beschreibung

TFilterState stellt die Werte, die die Eigenschaft AktFilterState, der Komponente TDBExtender annehmen kann.


Eigenschaft AktFilterState

Verwendet für

TDBExtender, Komponente

Deklaration

property AktFilterState : TFilterState;

Beschreibung

Nur zur Laufzeit und nur Lesen. AktFilterState zeigt den Filterstatus der aktuellen DataSource an.


Eigenschaft TblViewPossible

Verwendet für

TDBExtender, Komponente

Deklaration

property TblViewPossible : Boolean;

Beschreibung


Eigenschaft HorizOrientation

Verwendet für

TDBENavigator, Komponente

Deklaration

property HorizOrientation : Boolean;

Beschreibung

Verwenden Sie die Eigenschaft HorizOrientation, um die Ausrichtung des Navigators festzulegen. Ist HorizOrientation TRUE erscheint der Navigator horizontal, bei FALSE vertikal.


Eigenschaft ButtonHeight

Verwendet für

TDBENavigator, Komponente

Deklaration

property ButtonHeight : Integer;

Beschreibung

Verwenden Sie die Eigenschaft ButtonHeight, um die Höhe der einzelnen Speedbuttons festzulegen. Die Gesamthöhe der Komponente wird dementsprechend angepaßt.


Dialogfenster Wertsuche

Dieses Dialogfenster erscheint, wenn der Anwender den Speedbutton zur Feldwertsuche [image] anklickt oder [Ctrl]-S drückt.

Klicken Sie auf die einzelnen Bereiche des Fensters, um nähere Informationen zu erhalten.


Dialogfenster Lesezeichen

Dieses Dialogfenster erscheint, wenn der Anwender den Speedbutton zur Lesezeichenverwaltung [image] anklickt oder [Ctrl]-Q 0 drückt.

Klicken Sie auf die einzelnen Bereiche des Fensters, um nähere Informationen zu erhalten.


Dialogfenster Filterdefinition

Dieses Dialogfenster erscheint, wenn der Anwender den Speedbutton zur Filterbearbeitung [image] anklickt oder [Ctrl]-F drückt.

Klicken Sie auf die einzelnen Bereiche des Fensters, um nähere Informationen zu erhalten.


Dialogfenster Tabellenansicht

Dieses Fenster erscheint, wenn der Anwender den Speedbutton zur Tabellenansicht [image] anklickt oder F7 drückt.

Das Erscheinungsbild des Fensters ist vom Ausgangsformular abhängig. Ist das Ausgangsformular vom Typ MDIChild, wird die Tabellenansicht in Form eines eigenen MDIChilds dargestellt. Hierdurch ist es möglich, mehrere Tabellenansichten zu verschiedenen Tabellen geöffnet zu halten, das ein Umschtalten zum Ausgangsformular möglich ist.


Dialogfenster Nachschlagen

Dieses Fenster erscheint, wenn der Anwender sich innerhalb eines Feldes befindet, auf das im Tabellendesign Nachschlagen definiert wurde und der Speedbutton zum Nachschlagen [image] anklickt oder [Ctrl]-[Space] gedrückt wird.

Der Aktionsschalter OK übernimmt die Auswahl in das aktuelle Feld (bzw. in alle entsprechenden Felder).


Eingabefeld Wert
Geben Sie hier den Wert ein, nach dem gesucht werden soll.

Als Wildcard wird '..' unterstüzt, welches nach beliebig vielen belibigen Zeichen sucht.

Da alle Feldtypen über Stringvergleiche auf Treffer untersucht werden, können Sie auch bei numerischen- oder Datumsfeldern mit Teilstringvergleichen arbeiten.

Bei Memofelder werden die ersten 64.000 Zeichen des Memofeldes berücksichtig.

Bsp.: Die Eingabe '..ext..' findet : 'Extrakt', 'DBExtender', 'Text', etc.


Option Groß-/Kleinschreibung
Die Option Groß-/Kleinschreibung beachten legt fest, ob bei der Suche die Groß-/ Kleinschreibung berücksichtigt werden soll.


Option Suche Richtung Tabellenende
Die Option Suche Richtung Tabellenende bestimmt die Richtung, in der gesucht wird. Ist diese Option markiert, findet die Suche das erste Vorkommen des Wertes innerhalb der Tabelle, ansonsten den letzten.


Auswahlfeld Felder
Mittels dem Auswahlfeld Felder legen Sie das Feld fest, auf dem gesucht werden soll.


Auswahlliste Verfügbare Lesezeichen
Die Auswahlliste Verfügbare Lesezeichen enthält alle definierten Lesezeichen der aktuellen Tabelle.

Jede Zeile zeigt die Nummer des Lesezeichens und die Indexfelder des markierten Datensatzes.


Aktionsschalter OK
Der Aktionsschalter OK bewirkt die Neupositionierung der Tabelle auf das ausgewählte Lesezeichen. Kann die Positionierung nicht durchgeführt werden, wird eine Exception ausgelöst.


Auswahlfeld Verknüpfung
Mittels dem Auswahlfeld Verknüpfung legen Sie die logische Verknüpfung zwischen zwei Filterzeilen fest.


Auswahlfeld Feld
Wählen Sie im Auswahlfeld Feld das Tabellenfeld aus, auf das ein Filterausdruck gelegt werden soll.


Auswahlfeld Operator
Mittels dem Auswahlfeld Operator bestimmen Sie die Filterbedingung für das ausgewählte Feld. Mögliche Werte sind : 'Leer', 'Nicht leer', 'Gleich', 'Ungleich', 'Größer als', 'Größer gleich', 'Kleiner als' und 'Kleiner gleich'.


Auswahlfeld Operant
Im Auswahlfeld Operant tragen Sie den Filterstring ein, der mittels des Operators mit dem Tabellenfeld verknüpft wird.

Bei Filterverglichen wird immer der originale Feldtyp herangezogen (im Gegensatz zur Wertsuche). Daher müssen Sie einen gültigen Feldwert eintragen.

Haben Sie den Operator 'Gleich' ausgewählt, können Sie auch eine Teilstringfilterung durchführen (nur für Stringfelder). Verwenden Sie hierfür das Wildcard '..' (Bsp.: [Name] [Gleich] [Schmi..] filtert alle Schreibweisen des Names Schmidt.) Das Wildcard kann nur am Ende des Strings angehängt werden, eine Vorranstellung ist nicht möglich.


Aktionsschalter Löschen
Der Aktionsschalter Löschen leert die Filterdefinitionszeile.


Aktionschalter OK
Der Aktionschalter OK des Dialogfensters Filterdefinition setzt und aktiviert den eingegeben Filterausdruck.