[Libreoffice-commits] core.git: include/svx
Michael Stahl
mstahl at redhat.com
Wed Jan 7 14:39:08 PST 2015
include/svx/svdobj.hxx | 206 ++++++++++++++++++++++++------------------------
include/svx/svdpage.hxx | 76 ++++++++---------
2 files changed, 141 insertions(+), 141 deletions(-)
New commits:
commit 4542c1c97b90ddb52538525fb98b8058c89b2106
Author: Michael Stahl <mstahl at redhat.com>
Date: Wed Jan 7 23:16:27 2015 +0100
svx: translate German comments on SdrObject/SdrPage
Change-Id: I6fcccc0c8a5ec75edc54f6b5a4675a7ed9e1ca8f
diff --git a/include/svx/svdobj.hxx b/include/svx/svdobj.hxx
index fd1f56f..1113ef8 100644
--- a/include/svx/svdobj.hxx
+++ b/include/svx/svdobj.hxx
@@ -105,44 +105,46 @@ namespace svx
// Defines
-enum SdrObjKind {OBJ_NONE = 0, // abstract object (SdrObject)
- OBJ_GRUP = 1, // object group
- OBJ_LINE = 2, // line
- OBJ_RECT = 3, // rectangle (round corners optional)
- OBJ_CIRC = 4, // circle, ellipse
- OBJ_SECT = 5, // circle section
- OBJ_CARC = 6, // circle arc
- OBJ_CCUT = 7, // circle cut
- OBJ_POLY = 8, // polygon, PolyPolygon
- OBJ_PLIN = 9, // PolyLine
- OBJ_PATHLINE =10, // open Bezier-curve
- OBJ_PATHFILL =11, // closed Bezier-curve
- OBJ_FREELINE =12, // open free-hand line
- OBJ_FREEFILL =13, // closed free-hand line
- OBJ_SPLNLINE =14, // Natuerlicher kubischer Spline (ni)
- OBJ_SPLNFILL =15, // Periodischer kubischer Spline (ni)
- OBJ_TEXT =16, // text object
- OBJ_TEXTEXT =17, // Texterweiterungsrahmen (ni)
- OBJ_wegFITTEXT, // FitToSize-Text (alle Zeilen gleich)
- OBJ_wegFITALLTEXT, // FitToSize-Text (Zeilenweise) (ni)
- OBJ_TITLETEXT =20, // Titeltext. Spezial-Textobjekt fuer StarDraw
- OBJ_OUTLINETEXT=21, // OutlineText. Spezial-Textobjekt fuer StarDraw
- OBJ_GRAF =22, // Fremdgrafik - (StarView Graphic)
- OBJ_OLE2 =23, // OLE object
- OBJ_EDGE =24, // Verbindungsobjekt fuer Konnektoren
- OBJ_CAPTION =25, // Legendenobjekt
- OBJ_PATHPOLY =26, // Polygon/PolyPolygon dargestellt durch SdrPathObj
- OBJ_PATHPLIN =27, // Polyline dargestellt durch SdrPathObj
- OBJ_PAGE =28, // object that represents a SdrPage
- OBJ_MEASURE =29, // measurement object
- OBJ_DUMMY =30, // dummy object for saving holes (to recover surrogates later)
- OBJ_FRAME =31, // continiously activated aktives OLE (PlugIn-Frame or similar)
- OBJ_UNO =32, // Universal Network Object packed into SvDraw object
- OBJ_CUSTOMSHAPE=33, // custom shape
- OBJ_MEDIA =34, // media shape
- OBJ_TABLE =35, // table
- OBJ_OPENGL =36, // opengl graphic
- OBJ_MAXI};
+enum SdrObjKind {
+ OBJ_NONE = 0, /// abstract object (SdrObject)
+ OBJ_GRUP = 1, /// object group
+ OBJ_LINE = 2, /// line
+ OBJ_RECT = 3, /// rectangle (round corners optional)
+ OBJ_CIRC = 4, /// circle, ellipse
+ OBJ_SECT = 5, /// circle section
+ OBJ_CARC = 6, /// circle arc
+ OBJ_CCUT = 7, /// circle cut
+ OBJ_POLY = 8, /// polygon, PolyPolygon
+ OBJ_PLIN = 9, /// PolyLine
+ OBJ_PATHLINE =10, /// open Bezier-curve
+ OBJ_PATHFILL =11, /// closed Bezier-curve
+ OBJ_FREELINE =12, /// open free-hand line
+ OBJ_FREEFILL =13, /// closed free-hand line
+ OBJ_SPLNLINE =14, /// natural cubic Spline (ni)
+ OBJ_SPLNFILL =15, /// periodic cubic Spline (ni)
+ OBJ_TEXT =16, /// text object
+ OBJ_TEXTEXT =17, /// text extension frame (ni)
+ OBJ_wegFITTEXT, /// FitToSize-Text (all lines equal)
+ OBJ_wegFITALLTEXT, /// FitToSize-Text (by line) (ni)
+ OBJ_TITLETEXT =20, /// TitleText, special text object for StarDraw
+ OBJ_OUTLINETEXT=21, /// OutlineText, special text object for StarDraw
+ OBJ_GRAF =22, /// foreign graphic (StarView Graphic)
+ OBJ_OLE2 =23, /// OLE object
+ OBJ_EDGE =24, /// connector object
+ OBJ_CAPTION =25, /// caption object
+ OBJ_PATHPOLY =26, /// Polygon/PolyPolygon represented by SdrPathObj
+ OBJ_PATHPLIN =27, /// Polyline represented by SdrPathObj
+ OBJ_PAGE =28, /// object that represents a SdrPage
+ OBJ_MEASURE =29, /// measurement object
+ OBJ_DUMMY =30, /// dummy object for saving holes (to recover surrogates later)
+ OBJ_FRAME =31, /// continuously activated OLE (PlugIn-Frame or similar)
+ OBJ_UNO =32, /// Universal Network Object packed into SvDraw object
+ OBJ_CUSTOMSHAPE=33, /// custom shape
+ OBJ_MEDIA =34, /// media shape
+ OBJ_TABLE =35, /// table
+ OBJ_OPENGL =36, /// opengl graphic
+ OBJ_MAXI
+};
enum SdrUserCallType {SDRUSERCALL_MOVEONLY, // only moved, size unchanged
SDRUSERCALL_RESIZE, // size and maybe position changed
@@ -402,10 +404,10 @@ protected:
virtual SdrObjPlusData* NewPlusData() const;
protected:
- // Diese 3 Methoden muss ein abgeleitetes Objekt ueberladen, wenn es eigene
- // geometrische Daten besitzt, die fuer den Undo-Fall gesichert werden
- // sollen. NewGeoData() erzeugt lediglich eine leere Instanz auf eine von
- // SdrObjGeoData abgeleitete Klasse.
+ /// A derived class must override these 3 methods if it has own geometric
+ /// data that must be saved for Undo.
+ /// NewGeoData() creates an empty instance of a class derived from
+ /// SdrObjGeoData.
virtual SdrObjGeoData* NewGeoData() const;
virtual void SaveGeoData(SdrObjGeoData& rGeo) const;
virtual void RestGeoData(const SdrObjGeoData& rGeo);
@@ -480,15 +482,15 @@ public:
virtual SdrObjList* GetSubList() const;
SdrObject* GetUpGroup() const;
- // 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.
+ /// The order number (aka ZOrder, aka z-index) determines whether a
+ /// SdrObject is located above or below another. Objects are painted from
+ /// lowest to highest order number. If the order of SdrObjects in the
+ /// SdrObjList is changed, the bObjOrdNumsDirty flag is set on the SdrPage
+ /// and the next GetOrdNum() call recalculates the order number of all
+ /// SdrObjects in the SdrObjList.
sal_uInt32 GetOrdNum() const;
- // Warning: this method should only be used if you really knows what you're doing
+ // Warning: this method should only be used if you really know what you're doing
sal_uInt32 GetOrdNumDirect() const { return nOrdNum;}
// setting the order number should only happen from the model or from the page
@@ -556,41 +558,41 @@ public:
virtual OUString TakeObjNameSingul() const;
virtual OUString TakeObjNamePlural() const;
- // Das Xor-Polygon wird von der View zu Draggen des Objektes benoetigt.
- // Alle Polygone innerhalb des tools::PolyPolygon werden als PolyLine interpretiert.
- // Moechte man ein geschlossenes Polygon, so muss man es explizit schliessen.
+ /// The Xor-Polygon is required by the View to drag the object.
+ /// All polygons within the PolyPolygon are interpreted as PolyLine.
+ /// To get a closed Polygon, close it explicitly.
virtual basegfx::B2DPolyPolygon TakeXorPoly() const;
- // Die Kontur fuer TextToContour
+ /// contour for TextToContour
virtual basegfx::B2DPolyPolygon TakeContour() const;
- // Ueber GetHdlCount gibt ein Objekt die Anzahl seiner Handles preis.
- // Im Normalfall werden dies 8 sein, bei einer Strecke 2. Bei Polygonobjekten
- // (Polygon,Spline,Bezier) kann die Handleanzahl wesentlich groesser werden.
- // Polygonobjekten wird ausserdem die Moeglichkeit eingeraeumt einen Punkt
- // eines selektierten Objekts zu selektieren. Das Handle dieses Punktes wird
- // dann durch einen Satz neuer Handles ausgetauscht (PlusHdl). Bei einem
- // Polygon wird das wohl ein einfacher Selektionshandle sein, bei einer
- // Bezierkurve dagegen koennen das schon bis zu 3 Handles werden (inkl Gewichte).
- // GetHdl() und GetPlusHdl() muessen Handleinstanzen mit new erzeugen!
- // Ein Objekt, das bei HasSpacialDrag() true liefert muss diese Methoden
- // zur Verfuegung stellen (inkl. FillHdlList).
+ /// Via GetHdlCount the number of Handles can be retrieved.
+ /// Normally 8, if it's a line 2.
+ /// For Polygon objects (Polygon/Spline/Bezier) the number may be much
+ /// larger. Polygon objects are also allowed to select a point of a
+ /// selected object. The handle of that point will then be replaced by
+ /// a new set of handles (PlusHdl). For a Polygon this would be a simple
+ /// selection Handle, for a Bezier curve this may be up to 3 Handles
+ /// (including Weights).
+ /// GetHdl() and GetPlusHdl() must create Handle instances with new!
+ /// An object that returns true from HasSpacialDrag() must provide these
+ /// methods (incl. FillHdlList()).
virtual sal_uInt32 GetHdlCount() const;
virtual SdrHdl* GetHdl(sal_uInt32 nHdlNum) const;
virtual sal_uInt32 GetPlusHdlCount(const SdrHdl& rHdl) const;
virtual SdrHdl* GetPlusHdl(const SdrHdl& rHdl, sal_uInt32 nPlNum) const;
virtual void AddToHdlList(SdrHdlList& rHdlList) const;
- // Die Standardtransformationen (Move,Resize,Rotate,Mirror,Shear) werden von der
- // View uebernommen (TakeXorPoly(),...).
- // Objektspeziefisches draggen wie z.B. Eckenradius bei Rechtecken,
- // Stuetzstellen bei Splines, Gewichte bei Bezierkurven und Pointer von
- // Labelobjekten muss vom Objekt selbst gehandled werden. Um das Model
- // Statusfrei zu halten werden die Statusdaten an der View gehalten und dem
- // Objekt dann uebergeben. EndDrag liefrt im Normalfall true fuer Erfolg.
- // false kann zurueckgegeben werden, wenn das Dragging das Objekt nicht
- // veraendert hat, wobei dir evtl. Tatsache das die Maus nicht bewegt wurde
- // bereits von der View abgefangen wird.
+ /// The standard transformations (Move,Resize,Rotate,Mirror,Shear) are
+ /// taken over by the View (TakeXorPoly(),...).
+ /// Object type specific dragging like corner radius of Rectangle,
+ /// control points of Splines, weights of Bezier curves, pointer of
+ /// Label objects must be handled by the object itself.
+ /// To keep the Model free of state, the state is kept in the View
+ /// and then passed to the object. EndDrag usually returns true for success,
+ /// false may be returned if the dragging did not modify the object,
+ /// where the View already handles the case that the pointer was not
+ /// moved at all.
virtual bool hasSpecialDrag() const;
virtual bool beginSpecialDrag(SdrDragStat& rDrag) const;
virtual bool applySpecialDrag(SdrDragStat& rDrag);
@@ -607,36 +609,36 @@ public:
virtual bool supportsFullDrag() const;
virtual SdrObject* getFullDragClone() const;
- // Jedes Objekt muss in der Lage sein sich selbst interaktiv zu erzeugen.
- // Beim MausDown wird zunaechst ein neues Objekt erzeugt und dann seine
- // BegCreate()-Methode gerufen. Bei jedem MausMode wird dann MovCreate
- // gerufen. BrkCreate() bedeutet, dass der User die interaktive Objekt-
- // erzeugung abgebrochen hat. EndCreate() wird gerufen beim MouseUp-Event.
- // Liefert EndCreate() ein true, so ist die Objekterzeugung abgeschlossen;
- // das Objekt wird in die entsprechende Liste eingefuegt. Andernfalls
- // (EndCreate()==false) gehe ich davon aus, dass weitere Punkte zur
- // Objekterzeugung notwendig sind (Polygon,...). Der Parameter eCmd
- // enthaelt die Anzahl der Mausklicks (so die App diese durchreicht).
- // BckCreate() -> Letztes EndCreate() rueckgaengig machen (z.B. letzten
- // Polygonpunkt wieder loeschen).
- // ReturnCode: true=Weiter gehts, false=Create dadurch abgebrochen.
+ /// Every object must be able to create itself interactively.
+ /// On MouseDown first an object is created, and its BegCreate() method
+ /// is called. On every MouseMove, MovCreate() is called. BrkCreate()
+ /// is called if the user cancels the interactive object creation.
+ /// EndCreate() is called on the MouseUp event. If EndCreate() returns
+ /// true, the creation is finished; the object is inserted into the
+ /// corresponding list. Otherwise it is assumed that further points
+ /// are necessary to create the object (Polygon, ...). The parameter
+ /// eCmd contains the number of mouse clicks (if the application
+ /// provides it).
+ /// BckCreate() will undo the previous EndCreate(), e.g. to delete the
+ /// last point of the Polygon. If BckCreate() returns false, creation
+ /// is cancelled.
virtual bool BegCreate(SdrDragStat& rStat);
virtual bool MovCreate(SdrDragStat& rStat); // if true, Xor needs to be repainted
virtual bool EndCreate(SdrDragStat& rStat, SdrCreateCmd eCmd);
virtual bool BckCreate(SdrDragStat& rStat);
virtual void BrkCreate(SdrDragStat& rStat);
- // damit holt man sich den Pointer, der das Createn dieses Objekts symbolisiert
+ /// get the cursor/pointer that signals creating this object
virtual Pointer GetCreatePointer() const;
- // Polygon das waehrend des Erzeugens aufgezogen wird
+ /// Polygon dragged by the user when creating the object
virtual basegfx::B2DPolyPolygon TakeCreatePoly(const SdrDragStat& rDrag) const;
- // Die Methoden Move, Resize, Rotate, Mirror, Shear, SetSnapRect und
- // SetLogicRect rufen jeweils die entsprechenden Nbc-Methoden, versenden einen
- // Repaint-Broadcast und setzen den Modified-Status am Model. Abgeleitete
- // Objekte sollten i.d.R. nur die Nbc-Methoden ueberladen.
- // Nbc bedeutet: 'NoBroadcast'.
+ /// The methods Move, Resize, Rotate, Mirror, Shear, SetSnapRect and
+ /// SetLogicRect call the corresponding Nbc-methods, send a Repaint
+ /// broadcast and set the Modified state on the Model.
+ /// Derived classes should usually only override the Nbc methods.
+ /// Nbc means "no broadcast".
virtual void NbcMove (const Size& rSiz);
virtual void NbcResize(const Point& rRef, const Fraction& xFact, const Fraction& yFact);
virtual void NbcRotate(const Point& rRef, long nAngle, double sn, double cs);
@@ -649,9 +651,8 @@ public:
virtual void Mirror(const Point& rRef1, const Point& rRef2);
virtual void Shear (const Point& rRef, long nAngle, double tn, bool bVShear);
- // Die relative Position eines Zeichenobjektes ist die Entfernung der
- // linken oberen Eche des logisch umschliessenden Rechtecks (SnapRect)
- // zum Anker.
+ /// The relative position of a SdrObject is the distance of the upper
+ /// left corner of the logic bounding rectangle (SnapRect) to the anchor.
virtual void NbcSetRelativePos(const Point& rPnt);
virtual void SetRelativePos(const Point& rPnt);
virtual Point GetRelativePos() const;
@@ -660,10 +661,10 @@ public:
virtual void SetAnchorPos(const Point& rPnt);
virtual const Point& GetAnchorPos() const;
- // Snap wird nicht auf dem BoundRect ausgefuehrt, sondern nach Moeglichkeit auf
- // logischen Koordinaten (also ohne Beruecksichtigung von Strichstaerke, ... ).
- // SetSnapRect() versucht das Objekt so hinzusizen, dass es in das uebergebene
- // Rect passt (ohne Strichstaerke, ...)
+ /// Snap is not done on the BoundRect but if possible on logic coordinates
+ /// (i.e. without considering stroke width, ...)
+ /// SetSnapRect() tries to size the Object so that it fits into the
+ /// passed Rect (without stroke width, ...)
virtual void RecalcSnapRect();
virtual const Rectangle& GetSnapRect() const;
virtual void SetSnapRect(const Rectangle& rRect);
@@ -685,8 +686,7 @@ public:
virtual long GetRotateAngle() const;
virtual long GetShearAngle(bool bVertical = false) const;
- // Zum Fangen von/auf ausgezeichneten Punkten eines Obj (Polygonpunkte,
- // Kreismittelpunkt, ...)
+ /// snap to special points of an Object (polygon points, center of circle)
virtual sal_uInt32 GetSnapPointCount() const;
virtual Point GetSnapPoint(sal_uInt32 i) const;
diff --git a/include/svx/svdpage.hxx b/include/svx/svdpage.hxx
index c186f3a..833e0ce 100644
--- a/include/svx/svdpage.hxx
+++ b/include/svx/svdpage.hxx
@@ -54,12 +54,14 @@ class Color;
class SfxStyleSheet;
class SvxUnoDrawPagesAccess;
-enum SdrInsertReasonKind {SDRREASON_UNKNOWN, // unbekannt
- SDRREASON_STREAMING, // einlesen eines Doks
- SDRREASON_UNDO, // kommt aus dem Undo
- SDRREASON_COPY, // irgendjemand kopiert...
- SDRREASON_VIEWCREATE, // vom Anwender interaktiv erzeugt
- SDRREASON_VIEWCALL}; // Durch SdrView::Group(), ...
+enum SdrInsertReasonKind {
+ SDRREASON_UNKNOWN,
+ SDRREASON_STREAMING, /// importing document
+ SDRREASON_UNDO, /// from Undo
+ SDRREASON_COPY, /// something copied...
+ SDRREASON_VIEWCREATE, /// created by User interactively
+ SDRREASON_VIEWCALL /// via SdrView::Group(), ...
+};
class SdrInsertReason {
const SdrObject* pRefObj;
@@ -88,10 +90,10 @@ private:
protected:
friend class SdrObjListIter;
friend class SdrEditView;
- SdrObjList* pUpList; // Vaterliste
- SdrModel* pModel; // Diese Liste gehoert zu diesem Model (Layer,ItemPool,Storage).
- SdrPage* pPage; // Page, in die Liste haengt. Kann auch this sein.
- SdrObject* pOwnerObj; // OwnerObject, falls Liste eines GruppenObjekts.
+ SdrObjList* pUpList; /// parent list
+ SdrModel* pModel; /// model to which the list belongs (Layer,ItemPool,Storage)
+ SdrPage* pPage; /// Page containing the list, may be "this".
+ SdrObject* pOwnerObj; /// OwnerObject, if it's list of a Group object.
Rectangle aOutRect;
Rectangle aSnapRect;
SdrObjListKind eListKind;
@@ -113,12 +115,12 @@ public:
virtual SdrObjList* Clone() const;
- // !!! Diese Methode nur fuer Leute, die ganz genau wissen was sie tun !!!
+ // !!! This method is only for people who know exactly what they do !!!
// #110094# This should not be needed (!)
void SetObjOrdNumsDirty() { bObjOrdNumsDirty=true; }
void CopyObjects(const SdrObjList& rSrcList);
- // alles Aufraeumen (ohne Undo)
+ /// clean up everything (without Undo)
void Clear();
SdrObjListKind GetListKind() const { return eListKind; }
void SetListKind(SdrObjListKind eNewKind) { eListKind=eNewKind; }
@@ -130,7 +132,7 @@ public:
virtual void SetPage(SdrPage* pNewPage);
virtual SdrModel* GetModel() const;
virtual void SetModel(SdrModel* pNewModel);
- // Neuberechnung der Objekt-Ordnungsnummern
+ /// recalculate order numbers / ZIndex
void RecalcObjOrdNums();
bool IsObjOrdNumsDirty() const { return bObjOrdNumsDirty; }
virtual void NbcInsertObject(SdrObject* pObj, size_t nPos=SAL_MAX_SIZE
@@ -139,15 +141,15 @@ public:
virtual void InsertObject(SdrObject* pObj, size_t nPos=SAL_MAX_SIZE
, const SdrInsertReason* pReason=NULL
);
- // aus Liste entfernen ohne delete
+ /// remove from list without delete
virtual SdrObject* NbcRemoveObject(size_t nObjNum);
virtual SdrObject* RemoveObject(size_t nObjNum);
- // Vorhandenes Objekt durch ein anderes ersetzen.
- // Wie Remove&Insert jedoch performanter, da die Ordnungsnummern
- // nicht Dirty gesetzt werden muessen.
+ /// Replace existing object by different one.
+ /// Same as Remove(old)+Insert(new) but faster because the order numbers
+ /// do not have to be set dirty.
virtual SdrObject* NbcReplaceObject(SdrObject* pNewObj, size_t nObjNum);
virtual SdrObject* ReplaceObject(SdrObject* pNewObj, size_t nObjNum);
- // Die Z-Order eines Objekts veraendern
+ /// Modify ZOrder of an SdrObject
virtual SdrObject* NbcSetObjectOrdNum(size_t nOldObjNum, size_t nNewObjNum);
virtual SdrObject* SetObjectOrdNum(size_t nOldObjNum, size_t nNewObjNum);
@@ -156,23 +158,23 @@ public:
const Rectangle& GetAllObjSnapRect() const;
const Rectangle& GetAllObjBoundRect() const;
- // Alle Textobjekte neu formatieren, z.B. bei Druckerwechsel
+ /// reformat all text objects, e.g. when changing printer
void NbcReformatAllTextObjects();
void ReformatAllTextObjects();
/** #103122# reformats all edge objects that are connected to other objects */
void ReformatAllEdgeObjects();
- // Die Vorlagenattribute der Zeichenobjekte in harte Attribute verwandeln.
+ /// convert attributes of the style to hard formatting
void BurnInStyleSheetAttributes();
size_t GetObjCount() const;
SdrObject* GetObj(size_t nNum) const;
- // Gelinkte Seite oder gelinktes Gruppenobjekt
+ /// linked page or linked group object
virtual bool IsReadOnly() const;
- // Zaehlt alle Objekte inkl. Objekte in Objektgruppen, ...
+ /// count all objects including objects in Groups
size_t CountAllObjects() const;
/** Makes the object list flat, i.e. the object list content are
@@ -302,22 +304,13 @@ private:
const sal_uInt32 nObjectPosition);
};
-/*
-Eine Sdraw-Seite enthaelt genau eine Objektliste sowie eine Beschreibung
-der physikalischen Seitendimensionen (Groesse/Raender). Letzteres wird
-lediglich zum Fangen von Objekten beim Draggen benoetigt.
-An der Seite lassen sich (ueber SdrObjList) Objekte einfuegen und loeschen,
-nach vorn und nach hinten stellen. Ausserdem kann die Ordnungszahl eines
-Objektes abgefragt sowie direkt gesetzt werden.
-*/
-
// Used for all methods which return a page number
#define SDRPAGE_NOTFOUND 0xFFFF
// class SdrPageGridFrame
-// Fuer das Fangraster/Punkgitter im Writer
+/// for the snap-to-grid in Writer
class SdrPageGridFrame
{
Rectangle aPaper;
@@ -407,8 +400,15 @@ public:
};
-// class SdrPage
-
+/**
+ A SdrPage contains exactly one SdrObjList and a description of the physical
+ page dimensions (size / margins). The latter is required to "catch" objects
+ during drag-and-drop.
+ The SdrPage allows (via SdrObjList) inserting and removing SdrObjects,
+ as well as moving them into the foreground or background.
+ Also it's possible to request and directly set the order number (ZOrder)
+ of SdrObjects.
+*/
class SVX_DLLPUBLIC SdrPage : public SdrObjList, public tools::WeakBase< SdrPage >
{
SdrPage& operator=(const SdrPage& rSrcPage) SAL_DELETED_FUNCTION;
@@ -541,15 +541,15 @@ protected:
void TRG_ImpMasterPageRemoved(const SdrPage& rRemovedPage);
public:
- // Aenderungen an den Layern setzen nicht das Modified-Flag !
+ /// changing the layers does not set the modified-flag!
const SdrLayerAdmin& GetLayerAdmin() const { return *pLayerAdmin; }
SdrLayerAdmin& GetLayerAdmin() { return *pLayerAdmin; }
virtual OUString GetLayoutName() const;
- // fuer's Raster im Writer, auch fuer AlignObjects wenn 1 Objekt markiert ist
- // wenn pRect!=NULL, dann die Seiten, die von diesem Rect intersected werden
- // ansonsten die sichtbaren Seiten.
+ /// for snap-to-grid in Writer, also for AlignObjects if 1 object is marked
+ /// if pRect != null, then the pages that are intersected by this Rect,
+ /// otherwise the visible pages
virtual const SdrPageGridFrameList* GetGridFrameList(const SdrPageView* pPV, const Rectangle* pRect) const;
bool IsObjectsNotPersistent() const { return mbObjectsNotPersistent; }
void SetObjectsNotPersistent(bool b) { mbObjectsNotPersistent = b; }
More information about the Libreoffice-commits
mailing list