Zweck
Definiert einen Datenbrowser auf einen oder mehrere Datenserver.
Klasse
bBrowser
Zugriffe
AlphaBlendRatio | (Access / Assign) |
AutoAppend | (Access / Assign) |
AutoCaptionHeight | (Access / Assign) |
AutoClose | (Access / Assign) |
AutoEdit | (Access / Assign) |
AutoFooterHeight | (Access / Assign) |
AutoRefreshTime | (Access / Assign) |
AutoSkip | (Access / Assign) |
AutoTitleHeight | (Access / Assign) |
AutoWidthColumn | (Access / Assign) |
CaptionArea | (Access) |
CaptionHeight | (Access / Assign) |
CaptionView | (Access / Assign) |
Collection | (Access / Assign) |
ColorCondition | (Access) |
ColumnCount | (Access) |
ColumnList | (Access) |
ColumnOpenCount | (Access) |
ColumnOpenList | (Access) |
ColumnVariableHeightCount | (Access) |
ColumnVariableHeightList | (Access) |
ContextMenuMode | (Access / Assign) |
CurrentBackground | (Access / Assign) |
CurrentColumn | (Access) |
CurrentMode | (Access / Assign) |
CurrentForeground | (Access / Assign) |
CurrentRecNo | (Access) |
CurrentRow | (Access) |
CurrentRowBackground | (Access / Assign) |
CurrentRowForeground | (Access / Assign) |
DataArea | (Access) |
DataFont | (Access / Assign) |
DataView | (Access / Assign) |
DeletedForeground | (Access / Assign) |
DisabledBackground | (Access / Assign) |
DisabledForeground | (Access / Assign) |
DragDropMode | (Access / Assign) |
DynamicDataArea | (Access) |
Editable | (Access / Assign) |
EditCell | (Access) |
EditCloseFlags | (Access / Assign) |
EditCondition | (Access) |
EditControl | (Access) |
EditStartFlags | (Access / Assign) |
FieldChangeMode | (Access / Assign) |
FirstRecNo | (Access) |
FirstVisibleColumn | (Access) |
FirstVisibleColumnOffset | (Access) |
FirstVisibleRecNo | (Access / Assign) |
FirstVisibleRowNo | (Access) |
FocusView | (Access / Assign) |
Font | (Access / Assign) |
FontCondition | (Access) |
FooterArea | (Access) |
FooterHeight | (Access / Assign) |
FooterView | (Access / Assign) |
Freeze | (Access / Assign |
Grid | (Access / Assign) |
GridInEmptyArea | (Access / Assign) |
HorizontalScrollbarMode | (Access / Assign) |
InactiveSelectedBackground | (Access / Assign) |
InactiveSelectedForeground | (Access / Assign) |
InfoView | (Access / Assign) |
KeyCommand | (Access) |
LastRecNo | (Access) |
LastVisibleColumn | (Access) |
LastVisibleRecNo | (Access) |
LastVisibleRowNo | (Access) |
ProcessState | (Access) |
RowCountMode | (Access / Assign) |
RowHeight | (Access / Assign) |
RowHeightMax | (Access / Assign) |
RowMode | (Access / Assign) |
SelectedBackground | (Access / Assign) |
SelectionCellCount | (Access) |
SelectedForeground | (Access / Assign) |
SelectionMode | (Access / Assign) |
SelectionRowCount | (Access) |
SelectorArea | (Access) |
SelectorColorCondition | (Access) |
SelectorView | (Access / Assign) |
SelectorWidth | (Access / Assign) |
Server | (Access) |
ServerType | (Access / Assign) |
TabKeyMode | (Access / Assign) |
Title | (Access / Assign) |
TitleArea | (Access / Assign) |
TitleHeight | (Access / Assign) |
TitleView | (Access / Assign) |
ToolTipMode | (Access / Assign) |
Used | (Access) |
VerticalScrollbarMode | (Access / Assign) |
ViewLogicAs | (Access / Assign) |
VisibleColumnCount | (Access) |
VisibleRecCount | (Access) |
VisibleRowCount | (Access) |
Wallpaper | (Access / Assign) |
WallpaperView | (Access / Assign) |
WordBreakInMemo | (Access / Assign) |
Methoden
Interne Methoden
IsHorizontalScrollbarVisible()
UpdateHorizontalScrollValues()
Callback Methoden
Erbt von
CustomControl
Vererbt an
<kein Nachfahre>
Beschreibung
Ein Datenbrowser ist eine Tabelle bestehend aus einer oder mehreren Spalten. Die einzelnen Spaltenwerte werden über Ausdrücke oder Felder in Datenservern ermittelt.
Innerhalb der Spalten und Zeilen kann sowohl mit der Tastatur als auch mit der Maus in den Daten navigiert werden.
Taste |
Beschreibung |
KeyHome |
Springt zur ersten Datenspalte. |
KeyEnd |
Springt zur letzten Datenspalte. |
KeyArrowLeft |
Springt zur vorherigen Datenspalte. |
KeyArrowRight |
Springt zur nächsten Datenspalte. |
KeyArrowUp |
Springt zum vorherigen Datensatz. |
KeyArrowDown |
Springt zum nächsten Datensatz. |
KeyPageUp |
Springt zur vorherigen Seite. |
KeyPageDown |
Springt zur nächsten Seite. |
Strg + KeyPageUp |
Springt zum ersten Datensatz. |
Strg + KeyPageDown |
Springt zum letzten Datensatz. |
KeyReturn |
Aktiviert die Eingabe in der aktuellen Datenzelle, falls dies erlaubt ist. |
Tab |
Gibt den Fokus an das nächte Control im Fenster ab. |
Shift + Tab |
Gibt den Fokus an das vorherige Control im Fenster ab. |
KeyF5 |
Aktualisiert die angezeigten Daten. |
Der bBrowser kann mit Datenservern der Klasse DBServer verknüpft werden, oder mit jedem anderen Server (z.B. ArrayServer) der die folgenden Methoden, Access und Assign mit den selben Aufrufkonventionen und Verhalten implementiert hat wie die Klasse DBServer.
Methoden |
Access |
Assign |
FieldGet() |
BoF |
RecNo |
FieldHyperLabel() |
DBStruct |
|
FieldInfo() |
Deleted |
|
FieldPos() |
EoF |
|
FieldPut() |
LastRec |
|
FieldSpec() |
OrderKeyNo [optional 1] |
|
FieldSym() |
ReadOnly |
|
GoBottom() |
RecCount |
|
GoTo() |
RecNo |
|
GoTop() |
Used |
|
IndexKey() [optional 1] |
||
IndexOrd() [optional 1] |
||
Notify() |
||
OrderInfo() [optional 1] |
||
OrderKeyCount() [optional 1] |
||
RegisterClient() |
||
ResetNotification() |
||
Skip() |
||
SuspendNotification() |
||
UnregisterClient() |
[1] Die Methoden und Zugriffe gehören zu einer Gruppe und sind
optional. Sobald aber eine dieser Methoden und Zugriffe implementiert
ist, müssen alle anderen auch implementiert sein.
Der bBrowser unterstützt die Visual Styles von MS-Windows. Voraussetzung ist, dass in der Applikation die Visual Styles eingeschaltet sind und diese vom Betriebssystem unterstützt werden. Die Visual Styles werden erst ab Windows XP unterstütz.
Die Visual Styles werden vom bBrowser in den folgenden Bereichen unterstützt:
Die Bereiche, in denen die Visual Styles unterstützt werden.
In allen diesen Bereichen muss ein Grid mit dem Stil BGRID_AUTO definiert sein. Diese werden beim Erzeugen eines bBrowser-Objektes automatisch definiert. Die folgende Tabelle listet die Zugriffe auf, mit denen auf das Grid der Bereiche zugegriffen werden kann:
Bereich |
Zugriff |
Titel |
bBrowser:TitleView:Grid |
Spaltenbezeichnung |
bBrowser:CaptionView:Grid |
Spaltenfuß |
bBrowser:FooterView:Grid |
Selektorspalte |
|
Grid im Datenbereich |
bBrowser:DataView:Grid |
Falls das Betriebssystem oder die Applikation die Visual Styles nicht unterstützt, werden die Bereiche, in denen der Grid-Stil BGRID_AUTO definiert ist, mit einem alternativen Grid dargestellt. Die folgende Tabelle listet die alternativen Grid-Stile auf:
Bereich |
Alternativer Grid-Stil |
Titel |
BGRID_CONVEX |
Spaltenbezeichnung |
BGRID_CONVEX |
Spaltenfuß |
BGRID_CONVEX |
Selektorspalte |
BGRID_CONVEX |
Grid im Datenbereich |
BGRID_OUTLINE |
Mit der Methode bBrowser:EnableThemePart() kann für einen einzelnen Bereich die Unterstützung der Visual Styles ein- bzw. ausgeschaltet werden. Beim Erzeugen eines bBrowser-Objekts werden die Visual Styles für alle Bereiche eingeschaltet, sofern die Visual Styles von der Applikation und dem Betriebssystem unterstützt werden. Andernfalls werden die Visual Styles für alle Bereiche ausgeschaltet.
Falls die neue Darstellung des bBrowser nicht erwünscht ist, dann kann mit dem folgenden Codefragment die alte Darstellung vom bBrowser 2 wieder eingestellt werden:
oBrowser:EnableThemePart(BVSTP_TITLE, FALSE)
oBrowser:EnableThemePart(BVSTP_INFO, FALSE)
oBrowser:EnableThemePart(BVSTP_SELECTOR, FALSE)
oBrowser:EnableThemePart(BVSTP_CAPTION, FALSE)
oBrowser:EnableThemePart(BVSTP_FOOTER, FALSE)
oBrowser:EnableThemePart(BVSTP_GRID, FALSE)
Das Codefragment muss nach dem Erzeugen des bBrowser Controls eingebunden werden. Zusätzlich muss noch der Überblendfaktor für Farben (AlphaBlendRatio) eingestellt werden. Siehe hierzu den nächsten Abschnitt.
bBrowser und Farbüberblendung (AlphaBlendRatio)
Der bBrowser unterstützt das Überblenden von Farben. Beim Überblenden von zwei Farben scheint die untere Farbe durch die obere Farbe hindurch. Die obere Farbe ist somit transparent. Je größer der Überblendfaktor ist, desto geringer ist die Transparenz und desto weniger scheint die untere Farbe durch die obere Farbe hindurch. Je kleiner der Überblendfaktor ist, desto größer ist die Transparenz und desto mehr scheint die untere Farbe durch die obere Farbe hindurch. Der Überblendfaktor kann mit dem Zugriff bBrowser:AlphaBlendRatio definiert werden. Der bBrowser unterstützt die Farbüberblendung bei der Darstellung der folgenden Bereiche:
• | Titel |
• | Spaltenbezeichnung |
• | Spaltendaten |
• | Spaltenfuß |
• | Selektorspalte |
• | Infowerte |
Zusätzlich zur Einstellung in bBrowser:AlphaBlendRatio kann für jeden der Bereiche im zugehörigen bViewStyle-Objekt ein eigener Überblendfaktor definiert werden. Hierzu muss dem Zugriff bViewStyle:AlphaBlendRatio der entsprechende Wert zugewiesen werden. Die folgende Tabelle listet die Zugriffe auf, um auf die bViewStyle-Objekte der entsprechenden Bereiche zugreifen zu können:
Bereich |
Zugriff |
Titel |
|
Spaltenbezeichnung |
|
Spaltendaten |
|
Spaltenfuß |
|
Selektorspalte |
|
Info-Werte |
Um die Farbüberblendung auszuschalten, muss dem Zugriff bBrowser:AlphaBlendRatio der Wert BABR_NONE zugewiesen werden. Als Vorgabe ist der Wert BABR_NORMAL definiert. Um die Farbüberblendung nur für einen Bereich im bBrowser auszuschalten, muss der Wert BABR_NONE in dem Zugriff bViewStyle:AlphaBlendRatio des entsprechenden Bereichs gesetzt werden. Für die einzelnen Bereiche im bBrowser sind die folgenden Werte als Vorgabe definiert:
Bereich |
Access |
Titel |
BABR_AUTO |
Spaltenbezeichnung |
BABR_AUTO |
Spaltendaten |
BABR_AUTO |
Spaltenfuß |
BABR_AUTO |
Selektorspalte |
BABR_AUTO |
Info-Werte |
BABR_AUTO |
Bei der Darstellung von Farbbedingungen wird der Überblendfaktor aus dem Zugriff bBrowser:DataView verwendet. Um Farbbedingungen ohne Farbüberblendung darzustellen muss dem Zugriff der Wert BABR_NONE zugewiesen werden.
Wichtiger Hinweis!
Die Farbüberblendung wird nur für Windows 2000 oder neueren Betriebssystemen unterstützt.
OwnerDrawValues
Der bBrowser bietet die Möglichkeit, Werte vom Datentyp Object als Spaltenwerte darzustellen. Da der bBrowser diese aber nicht selber zeichnen kann, überprüft er, ob in seinem Owner eine Methode DrawValue() definiert ist. Wenn ja, dann ruft der bBrowser diese zum Zeichnen des Objekts auf. Der Methode wird als Argument ein Event der Klasse bDrawValueEvent übergeben.
OwnerDrawValues
Der bBrowser bietet die Möglichkeit, Werte vom Datentyp Object als Spaltenwerte darzustellen. Da der bBrowser diese aber nicht selber zeichnen kann, überprüft er, ob in seinem Owner eine Methode DrawValue() definiert ist. Wenn ja, dann ruft der bBrowser diese zum Zeichnen des Objekts auf. Der Methode wird als Argument ein Event der Klasse bDrawValueEvent übergeben.
Siehe auch bSample - OwnerDrawValues
Zusammengesetzte Werte: bCompoundValue
Der bBrowser unterstützt als Spaltenwerte auch Zusammengesetzte Werte der Klasse bCompoundValue. Diese Werte können aus beliebig vielen Einzelwerten bestehen.
Siehe auch bSample - bCompoundValues