SetObjectOrder

Kategorie: Objekte / Position
Ab Engineversion: 4.9.1.0 GWE (erweitert ab 4.9.5.0 CE)

Beschreibung

Sorgt dafür, dass ein Objekt mit Sicherheit vor oder hinter einem anderen Objekt angeordnet ist. Dadurch lässt sich beispielsweise sicherstellen, dass sich ein Fahrstuhlkorb immer vor dem zugehörigen Fahrstuhl befindet.

Syntax

bool SetObjectOrder (object pObjBeforeOrAfter, object pSortObj, bool fAfter);

Parameter

pObjBeforeOrAfter:
Objekt, vor oder nach dem pSortObj einsortiert werden soll
pSortObj:
[opt] Objekt, das vor oder nach pObjBefore eingeordnet wird. 0 bei lokalem Aufruf.
fAfter:
[opt] Wenn ungleich 0, wird sichergestellt, dass das pSortObj hinter statt vor pObjBeforeOrAfter einsortiert wird.

Anmerkung

Es sollten nur Objekte gleicher Kategorie voreinander angeordnet werden, da sonst die interne Objektsortierung durcheinandergerät.
Die eigentliche Umsortierung findet erst später, aber mit Sicherheit noch im selben Frame wie der Scriptaufruf statt.

Beispiel

SetObjectOrder(FindObject(TRE1), FindObject(TRE2));
Ordnet den ersten, gefundenen Baum vom Typ TRE2 vor den ersten, gefundenen Baum vom Typ TRE1.
Siehe auch: Resort, ResortObjects
Sven2, April 2002