Comment 40 for bug 785518

(In reply to comment #33)

> It'd be great to have a translation of GetOrdNum vs. GetOrdNumDirect in
> svx/inc/svx/svdobj.hxx - to try to grok what's going on there - if there is a
> German speaker around.

// Ueber die Objekt-Ordnungsnummer kann man feststellen, ob ein Objekt vor
// oder hinter einem anderen liegt. Objekte mit kleinen Ordnungsnummern werden
// zuerst gezeichnet, Objekte mit grossen Ordnungsnummern zuletzt.
// Wird die Reihenfolge der Objekte in der Liste veraendert, so wird ein
// Dirty-Flag gesetzt (an der Page). Beim naechsten SdrObject::GetOrdNum()
// werden die Ordnungsnummer aller Objekte der Liste neu bestimmt.

Via the object ordinal number it is possible to find out if an object is in front or behind another object. Objects with lower ordinal numbers will be drawn first, objects with higher ordinal numbers last. If the order of the objects in the list is changed, a dirty-flag is set (on the Page). During the next call of SdrObject::GetOrdNum() the ordinal numbers of all objects of the list will be re-calculated/set.

sal_uInt32 GetOrdNum() const;

// Diese Methode sollte nur verwendet werden, wenn man ganz genau weiss,
// was man macht:

This method SHOULD only be used if you know very well, what you do:

sal_uInt32 GetOrdNumDirect() const { return nOrdNum; }