DBaddSymbol

Hinzufügen eines neuen Symbols in das Objekt.

Mit diesem Aufruf wird dem Objekt mit dem Handle object ein neues Symbol hinzugefügt. Ein Symbol ist ein geometrisches Element, das einer Tabelle entnommen wird. Diese Tabelle kann nach Erzeugen der Symbole geändert werden und beeinflusst dann das Aussehen bestehender Symbole in der Zeichnung. Ein Symbol besteht aus der Symbolnummer, also dem Index im Symbolverzeichnis, einer Position und einer Drehung. Die Drehung wird durch zwei Winkel alpha und beta beschrieben, die das Symbol in der x-y-Ebene (alpha) und in der Senkrechten dazu drehen.

Parameter

object (POBJECT)                                     [IN]

Dies ist das Handle des Objekts, in das ein neues Attribut eingesetzt werden soll.

symbolNum (SYMBOL)                              [IN]

Mit dieser Zahl wird in der Symboltabelle das Aussehen des Symbols bestimmt. Durch Ändern eines Eintrags in der Symboltabelle werden alle Symbole mit diesem Eintrag in ihrem Aussehen beeinflusst.

x (DOUBLE)                                                [IN]

(x,y,z) gibt die Position des Symbols im Raum an.

y (DOUBLE)                                                [IN]

Auch bei zweidimensionaler Darstellung...

z (DOUBLE)                                                [IN]

...ist der z-Wert notwendig. Hier ist dann einfach 0 einzutragen.

alpha (WINKEL)                                          [IN]

Mit alpha wird die Drehung des Symbols in der x-y-Ebene bestimmt.

beta (WINKEL)                                           [IN]

Mit beta wird die Neigung des Symbols in der zu x-y senkrechten Ebene angegeben.

Ergebnis

(PSYMBOL_ELEMENT)                        [OUT]

Das Handle des neu erzeugten Elements wird als Ergebnis zurückgeliefert. Wenn ein Fehler aufgetreten ist, wird NULL als Ergebnis geliefert. Mögliche Fehler sind Speichermangel und ungültiges Objekthandle.

Deklaration

#include "database.h“

PSYMBOL_ELEMENT DLLENTRY DBaddSymbol(

     POBJECT     object,

     USHORT         symbolNum,

     DOUBLE         x,

     DOUBLE         y,

     DOUBLE         z,

     WINKEL         alpha,

     WINKEL         beta

);