DBnewDisplayVector2

Top  Previous  Next

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]

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.

zeichenschluessel (int)                               [IN]

Mit diesem Wert werden die Linien gezeichnet. Er entspricht etwa einer Zeichenfarbe.

Ergebnis

(T_ERROR)                                            [OUT]

Konnte ein Vector angelegt werden, wird ERROR_OK zurückgeliefert, sonst eine Konstante aus error.h.

Deklaration

Deklariert in draw.c

 

T_ERROR DLLENTRY DBnewDisplayVector2 (

     PROOT    root,

     double      x1,

     double      y1,

     double      x2,

     double      y2,

     int         zeichenschluessel

);

Verwandte Funktionen

DBnewDisplayVector