[Libreoffice-commits] core.git: include/svx
Tobias Mueller
tobiasmue at gnome.org
Mon May 12 08:23:44 PDT 2014
include/svx/svdmodel.hxx | 336 ++++++++++++++++++++++-------------------------
1 file changed, 163 insertions(+), 173 deletions(-)
New commits:
commit fd5ce1335d1bbc7d0bd86e7f3328461af2367711
Author: Tobias Mueller <tobiasmue at gnome.org>
Date: Sun May 11 23:48:13 2014 +0200
svx: Translated the svdmodel.hxx from German to English
Change-Id: I98d5e1308f192c302a4db023044d9246eff3c320
Reviewed-on: https://gerrit.libreoffice.org/9320
Reviewed-by: Thomas Arnhold <thomas at arnhold.org>
Tested-by: Thomas Arnhold <thomas at arnhold.org>
diff --git a/include/svx/svdmodel.hxx b/include/svx/svdmodel.hxx
index 3c1e6e5..e982cb5 100644
--- a/include/svx/svdmodel.hxx
+++ b/include/svx/svdmodel.hxx
@@ -96,18 +96,18 @@ namespace sfx2
enum SdrHintKind
{
- HINT_UNKNOWN, // Unbekannt
- HINT_LAYERCHG, // Layerdefinition geaendert
- HINT_LAYERORDERCHG, // Layerreihenfolge geaendert (Insert/Remove/ChangePos)
- HINT_PAGEORDERCHG, // Reihenfolge der Seiten (Zeichenseiten oder Masterpages) geaendert (Insert/Remove/ChangePos)
- HINT_OBJCHG, // Objekt geaendert
- HINT_OBJINSERTED, // Neues Zeichenobjekt eingefuegt
- HINT_OBJREMOVED, // Zeichenobjekt aus Liste entfernt
- HINT_MODELCLEARED, // gesamtes Model geloescht (keine Pages mehr da). not impl.
- HINT_REFDEVICECHG, // RefDevice geaendert
- HINT_DEFAULTTABCHG, // Default Tabulatorweite geaendert
- HINT_DEFFONTHGTCHG, // Default FontHeight geaendert
- HINT_MODELSAVED, // Dokument wurde gesichert
+ HINT_UNKNOWN, // Unknown
+ HINT_LAYERCHG, // changed layer definition
+ HINT_LAYERORDERCHG, // order of layer changed (Insert/Remove/ChangePos)
+ HINT_PAGEORDERCHG, // order of pages (object pages or master pages) changed (Insert/Remove/ChangePos)
+ HINT_OBJCHG, // object changed
+ HINT_OBJINSERTED, // new object inserted
+ HINT_OBJREMOVED, // symbol object removed from list
+ HINT_MODELCLEARED, // deleted the whole model (no pages exist anymore). not impl.
+ HINT_REFDEVICECHG, // RefDevice changed
+ HINT_DEFAULTTABCHG, // Default tabulator width changed
+ HINT_DEFFONTHGTCHG, // Default FontHeight changed
+ HINT_MODELSAVED, // Document was saved
HINT_SWITCHTOPAGE, // #94278# UNDO/REDO at an object evtl. on another page
HINT_BEGEDIT, // Is called after the object has entered text edit mode
HINT_ENDEDIT // Is called after the object has left text edit mode
@@ -139,8 +139,9 @@ public:
-// Flag um nach dem Laden des Pools Aufzuraeumen (d.h. die RefCounts
-// neu zu bestimmen und unbenutztes wegzuwerfen). sal_False == aktiv
+// Flag for cleaning up after the loading of the pools, meaning the
+// recalculate the RefCounts and dispose unused items)
+// sal_False == active
#define LOADREFCOUNTS (false)
struct SdrModelImpl;
@@ -148,16 +149,16 @@ struct SdrModelImpl;
class SVX_DLLPUBLIC SdrModel : public SfxBroadcaster, public tools::WeakBase< SdrModel >
{
protected:
- DateTime aReadDate; // Datum des Einstreamens
- std::vector<SdrPage*> maMaPag; // StammSeiten (Masterpages)
+ DateTime aReadDate; // date of the incoming stream
+ std::vector<SdrPage*> maMaPag; // master pages
std::vector<SdrPage*> maPages;
- Link aUndoLink; // Link fuer einen NotifyUndo-Handler
+ Link aUndoLink; // link to a NotifyUndo-Handler
Link aIOProgressLink;
OUString aTablePath;
- Size aMaxObjSize; // z.B. fuer Autogrowing Text
- Fraction aObjUnit; // Beschreibung der Koordinateneinheiten fuer ClipBoard, Drag&Drop, ...
+ Size aMaxObjSize; // e.g. for auto-growing text
+ Fraction aObjUnit; // description of the coordinate units for ClipBoard, Drag&Drop, ...
MapUnit eObjUnit; // see above
- FieldUnit eUIUnit; // Masseinheit, Masstab (z.B. 1/1000) fuer die UI (Statuszeile) wird von ImpSetUIUnit() gesetzt
+ FieldUnit eUIUnit; // unit, scale (e.g. 1/1000) for the UI (status bar) is set by ImpSetUIUnit()
Fraction aUIScale; // see above
OUString aUIUnitStr; // see above
Fraction aUIUnitFact; // see above
@@ -167,11 +168,11 @@ protected:
SfxItemPool* pItemPool;
comphelper::IEmbeddedHelper*
m_pEmbeddedHelper; // helper for embedded objects to get rid of the SfxObjectShell
- SdrOutliner* pDrawOutliner; // ein Outliner zur Textausgabe
- SdrOutliner* pHitTestOutliner;// ein Outliner fuer den HitTest
- sal_uIntPtr nDefTextHgt; // Default Texthoehe in logischen Einheiten
- OutputDevice* pRefOutDev; // ReferenzDevice fuer die EditEngine
- sal_uIntPtr nProgressAkt; // fuer den
+ SdrOutliner* pDrawOutliner; // an Outliner for outputting text
+ SdrOutliner* pHitTestOutliner;// an Outliner for the HitTest
+ sal_uIntPtr nDefTextHgt; // Default text heigth in logical units
+ OutputDevice* pRefOutDev; // ReferenceDevice for the EditEngine
+ sal_uIntPtr nProgressAkt; // for the
sal_uIntPtr nProgressMax; // ProgressBar-
sal_uIntPtr nProgressOfs; // -Handler
rtl::Reference< SfxStyleSheetBasePool > mxStyleSheetPool;
@@ -180,31 +181,31 @@ protected:
sfx2::LinkManager* pLinkManager; // LinkManager
std::deque<SfxUndoAction*>* pUndoStack;
std::deque<SfxUndoAction*>* pRedoStack;
- SdrUndoGroup* pAktUndoGroup; // Fuer mehrstufige
- sal_uInt16 nUndoLevel; // Undo-Klammerung
- sal_uInt16 nProgressPercent; // fuer den ProgressBar-Handler
- sal_uInt16 nLoadVersion; // Versionsnummer der geladenen Datei
- bool bMyPool:1; // zum Aufraeumen von pMyPool ab 303a
+ SdrUndoGroup* pAktUndoGroup; // for deeper
+ sal_uInt16 nUndoLevel; // undo nesting
+ sal_uInt16 nProgressPercent; // for the ProgressBar-Handler
+ sal_uInt16 nLoadVersion; // version number of the loaded file
+ bool bMyPool:1; // to clean up pMyPool from 303a
bool bUIOnlyKomma:1; // see eUIUnit
bool mbUndoEnabled:1; // If false no undo is recorded or we are during the execution of an undo action
- bool bExtColorTable:1; // Keinen eigenen ColorTable
+ bool bExtColorTable:1; // ne separate ColorTable
bool mbChanged:1;
bool bInfoChanged:1;
bool bPagNumsDirty:1;
bool bMPgNumsDirty:1;
- bool bPageNotValid:1; // TRUE=Doc ist nur ObjektTraeger. Page ist nicht gueltig.
- bool bSavePortable:1; // Metafiles portabel speichern
- bool bNoBitmapCaching:1; // Bitmaps fuer Screenoutput cachen
+ bool bPageNotValid:1; // TRUE=Doc is only object container. Page is invalid.
+ bool bSavePortable:1; // save metafiles portably
+ bool bNoBitmapCaching:1; // cache bitmaps for screen output
bool bReadOnly:1;
bool bTransparentTextFrames:1;
bool bSaveCompressed:1;
bool bSwapGraphics:1;
- bool bPasteResize:1; // Objekte werden gerade resized wegen Paste mit anderem MapMode
+ bool bPasteResize:1; // Objects are beingresized due to Paste with different MapMode
bool bSaveOLEPreview:1; // save preview metafile of OLE objects
bool bSaveNative:1;
bool bStarDrawPreviewMode:1;
bool mbDisableTextEditUsesCommonUndoManager:1;
- sal_uInt16 nStreamCompressMode; // Komprimiert schreiben?
+ sal_uInt16 nStreamCompressMode; // write compressedly?
sal_uInt16 nStreamNumberFormat;
sal_uInt16 nDefaultTabulator;
sal_uInt32 nMaxUndoCount;
@@ -258,7 +259,7 @@ protected:
virtual ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface > createUnoModel();
private:
- // Nicht implementiert:
+ // not implemented:
SVX_DLLPRIVATE SdrModel(const SdrModel& rSrcModel);
SVX_DLLPRIVATE void operator=(const SdrModel& rSrcModel);
SVX_DLLPRIVATE bool operator==(const SdrModel& rCmpModel) const;
@@ -279,46 +280,44 @@ public:
bool IsPasteResize() const { return bPasteResize; }
void SetPasteResize(bool bOn) { bPasteResize=bOn; }
TYPEINFO_OVERRIDE();
- // Steckt man hier seinen eigenen Pool rein, so wird die Klasse auch
- // Aktionen an ihm vornehmen (Put(),Remove()). Bei Zerstoerung von
- // SdrModel wird dieser Pool ver delete geloescht!
- // Gibt man den Konstruktor stattdessen eine NULL mit, so macht sich
- // die Klasse einen eigenen Pool (SdrItemPool), den sie dann auch im
- // Destruktor zerstoert.
- // Bei Verwendung eines eigenen Pools ist darauf zu achten, dass dieser
- // von SdrItemPool abgeleitet ist, falls man von SdrAttrObj abgeleitete
- // Zeichenobjekte verwenden moechte. Setzt man degegen nur vom abstrakten
- // Basisobjekt SdrObject abgeleitete Objekte ein, so ist man frei in der
- // Wahl des Pools.
+ // If a custom Pool is put here, the class will call methods
+ // on it (Put(), Remove()). On disposal of SdrModel the pool
+ // will be deleted with delete.
+ // If you give NULL instead, it will create an own pool (SdrItemPool)
+ // which will also be disposed in the destructor.
+ // If you do use a custom Pool, make sure you inherit from SdrItemPool,
+ // if you want to use symbol objects inherited from SdrAttrObj.
+ // If, however, you use objects inheriting from SdrObject you are free
+ // to chose a pool of your liking.
explicit SdrModel();
explicit SdrModel(SfxItemPool* pPool, ::comphelper::IEmbeddedHelper* pPers, bool bUseExtColorTable, bool bLoadRefCounts);
explicit SdrModel(const OUString& rPath, SfxItemPool* pPool, ::comphelper::IEmbeddedHelper* pPers, bool bUseExtColorTable, bool bLoadRefCounts);
virtual ~SdrModel();
void ClearModel(bool bCalledFromDestructor);
- // Hier kann man erfragen, ob das Model gerade eingrstreamt wird
+ // Whether the model is being streamed in at the moment
bool IsLoading() const { return false /*BFS01 bLoading */; }
- // Muss z.B. ueberladen werden, um das Swappen/LoadOnDemand von Grafiken
- // zu ermoeglichen. Wird rbDeleteAfterUse auf sal_True gesetzt, so wird
- // die SvStream-Instanz vom Aufrufer nach Gebrauch destruiert.
- // Wenn diese Methode NULL liefert, wird zum Swappen eine temporaere
- // Datei angelegt.
- // Geliefert werden muss der Stream, aus dem das Model geladen wurde
- // bzw. in den es zuletzt gespeichert wurde.
+ // Needs to be overladed to enable the Swap/LoadOnDemand of graphics.
+ // If rbDeleteAfterUse is set to sal_True the SvStream instance from
+ // the caller will be disposed after use.
+ // If this method returns NULL, a temporary file will be allocated for
+ // swapping.
+ // The stream from which the model was loaded or in which is was saved last
+ // needs to be delivered
virtual ::com::sun::star::uno::Reference<
::com::sun::star::embed::XStorage> GetDocumentStorage() const;
::com::sun::star::uno::Reference<
::com::sun::star::io::XInputStream >
GetDocumentStream(OUString const& rURL,
::comphelper::LifecycleProxy & rProxy) const;
- // Die Vorlagenattribute der Zeichenobjekte in harte Attribute verwandeln.
+ // Change the template attributes of the symbol objects to hard attributes
void BurnInStyleSheetAttributes();
- // Wer sich von SdrPage ableitet muss sich auch von SdrModel ableiten
- // und diese beiden VM AllocPage() und AllocModel() ueberladen...
+ // If you inherit from SdrPage you also need to inherit from SdrModel
+ // and implement both VM AllocPage() and AllocModel()...
virtual SdrPage* AllocPage(bool bMasterPage);
virtual SdrModel* AllocModel() const;
- // Aenderungen an den Layern setzen das Modified-Flag und broadcasten am Model!
+ // Changes on the layers set the modified flag and broadcast on the model!
const SdrLayerAdmin& GetLayerAdmin() const { return *pLayerAdmin; }
SdrLayerAdmin& GetLayerAdmin() { return *pLayerAdmin; }
@@ -329,24 +328,24 @@ public:
SdrOutliner& GetHitTestOutliner() const { return *pHitTestOutliner; }
const SdrTextObj* GetFormattingTextObj() const;
- // Die TextDefaults (Font,Hoehe,Farbe) in ein Set putten
+ // put the TextDefaults (Font,Height,Color) in a Set
void SetTextDefaults() const;
static void SetTextDefaults( SfxItemPool* pItemPool, sal_uIntPtr nDefTextHgt );
- // ReferenzDevice fuer die EditEngine
+ // ReferenceDevice for the EditEngine
void SetRefDevice(OutputDevice* pDev);
OutputDevice* GetRefDevice() const { return pRefOutDev; }
- // Wenn ein neuer MapMode am RefDevice gesetzt wird o.ae.
- void RefDeviceChanged(); // noch nicht implementiert
- // Default-Schrifthoehe in logischen Einheiten
+ // If a new MapMode is set on the RefDevice (or similar)
+ void RefDeviceChanged(); // not yet implemented
+ // default font heigth in logical units
void SetDefaultFontHeight(sal_uIntPtr nVal);
sal_uIntPtr GetDefaultFontHeight() const { return nDefTextHgt; }
- // Default-Tabulatorweite fuer die EditEngine
+ // default tabulator width for the EditEngine
void SetDefaultTabulator(sal_uInt16 nVal);
sal_uInt16 GetDefaultTabulator() const { return nDefaultTabulator; }
- // Der DefaultStyleSheet wird jedem Zeichenobjekt verbraten das in diesem
- // Model eingefuegt wird und kein StyleSheet gesetzt hat.
+ // The DefaultStyleSheet will be used in every symbol object which is inserted
+ // in this model and does not have a StyleSheet set.
SfxStyleSheet* GetDefaultStyleSheet() const { return pDefaultStyleSheet; }
void SetDefaultStyleSheet(SfxStyleSheet* pDefSS) { pDefaultStyleSheet = pDefSS; }
@@ -361,9 +360,9 @@ public:
void ClearPersist() { m_pEmbeddedHelper = 0; }
void SetPersist( ::comphelper::IEmbeddedHelper *p ) { m_pEmbeddedHelper = p; }
- // Masseinheit fuer die Zeichenkoordinaten.
- // Default ist 1 logische Einheit = 1/100mm (Unit=MAP_100TH_MM, Fract=(1,1)).
- // Beispiele:
+ // Unit for the symbol coordination
+ // Default is 1 logical unit = 1/100mm (Unit=MAP_100TH_MM, Fract=(1,1)).
+ // Examples:
// MAP_POINT, Fraction(72,1) : 1 log Einh = 72 Point = 1 Inch
// MAP_POINT, Fraction(1,20) : 1 log Einh = 1/20 Point = 1 Twip
// MAP_TWIP, Fraction(1,1) : 1 log Einh = 1 Twip
@@ -371,28 +370,27 @@ public:
// MAP_MM, Fraction(1000,1) : 1 log Einh = 1000mm = 1m
// MAP_CM, Fraction(100,1) : 1 log Einh = 100cm = 1m
// MAP_CM, Fraction(100000,1): 1 log Einh = 100000cm = 1km
- // (PS: Lichtjahre sind somit also nicht darstellbar).
- // Die Skalierungseinheit wird benoetigt, damit die Engine das Clipboard
- // mit den richtigen Groessen beliefern kann.
+ // (FWIW: you cannot represent light years).
+ // The scaling unit is needed for the Engine to serve the Clipboard
+ // with the correct sizes.
MapUnit GetScaleUnit() const { return eObjUnit; }
void SetScaleUnit(MapUnit eMap);
const Fraction& GetScaleFraction() const { return aObjUnit; }
void SetScaleFraction(const Fraction& rFrac);
- // Beides gleichzeitig setzen ist etwas performanter
+ // Setting both simultaneously performs a little better
void SetScaleUnit(MapUnit eMap, const Fraction& rFrac);
- // Maximale Groesse z.B. fuer Autogrowing-Texte
+ // maximal size e.g. for auto growing texts
const Size& GetMaxObjSize() const { return aMaxObjSize; }
void SetMaxObjSize(const Size& rSiz) { aMaxObjSize=rSiz; }
- // Damit die View! in der Statuszeile vernuenftige Zahlen anzeigen kann:
- // Default ist mm.
+ // For the View! to display sane numbers in the status bar: Default is mm.
void SetUIUnit(FieldUnit eUnit);
FieldUnit GetUIUnit() const { return eUIUnit; }
- // Der Masstab der Zeichnung. Default 1/1.
+ // The scale of the drawing. Default 1/1.
void SetUIScale(const Fraction& rScale);
const Fraction& GetUIScale() const { return aUIScale; }
- // Beides gleichzeitig setzen ist etwas performanter
+ // Setting both simultaneously performs a little better
void SetUIUnit(FieldUnit eUnit, const Fraction& rScale);
const Fraction& GetUIUnitFact() const { return aUIUnitFact; }
@@ -405,14 +403,14 @@ public:
void TakeWinkStr(long nWink, OUString& rStr, bool bNoDegChar = false) const;
void TakePercentStr(const Fraction& rVal, OUString& rStr, bool bNoPercentChar = false) const;
- // RecalcPageNums wird idR. nur von der Page gerufen.
+ // RecalcPageNums is ordinarily only called by the Page.
bool IsPagNumsDirty() const { return bPagNumsDirty; };
bool IsMPgNumsDirty() const { return bMPgNumsDirty; };
void RecalcPageNums(bool bMaster);
- // Nach dem Insert gehoert die Page dem SdrModel.
+ // After the Insert the Page belongs to the SdrModel.
virtual void InsertPage(SdrPage* pPage, sal_uInt16 nPos=0xFFFF);
virtual void DeletePage(sal_uInt16 nPgNum);
- // Remove bedeutet Eigentumsuebereignung an den Aufrufer (Gegenteil von Insert)
+ // Remove means transferring ownership to the caller (opposite of Insert)
virtual SdrPage* RemovePage(sal_uInt16 nPgNum);
virtual void MovePage(sal_uInt16 nPgNum, sal_uInt16 nNewPos);
const SdrPage* GetPage(sal_uInt16 nPgNum) const;
@@ -424,7 +422,7 @@ public:
// Masterpages
virtual void InsertMasterPage(SdrPage* pPage, sal_uInt16 nPos=0xFFFF);
virtual void DeleteMasterPage(sal_uInt16 nPgNum);
- // Remove bedeutet Eigentumsuebereignung an den Aufrufer (Gegenteil von Insert)
+ // Remove means transferring ownership to the caller (opposite of Insert)
virtual SdrPage* RemoveMasterPage(sal_uInt16 nPgNum);
virtual void MoveMasterPage(sal_uInt16 nPgNum, sal_uInt16 nNewPos);
const SdrPage* GetMasterPage(sal_uInt16 nPgNum) const;
@@ -433,47 +431,42 @@ public:
// #109538#
virtual void MasterPageListChanged();
- // Modified-Flag. Wird automatisch gesetzt, wenn an den Pages oder
- // Zeichenobjekten was geaendert wird. Zuruecksetzen muss man es
- // jedoch selbst (z.B. bei Save() ...).
+ // modified flag. Is set automatically when something changes on the Pages
+ // symbol objects. You need to reset it yourself, however, e.g. on Save().
bool IsChanged() const { return mbChanged; }
virtual void SetChanged(bool bFlg = true);
- // PageNotValid bedeutet, dass das Model lediglich Objekte traegt die zwar
- // auf einer Page verankert sind, die Page aber nicht gueltig ist. Diese
- // Kennzeichnung wird fuers Clipboard/Drag&Drop benoetigt.
+ // PageNotValid means that the model carries objects which are
+ // anchored on a Page but the Page is invalid. This mark is needed for
+ // Clipboard/Drag&Drop.
bool IsPageNotValid() const { return bPageNotValid; }
void SetPageNotValid(bool bJa = true) { bPageNotValid=bJa; }
- // Schaltet man dieses Flag auf sal_True, so werden Grafikobjekte
- // portabel gespeichert. Es findet dann beim Speichern ggf.
- // eine implizite Wandlung von Metafiles statt.
- // Default=FALSE. Flag ist nicht persistent.
+ // Setting this flag to sal_True, graphic objects are saved
+ // portably. Meta files will eventually implicitly changed, i.e. during save.
+ // Default=FALSE. Flag is not persistent.
bool IsSavePortable() const { return bSavePortable; }
void SetSavePortable(bool bJa = true) { bSavePortable=bJa; }
- // Schaltet man dieses Flag auf sal_True, so werden
- // Pixelobjekte (stark) komprimiert gespeichert.
- // Default=FALSE. Flag ist nicht persistent.
+ // If you set this flag to sal_True, the
+ // pixel objects will be saved (heavily) compressed.
+ // Default=FALSE. Flag is not persistent.
bool IsSaveCompressed() const { return bSaveCompressed; }
void SetSaveCompressed(bool bJa = true) { bSaveCompressed=bJa; }
- // Schaltet man dieses Flag auf sal_True, so werden
- // Grafikobjekte mit gesetztem Native-Link
- // native gespeichert.
- // Default=FALSE. Flag ist nicht persistent.
+ // If true, graphic objects with set Native-Link
+ // native will be saved.
+ // Default=FALSE. Flag is not persistent.
bool IsSaveNative() const { return bSaveNative; }
void SetSaveNative(bool bJa = true) { bSaveNative=bJa; }
- // Schaltet man dieses Flag auf sal_True, so werden die Grafiken
- // von Grafikobjekten:
- // - beim Laden eines Dokuments nicht sofort mitgeladen,
- // sondern erst wenn sie gebraucht (z.B. angezeigt) werden.
- // - ggf. wieder aus dem Speicher geworfen, falls Sie gerade
- // nicht benoetigt werden.
- // Damit das funktioniert, muss die virtuelle Methode
- // GetDocumentStream() ueberladen werden.
- // Default=FALSE. Flag ist nicht persistent.
+ // If set to sal_True, graphics from graphics objects will:
+ // - not be loaded immediately when loading a document,
+ // but only once they are needed (e.g. displayed).
+ // - be pruned from memory if they are not needed.
+ // For that to work, the virtual method
+ // GetDocumentStream() needs to be overloaded.
+ // Default=FALSE. Flag is not persistent.
bool IsSwapGraphics() const { return bSwapGraphics; }
void SetSwapGraphics(bool bJa = true);
void SetSwapGraphicsMode(sal_uIntPtr nMode) { nSwapGraphicsMode = nMode; }
@@ -482,79 +475,76 @@ public:
bool IsSaveOLEPreview() const { return bSaveOLEPreview; }
void SetSaveOLEPreview( bool bSet) { bSaveOLEPreview = bSet; }
- // Damit die Bildschirmausgabe von Bitmaps (insbesondere bei gedrehten)
- // etwas schneller wird, werden sie gecachet. Diesen Cache kann man mit
- // diesem Flag ein-/ausschalten. Beim naechsten Paint wird an den Objekten
- // dann ggf. ein Image gemerkt bzw. freigegeben. Wandert ein Bitmapobjekt
- // in's Undo, so wird der Cache fuer dieses Objekt sofort ausgeschaltet
- // (Speicher sparen).
- // Default=Cache eingeschaltet. Flag ist nicht persistent.
+ // To accelarate the screen output of Bitmaps (especially rotated ones)
+ // they will be cached. The existence of that cache can be toggled with this
+ // flag. During the next Paint an image will be remembered or freed.
+ // If a Bitmap object is placed in Undo its Cache for this object is turned off
+ // immediately to save memory.
+ // Default=Cache activated. Flag is not persistent.
bool IsBitmapCaching() const { return !bNoBitmapCaching; }
void SetBitmapCaching(bool bJa = true) { bNoBitmapCaching=!bJa; }
- // Defaultmaessig (sal_False) kann man Textrahmen ohne Fuellung durch
- // Mausklick selektieren. Nach Aktivierung dieses Flags trifft man sie
- // nur noch in dem Bereich, wo sich auch tatsaechlich Text befindet.
+ // Text frames without filling can be select with a mouse click by default (sal_False).
+ // With this flag set to true you can hit them only in the area in which text is to be
+ // found.
bool IsPickThroughTransparentTextFrames() const { return bTransparentTextFrames; }
void SetPickThroughTransparentTextFrames(bool bOn) { bTransparentTextFrames=bOn; }
- // Darf denn das Model ueberhaupt veraendert werden?
- // Wird nur von den Possibility-Methoden der View ausgewerdet.
- // Direkte Manipulationen am Model, ... berueksichtigen dieses Flag nicht.
- // Sollte ueberladen werden und entsprechend des ReadOnly-Status des Files
- // sal_True oder sal_False liefern (Methode wird oeffters gerufen, also ein Flag
- // verwenden!).
+ // Can the model be changed at all?
+ // Is only evaluated by the possibility methods of the View.
+ // Direct manipulations on the model, ... do not respect this flag.
+ // Should be overloaded and return the appriopriate ReadOnly status
+ // of the files, i.e. sal_True or sal_False. (Method is called multiple
+ // times, so use one flag only!)
virtual bool IsReadOnly() const;
virtual void SetReadOnly(bool bYes);
- // Vermischen zweier SdrModel. Zu beachten sei, dass rSourceModel nicht
- // const ist. Die Pages werden beim einfuegen nicht kopiert, sondern gemoved.
- // rSourceModel ist anschliessend u.U. weitgehend leer.
- // nFirstPageNum,nLastPageNum: Die aus rSourceModel zu uebernehmenden Seiten
- // nDestPos..................: Einfuegeposition
- // bMergeMasterPages.........: sal_True =benoetigte MasterPages werden aus
- // rSourceModel ebenfalls uebernommen
- // sal_False=Die MasterPageDescriptoren der Seiten
- // aus rSourceModel werden auf die
- // vorhandenen MasterPages gemappt.
- // bUndo.....................: Fuer das Merging wird eine UndoAction generiert.
- // Undo ist nur fuer das ZielModel, nicht fuer
+ // Mixing two SdrModels. Mind that rSourceModel is not const.
+ // The pages will not be copied but moved, when inserted.
+ // rSourceModel may very well be empty afterwards.
+ // nFirstPageNum,nLastPageNum: The pages to take from rSourceModel
+ // nDestPos..................: position to insert
+ // bMergeMasterPages.........: sal_True = needed MasterPages will be taken
+ // from rSourceModel
+ // sal_False= the MasterPageDescriptors of
+ // the pages of the rSourceModel will be
+ // mapped on the exisiting MasterPages.
+ // bUndo.....................: An undo action is generated for the merging.
+ // Undo is only for the target model, not for the
// rSourceModel.
- // bTreadSourceAsConst.......: sal_True=Das SourceModel wird nicht veraendert,.
- // d.h die Seiten werden kopiert.
+ // bTreadSourceAsConst.......: sal_True=the SourceModel will not be changed,
+ // so pages will be copied.
virtual void Merge(SdrModel& rSourceModel,
sal_uInt16 nFirstPageNum=0, sal_uInt16 nLastPageNum=0xFFFF,
sal_uInt16 nDestPos=0xFFFF,
bool bMergeMasterPages = false, bool bAllMasterPages = false,
bool bUndo = true, bool bTreadSourceAsConst = false);
- // Ist wie Merge(SourceModel=DestModel,nFirst,nLast,nDest,sal_False,sal_False,bUndo,!bMoveNoCopy);
+ // Behaves like Merge(SourceModel=DestModel,nFirst,nLast,nDest,sal_False,sal_False,bUndo,!bMoveNoCopy);
void CopyPages(sal_uInt16 nFirstPageNum, sal_uInt16 nLastPageNum,
sal_uInt16 nDestPos,
bool bUndo = true, bool bMoveNoCopy = false);
- // Mit BegUndo() / EndUndo() ist es moeglich beliebig viele UndoActions
- // beliebig tief zu klammern. Als Kommentar der
- // UndoAction wird der des ersten BegUndo(String) aller Klammerungen
- // verwendet. Der NotifyUndoActionHdl wird in diesem Fall erst beim letzten
- // EndUndo() gerufen. Bei einer leeren Klammerung wird keine UndoAction
- // generiert.
- // Alle direkten Aktionen am SdrModel erzeugen keine UndoActions, die
- // Aktionen an der SdrView dagegen generieren solche.
- void BegUndo(); // Undo-Klammerung auf
- void BegUndo(const OUString& rComment); // Undo-Klammerung auf
- void BegUndo(const OUString& rComment, const OUString& rObjDescr, SdrRepeatFunc eFunc=SDRREPFUNC_OBJ_NONE); // Undo-Klammerung auf
- void EndUndo(); // Undo-Klammerung zu
+ // BegUndo() / EndUndo() enables you to group arbitrarily many UndoActions
+ // arbitrarily deeply. As comment for the UndoAction the first BegUndo(String) of all
+ // nestings will be used.
+ // In that case the NotifyUndoActionHdl will be called on the last EndUndo().
+ // No UndoAction will be generated for an empty group.
+ // All direct modifications on the SdrModel do not create an UndoActions.
+ // Actions on the SdrView however do generate those.
+ void BegUndo(); // open Undo group
+ void BegUndo(const OUString& rComment); // open Undo group
+ void BegUndo(const OUString& rComment, const OUString& rObjDescr, SdrRepeatFunc eFunc=SDRREPFUNC_OBJ_NONE); // open Undo group
+ void EndUndo(); // close Undo group
void AddUndo(SdrUndoAction* pUndo);
sal_uInt16 GetUndoBracketLevel() const { return nUndoLevel; }
const SdrUndoGroup* GetAktUndoGroup() const { return pAktUndoGroup; }
- // nur nach dem 1. BegUndo oder vor dem letzten EndUndo:
+ // only after the first BegUndo or before the last EndUndo:
void SetUndoComment(const OUString& rComment);
void SetUndoComment(const OUString& rComment, const OUString& rObjDescr);
- // Das Undo-Management findet nur statt, wenn kein NotifyUndoAction-Handler
- // gesetzt ist.
- // Default ist 16. Minimaler MaxUndoActionCount ist 1!
+ // The Undo management is only done if not NotifyUndoAction-Handler is set.
+ // Default is 16. Minimal MaxUndoActionCount is 1!
void SetMaxUndoActionCount(sal_uIntPtr nAnz);
sal_uIntPtr GetMaxUndoActionCount() const { return nMaxUndoCount; }
void ClearUndoBuffer();
@@ -565,15 +555,15 @@ public:
bool Redo();
bool Repeat(SfxRepeatTarget&);
- // Hier kann die Applikation einen Handler setzen, der die auflaufenden
- // UndoActions einsammelt. Der Handler hat folgendes Aussehen:
+ // The application can set a handler here which collects the UndoActions einsammelt.
+ // The handler has the following signature:
// void NotifyUndoActionHdl(SfxUndoAction* pUndoAction);
- // Beim Aufruf des Handlers findet eine Eigentumsuebereignung statt; die
- // UndoAction gehoert somit dem Handler, nicht mehr dem SdrModel.
+ // When calling the handler ownership is transferred;
+ // The UndoAction belongs to the Handler, not the SdrModel.
void SetNotifyUndoActionHdl(const Link& rLink) { aUndoLink=rLink; }
const Link& GetNotifyUndoActionHdl() const { return aUndoLink; }
- /** application can set it's own undo manager, BegUndo, EndUndo and AddUndoAction
+ /** application can set its own undo manager, BegUndo, EndUndo and AddUndoAction
calls are routet to this interface if given */
void SetSdrUndoManager( SfxUndoManager* pUndoManager );
SfxUndoManager* GetSdrUndoManager() const;
@@ -587,16 +577,16 @@ public:
undo actions for this model. */
SdrUndoFactory& GetSdrUndoFactory() const;
- // Hier kann man einen Handler setzen der beim Streamen mehrfach gerufen
- // wird und ungefaehre Auskunft ueber den Fortschreitungszustand der
- // Funktion gibt. Der Handler muss folgendes Aussehen haben:
+ // You can set a handler which will be called multiple times while
+ // streaming and which estimates the progress of the function.
+ // The handler needs to have this signature:
// void class::IOProgressHdl(const USHORT& nPercent);
- // Der erste Aufruf des Handlers erfolgt grundsaetzlich mit 0, der letzte
- // mit 100. Dazwischen erfolgen maximal 99 Aufrufe mit Werten 1...99.
- // Man kann also durchaus bei 0 den Progressbar Initiallisieren und bei
- // 100 wieder schliessen. Zu beachten sei, dass der Handler auch gerufen
- // wird, wenn die App Draw-Daten im officeweiten Draw-Exchange-Format
- // bereitstellt, denn dies geschieht durch streamen in einen MemoryStream.
+ // The first call of the handler will be with 0. The last call with 100.
+ // In between there will at most be 99 calls with 1..99.
+ // You can thus initialise the progres bar with 0 and close it on 100.
+ // Mind that the handler will also be called if the App serves Draw data in the
+ // office wide Draw-Exchange-Format because that happens through streaming into
+ // a MemoryStream.
void SetIOProgressHdl(const Link& rLink) { aIOProgressLink=rLink; }
const Link& GetIOProgressHdl() const { return aIOProgressLink; }
@@ -613,8 +603,8 @@ public:
XLineEndListRef GetLineEndList() const { return GetPropertyList( XLINE_END_LIST )->AsLineEndList(); }
XGradientListRef GetGradientList() const { return GetPropertyList( XGRADIENT_LIST )->AsGradientList(); }
- // Der StyleSheetPool wird der DrawingEngine nur bekanntgemacht.
- // Zu loeschen hat ihn schliesslich der, der ihn auch konstruiert hat.
+ // The DrawingEngine only references the StyleSheetPool, whoever
+ // made it needs to delete it.
SfxStyleSheetBasePool* GetStyleSheetPool() const { return mxStyleSheetPool.get(); }
void SetStyleSheetPool(SfxStyleSheetBasePool* pPool) { mxStyleSheetPool=pPool; }
More information about the Libreoffice-commits
mailing list