Zweck
Zeichnet einen Datenwert.
Klasse
Typ
Methode
Syntax
<oBrowser>:DrawValue(
<hDC>,
<symValueView>,
<uValue>,
<srcArea>,
<oGrid>,
<oFont>,
<iAlignment>,
<iValueOptions>,
<oForeground>,
<oBackground>,
<iAlphaBlendRatio>,
<lSelected>,
<lDeleted>,
<lEnabled>,
<lCurrent>
) Æ lDraw
Argumente
<hDC> | DeviceContext, in dem der Datenwert gezeichnet werden muss. |
Datentyp: | Ptr |
<symValueView> | Darstellungsart, in welcher der Wert gezeichnet werden soll. Es werden folgende Darstellungsarten unterstützt: |
Darstellungsart |
Beschreibung |
#Abstract |
Für das Zeichnen des Wertes wird im Owner des bBrowser die Callback-Methode DrawValue() aufgerufen. Der Callback-Methode wird als Argument ein bDrawValueEvent übergeben. |
#Bitmap |
Der Wert wird als Bitmap dargestellt.
Das Argument <uValue> muss ein Objekt der Klasse Bitmap enthalten. |
#Check |
Der Wert wird als Checkbox ohne Rahmen dargestellt.
Wenn das Argument <uValue> den Wert TRUE oder 1 enthält, wird ein Häckchen dargestellt.
Wenn das Argument <uValue> den Wert FALSE oder 0 enthält, wird kein Häckchen dargestellt.
Wenn das Argument <uValue> den Wert 2 enthält, wird ein Häckchen auf grauen Hintergrund dargestellt. |
#CheckBox |
Der Wert wird als Checkbox dargestellt.
Wenn das Argument <uValue> den Wert TRUE oder 1 enthält, wird die Checkbox mit einem Häckchen dargestellt.
Wenn das Argument <uValue> den Wert FALSE oder 0 enthält, wird die Checkbox ohne einem Häckchen dargestellt.
Wenn das Argument <uValue> den Wert 2 enthält, wird die Checkbox mit einem Häckchen auf grauen Hintergrund dargestellt. |
#ComboBox |
Der Wert wird als ComboBox dargestellt. |
#ComboEdit |
Der Wert wird als bComboEdit dargestellt. |
#CompoundValue |
Der Wert wird als bCompoundValue dargestellt.
Das Argument <uValue> muss ein Objekt der Klasse bCompoundValue enthalten. |
#Icon |
Der Wert wird als Icon dargestellt.
Das Argument <uValue> muss ein Objekt der Klasse Icon enthalten. |
#PushButton |
Der Wert wird als PushButton dargestellt. |
#RTF |
Der Wert wird als RTF-Text dargestellt. |
#Text |
Der Wert wird als ein- oder mehrzeiliger Text dargestellt. |
Bei der Übergabe von NULL_SYMBOL, wird die Darstellungsart abhängig von dem Datentyp des Arguments <uValue> ermittelt.
Datentyp: | Symbol |
<uValue> | Wert, der gezeichnet werden soll. |
Datentyp: | Usual |
<srcArea> | Rechteck-Struktur, die den Bereich definiert, in dem der Wert gezeichnet werden soll. |
Das Argument muss per Referenz übergeben werden.
Datentyp: | _winRect |
<oGrid> | Grid, das sich um den Wert befindet. Das Grid wird nicht selbst gezeichnet, sondern dient nur der Auswertung. |
Datentyp: | bGrid |
<oFont> | Schriftart, in welcher der Wert bei der Darstellungsart #Text gezeichnet werden soll. |
Datentyp: | Font |
<iAlignment> | Ausrichtung, mit welcher der Wert in dem definierten Bereich gezeichnet werden soll. |
Konstante |
Beschreibung |
BALIGN_AUTO |
Die Voreinstellungen für die horizontale und vertikale Ausrichtung werden verwendet. |
BALIGN_LEFT |
Linksbündige Ausrichtung |
BALIGN_RIGHT |
Rechtsbündige Ausrichtung |
BALIGN_CENTER |
Zentrierte horizontale Ausrichtung |
BALIGN_TOP |
Ausrichtung oben |
BALIGN_BOTTOM |
Ausrichtung unten |
BALIGN_VCENTER |
Zentrierte vertikale Ausrichtung |
Datentyp: | Int |
<iValueOptions> | Bitmaske, in der angegeben wird, wie der Wert angezeigt werden soll. Die folgende Tabelle listet die möglichen Werte auf: |
Option |
Beschreibung |
BVO_AUTO |
Es sind keine spezifischen Optionen definiert. |
BVO_ASPECRATIO |
In Kombination mit der Option BVO_STRETCHIMAGE wird beim Vergrößern bzw. Verkleinern einer Bitmap die Seitenverhältnisse der Bitmap beibehalten. Dies kann dazu führen, dass die Bitmap nicht an den gesamten Zeichenbereich angepasst wird. |
BVO_END_ELLIPSIS |
Wenn der Wert nicht vollständig dargestellt werden kann, dann wird der Wert am Ende abgeschnitten und 3 Punkte (...) werden angehängt.
Die Option kann nicht mit den folgenden Optionen kombiniert werden: •BVO_RTF |
BVO_LINEBREAK |
Wenn der Wert Zeilenumbrüche (CRLF) enthält, dann wird der Wert an diesen Stellen umgebrochen.
Die Option kann nicht mit den folgenden Optionen kombiniert werden: •BVO_RTF |
BVO_RTF |
Der Wert wird als RTF-Text dargestellt.
Die Option kann nicht mit den folgenden Optionen kombiniert werden: •BVO_END_ELLIPSIS •BVO_LINEBREAK |
BVO_STRETCHIMAGE |
Wenn der Wert eine Bitmap ist, dann wird dessen Größe an die Größe des Zeichenbereiches angepasst. |
BVO_WORDBREAK |
Wenn der Wert nicht vollständig in einer Zeile dargestellt werden kann, dann wird der Wert an Wortgrenzen umgebrochen. |
Datentyp: | DWord |
<oForeground> | Vordergrundfarbe, in welcher der Wert gezeichnet werden soll. |
Datentyp: | Color |
<oBackground> | Hintergrundfarbe des Bereichs, in den der Wert gezeichnet werden soll. |
Datentyp: | Brush |
<iAlphaBlendRatio> | Überblendfaktor, mit dem zwei Farben sich überlappen. Je höher der Wert ist, desto geringer ist die Transparenz und desto weniger scheint die eine Farbe durch die andere hindurch. Erlaubte Werte sind 0 bis 100 bzw. die folgenden Konstanten: |
Konstante |
Wert |
BABR_NONE |
0 |
BABR_LIGHT |
12 |
BABR_NORMAL |
25 |
BABR_DARK |
45 |
BABR_SOLID |
100 |
BABR_AUTO |
0xFFFFFFFF |
Das Argument wird erst ab Windows 2000 unterstützt. Für ältere Betriebssysteme sollte der Wert BABR_NONE übergeben werden.
Datentyp: | DWord |
<lSelected> | Logischer Wert der definiert, ob der Wert im selektierten Zustand gezeichnet werden soll. In diesem Fall wird das Argument <oForeground> nicht berücksichtigt. |
Datentyp: | Logic |
<lDeleted> | Logischer Wert der definiert, ob der Wert im gelöschten Zustand gezeichnet werden soll. In diesem Fall wird das Argument <oForeground> nicht berücksichtigt. |
Datentyp: | Logic |
<lEnabled> | Logischer Wert der definiert, ob der Wert im aktivierten oder deaktivierten Zustand gezeichnet werden soll. Im deaktivierten Zustand, wird das Argument <oForeground> nicht berücksichtigt. |
Datentyp: | Logic |
<lCurrent> | Logischer Wert der definiert, ob sich der Wert unter dem Cursor befindet. |
Datentyp: | Logic |
Rückgabewert
lDraw | Logischer Wert der definiert, ob der Datenwert gezeichnet wurde. |
TRUE | Der Datenwert wurde gezeichnet. |
FALSE | Der Datenwert wurde nicht gezeichnet. |
Datentyp: | Logic |
Beschreibung
bBrowser:DrawValue() zeichnet einen einzelnen Datenwert. Der Hintergrund des Datenwertes muss bereits gezeichnet worden sein. Der Datenwert kann sowohl im selektierten als auch im gelöschten Zustand gezeichnet werden.
Page url: http://www.YOURSERVER.com/index.html?bbrowser_drawvalue.htm