DBnewDisplayVector

Dieser Aufruf erzeugt einen neuen Vektor in der Datenbank, der immer angezeigt wird.

Dieser Vektor ist in einem eigenen Objekt in einem Stringelement untergebracht, das aus zwei Punkten besteht.

Normalerweise werden Elemente der Datenbank genau dann angezeigt, wenn die Objekte, zu denen sie gehören, selektiert sind. Eine Ausnahme bilden die Objekte und damit Elemente, die in dem Segment mit der ID 65535 angelegt sind (wenn dieses Segment existiert). Alle diese Objekte werden immer angezeigt. Ansonsten lässt sich mit diesem Segment normal arbeiten. Objekte aus diesem Segment lassen sich nur nicht selektieren. Mit der Prozedur DBnewDisplayVector wird nun dieses Segment 65535 angelegt, falls es noch nicht existiert. Dann wird ein Objekt in diesem Segment erzeugt und in diesem Objekt ein Stringelement erzeugt. Dieses Element erhält dann die beiden Punkte des Vektors zugefügt. Wenn dies alles fehlerfrei abgelaufen ist, wird als Ergebnis der String geliefert. Im Falle eines Fehlers wird der Wert NULL geliefert.

Parameter

root (PROOT)                                             [IN]

Das Handle der Datenbank

x1 (double)                                                  [IN]

x-Koordinate des Anfangspunktes der neu einzuzeichnenden Strecke.

y1 (double)                                                  [IN]

y-Koordinate des Anfangspunktes der neu einzuzeichnenden Strecke.

x2 (double)                                                  [IN]

x-Koordinate des Endpunktes der neu einzuzeichnenden Strecke.

y2 (double)                                                  [IN]

y-Koordinate des Endpunktes der neu einzuzeichnenden Strecke.

typeOfInfo (int)                                            [IN]

FD_USE_PEN oder FD_USE_COLOR

Im ersten Fall wird der nächste Parameter als Stiftnummer für eine der 16 Gradisfarben angenommen, im zweiten Fall ist er ein RGB-Wert mit Blau im niederwertigen Byte. Der Farbwert steht dann in der Variablen colorVal.

colorVal (unsigned long int)                        [IN]

siehe Variable typeOfInfo

breite (int)                                                    [IN]

Breite der Linie in 1/100 mm. Der Wert 0 führt zu einer Linie mit minimaler Breite.

lineType (int)                                                [IN]

Typ der Linie. Es sind verschiedene Typen, etwa durchgezogen, gestrichelt, etc definiert. Die Konstanten sind entsprechend:

DRAW_LINETYPE_DEFAULT                      0

DRAW_LINETYPE_DOT                            1

DRAW_LINETYPE_SHORTDASH                  2

DRAW_LINETYPE_DASHDOT                     3

DRAW_LINETYPE_DOUBLEDOT                  4

DRAW_LINETYPE_LONGDASH                    5

DRAW_LINETYPE_DASHDOUBLEDOT           6

DRAW_LINETYPE_SOLID                          7

Ergebnis

(PSTRING_ELMENT)                            [OUT]

Wenn die Prozedur fehlerfrei bearbeitet wurde, liefert sie das Handle auf den String. Sonst liefert sie den Wert NULL.

Deklaration

#include "database.h"

PSTRING_ELEMENT DLLENTRY   DBnewDisplayVector(

     PROOT             root,

     double               x1,

     double               y1,

     double               x2,

     double               y2,

     int                  typeOfInfo,

     unsigned long int    colorVal,

     int                  breite,

     int                  linetype

);