DBgradisIdFromElement

Top  Previous  Next

Gradis-ID eines Elements ermitteln.

Gegeben ist ein Handle für ein Element. Für dieses Element wird eine gradis-kompatible ID erzeugt. Diese besteht aus zwei 16-Bit Integer-Zahlen. Die erste Zahl identifiziert das Objekt, in dem sich das Element befindet, die zweite das Element selbst. Zwei Elemente aus demselben Objekt haben immer dieselbe Identifizierung für das Objekt. Da es sich um 16-Bit-Zahlen handelt, ist die Zahl der Handles, für die eine solche ID erzeugt werden kann, beschränkt. Die gradis-kompatiblen IDs werden erst bei ihrer Benutzung vergeben und sind bei nachfolgenden Aufrufen derselben Datenbank nicht dieselben. Die ID 0 wird nicht vergeben. Wenn eine der beiden 16-Bit-Zahlen 0 ist, ist die Zahl der möglichen IDs erschöpft.

Beim Löschen eines Elements wird dessen ID wieder freigegeben.

Parameter

element (PELEMENT)                                [IN]

Handle des Elements, zu dem eine Gradis-ID benötigt wird.

Ergebnis

(GRADISELEMENTID)                          [OUT]

Ist die zu diesem Element erzeugte Gradis-ID. Dies ist ein Rekord mit den Feldern elemID und objID. Ist eines dieser Felder 0, so konnte keine weitere ID vergeben werden. Die Gradis-ID identifiziert das Objekt eindeutig.

Deklaration

#include "database.h"

 

GRADISELEMENTID DLLENTRY DBgradisIdFromElement (

     PELEMENT    element

);

Verwandte Prozeduren

DBgradisIdFromSegment

DBgradisIdFromObject

DBgradisIdFromPoint

DBsegmentFromGradisId

DBobjectFromGradisId

DBpointFromGradisId