[Libreoffice-commits] .: sw/inc
Christoph Herzog
cherzog at kemper.freedesktop.org
Mon Apr 25 11:34:27 PDT 2011
sw/inc/swtypes.hxx | 231 ++++++++++++++++++++++++----------------------------
sw/inc/tabcol.hxx | 29 +++---
sw/inc/tblafmt.hxx | 26 ++---
sw/inc/tblenum.hxx | 30 +++---
sw/inc/tblsel.hxx | 75 ++++++++--------
sw/inc/tox.hxx | 2
sw/inc/txatbase.hxx | 2
sw/inc/txtatr.hxx | 7 -
sw/inc/txtflcnt.hxx | 6 -
9 files changed, 192 insertions(+), 216 deletions(-)
New commits:
commit a0fb683e910d269aa1c5312106e118154a74a1e1
Author: Christoph Herzog <rhogez at googlemail.com>
Date: Mon Apr 25 20:33:33 2011 +0200
Translation of German comments.
diff --git a/sw/inc/swtypes.hxx b/sw/inc/swtypes.hxx
index efcb2dc..a820e85 100644
--- a/sw/inc/swtypes.hxx
+++ b/sw/inc/swtypes.hxx
@@ -31,7 +31,7 @@
#include <SwGetPoolIdFromName.hxx>
#ifndef INCLUDED_LIMITS_H
-#include <limits.h> //fuer LONG_MAX
+#include <limits.h> //For LONG_MAX.
#define INCLUDED_LIMITS_H
#endif
@@ -69,74 +69,72 @@ typedef long SwTwips;
#define INVALID_TWIPS LONG_MAX
#define TWIPS_MAX (LONG_MAX - 1)
-#define MM50 283 // 1/2 cm in TWIPS
+#define MM50 283 // 1/2 cm in TWIPS.
const SwTwips cMinHdFtHeight = 56;
-#define MINFLY 23 //Minimalgroesse fuer FlyFrms
-#define MINLAY 23 //Minimalgroesse anderer Frms
+#define MINFLY 23 // Minimal size for FlyFrms.
+#define MINLAY 23 // Minimal size for other Frms.
-// Default-Spaltenabstand zweier Textspalten entspricht 0.3 cm
+// Default column distance of two text columns corresponds to 0.3 cm.
#define DEF_GUTTER_WIDTH (MM50 / 5 * 3)
-//Minimale Distance (Abstand zum Text) fuer das BorderAttribut, damit
-//die aligned'en Linien nicht geplaettet werden.
-//28 Twips == 0,4mm
+// Minimal distance (distance to text) for border attribute
+// in order not to crock up aligned lines.
+// 28 Twips == 0,4mm
#define MIN_BORDER_DIST 28
- /* minimaler Dokmentrand */
+// Minimal document border.
const SwTwips lMinBorder = 1134;
-//Die Wiesenbreite links neben und ueber dem Dokument.
-//Die halbe Wiesenbreite ist der Abstand zwischen den Seiten.
+// Margin left and above document.
+// Half of it is gap between the pages.
#define DOCUMENTBORDER 568L
#define GAPBETWEENPAGES 284L
-//initiale UndoActionCount
#define UNDO_ACTION_COUNT 20
-// Konstante Strings
-SW_DLLPUBLIC extern UniString aEmptyStr; // ""
-extern ByteString aEmptyByteStr; // ""
-SW_DLLPUBLIC extern UniString aDotStr; // '.'
+// Constant strings.
+SW_DLLPUBLIC extern UniString aEmptyStr; // ""
+extern ByteString aEmptyByteStr; // ""
+SW_DLLPUBLIC extern UniString aDotStr; // '.'
-//Zum Einfuegen von Beschriftungen (wie bzw. wo soll eingefuegt werden).
-//Hier weil ein eigenes hxx nicht lohnt und es sonst nirgendwo so recht
-//hinpasst.
+// For inserting of captions (what and where to insert).
+// It's here because it is not big enough to justify its own hxx
+// and does not seem to fit somewhere else.
enum SwLabelType
{
- LTYPE_TABLE, //Beschriftung einer Tabelle
- LTYPE_OBJECT, //Beschriftung von Grafik oder OLE
- LTYPE_FLY, //Beschriftung eines (Text-)Rahmens
- LTYPE_DRAW //Beschriftung eines Zeichen-Objektes
+ LTYPE_TABLE, // Caption for a table.
+ LTYPE_OBJECT, // Caption for a graphic or OLE.
+ LTYPE_FLY, // Caption for a text frame.
+ LTYPE_DRAW // Caption for a draw object.
};
const sal_uInt8 OLD_MAXLEVEL = 5;
-const sal_uInt8 MAXLEVEL = 10; //Ehemals numrule.hxx
-const sal_uInt8 NO_NUM = 200; //Ehemals numrule.hxx
+const sal_uInt8 MAXLEVEL = 10; // Was: numrule.hxx.
+const sal_uInt8 NO_NUM = 200; // Was: numrule.hxx.
-// fuer Absaetze mit NO_NUM aber auf unterschiedlichen Leveln
-// DAMIT entfaellt das NO_NUM !!!!
-const sal_uInt8 NO_NUMLEVEL = 0x20; // wird mit den Levels verodert
+// For paragraphs with NO_NUM but on different levels.
+// This makes the NO_NUM inapplicable.
+const sal_uInt8 NO_NUMLEVEL = 0x20; // "or" with the levels.
-/*
- * Nette Funktionen als MACRO oder inline
- */
-/* ein KiloByte sind 1024 Byte */
+// Some helper functions as macros or inlines.
+
+// One kilobyte is 1024 bytes:
#define KB 1024
#define SET_CURR_SHELL( shell ) CurrShell aCurr( shell )
-// pPathFinder wird von der UI initialisiert. Die Klasse liefert alle
-// benoetigten Pfade.
+// pPathFinder is initialized by the UI.
+// The class delivers all paths needed.
extern SwPathFinder *pPathFinder;
-// Werte fuer die Einzuege an der Nummerierung und BulletListe
-// (fuer die weiteren Ebenen sind die Werte mit den Ebenen+1 zu
-// multiplizieren; Ebenen 0..4 !!!)
+// Values for indents at numbering and bullet lists.
+// (For more levels the values have to be multiplied with the levels+1;
+// levels 0 ..4!)
const sal_uInt16 lBullIndent = 1440/4;
const short lBullFirstLineOffset = -lBullIndent;
@@ -144,23 +142,24 @@ const sal_uInt16 lNumIndent = 1440/4;
const short lNumFirstLineOffset = -lNumIndent;
const short lOutlineMinTextDistance = 216; // 0.15 inch = 0.38 cm
-// Anzahl der SystemField-Types vom SwDoc
+// Count of SystemField-types of SwDoc.
#define INIT_FLDTYPES 32
-// Anzahl der vordefinierten Seq-Feldtypen. Es handelt sich dabei
-// immer um die letzen Felder vor INIT_FLDTYPES
+
+// Count of predefined Seq-field types. It is always the last
+// fields before INIT_FLDTYPES.
#define INIT_SEQ_FLDTYPES 4
-//Die ehemaligen Rendevouz-Ids leben weiter:
-//Es gibt Ids fuer die Anker (SwFmtAnchor) und ein paar weitere die nur fuer
-//Schnittstellen Bedeutung haben (SwDoc).
+// The former Rendevouz-IDs live on:
+// There are IDs for the anchors (SwFmtAnchor) and some others
+// that are only of importance for interfaces (SwDoc).
enum RndStdIds
{
- FLY_AT_PARA, // anchored at paragraph
- FLY_AS_CHAR, // anchored as character
- FLY_AT_PAGE, // anchored at page
- FLY_AT_FLY, // anchored at frame
- FLY_AT_CHAR, // anchored at character
- //Der Rest wird nur fuer SS benutzt.
+ FLY_AT_PARA, // Anchored at paragraph.
+ FLY_AS_CHAR, // Anchored as character.
+ FLY_AT_PAGE, // Anchored at page.
+ FLY_AT_FLY, // Anchored at frame.
+ FLY_AT_CHAR, // Anchored at character.
+
RND_STD_HEADER,
RND_STD_FOOTER,
RND_STD_HEADERL,
@@ -168,11 +167,11 @@ enum RndStdIds
RND_STD_FOOTERL,
RND_STD_FOOTERR,
- RND_DRAW_OBJECT // ein Draw-Object !! nur fuer die SwDoc-Schnittstelle!
+ RND_DRAW_OBJECT // A draw-Object! For the SwDoc-interface only!
};
-extern ResMgr* pSwResMgr; // steht in swapp0.cxx
+extern ResMgr* pSwResMgr; // Is in swapp0.cxx.
#define SW_RES(i) ResId(i,*pSwResMgr)
#define SW_RESSTR(i) UniString(ResId(i,*pSwResMgr))
@@ -185,22 +184,22 @@ extern ResMgr* pSwResMgr; // steht in swapp0.cxx
::com::sun::star::uno::Reference<
::com::sun::star::beans::XPropertySet > GetLinguPropertySet();
-// reutns the twip size of this graphic
+// Returns the twip size of this graphic.
SW_DLLPUBLIC Size GetGraphicSizeTwip( const Graphic&, OutputDevice* pOutDev );
-// Seperator fuer Sprunge im Dokument auf verschiedene Inhalttype
+// Separator for jumps to different content types in document.
const sal_Unicode cMarkSeperator = '|';
-extern const sal_Char* pMarkToTable; // Strings stehen
-extern const sal_Char* pMarkToFrame; // im Init.cxx
+extern const sal_Char* pMarkToTable; // Strings are
+extern const sal_Char* pMarkToFrame; // in Init.cxx.
extern const sal_Char* pMarkToRegion;
SW_DLLPUBLIC extern const sal_Char* pMarkToOutline;
extern const sal_Char* pMarkToText;
extern const sal_Char* pMarkToGraphic;
extern const sal_Char* pMarkToOLE;
-#ifndef DB_DELIM // Ist in OFA definiert!!!
-#define DB_DELIM ((sal_Unicode)0xff) // Datenbank <-> Tabellen-Trenner
+#ifndef DB_DELIM // This is defined in OFA!
+#define DB_DELIM ((sal_Unicode)0xff) // Database <-> table separator.
#endif
@@ -208,23 +207,23 @@ typedef sal_uInt16 SetAttrMode;
namespace nsSetAttrMode
{
- const SetAttrMode SETATTR_DEFAULT = 0x0000; // default
- const SetAttrMode SETATTR_DONTEXPAND = 0x0001; // TextAttribute nicht weiter expand.
- const SetAttrMode SETATTR_DONTREPLACE = 0x0002; // kein anderes TextAttrib verdraengen
-
- const SetAttrMode SETATTR_NOTXTATRCHR = 0x0004; // bei Attr ohne Ende kein 0xFF einfuegen
- const SetAttrMode SETATTR_NOHINTADJUST = 0x0008; // keine Zusammenfassung von Bereichen.
- const SetAttrMode SETATTR_NOFORMATATTR = 0x0010; // nicht zum FormatAttribut umwandeln
- const SetAttrMode SETATTR_DONTCHGNUMRULE = 0x0020; // nicht die NumRule veraendern
- const SetAttrMode SETATTR_APICALL = 0x0040; // called from API (all UI related
- // functionality will be disabled)
- /// force hint expand (only matters for hints with CH_TXTATR)
+ const SetAttrMode SETATTR_DEFAULT = 0x0000; // Default.
+ const SetAttrMode SETATTR_DONTEXPAND = 0x0001; // Don't expand text attribute any further.
+ const SetAttrMode SETATTR_DONTREPLACE = 0x0002; // Don't replace another text attribute.
+
+ const SetAttrMode SETATTR_NOTXTATRCHR = 0x0004; // Don't insert 0xFF at attributes with no end.
+ const SetAttrMode SETATTR_NOHINTADJUST = 0x0008; // No merging of ranges.
+ const SetAttrMode SETATTR_NOFORMATATTR = 0x0010; // Do not change into format attribute.
+ const SetAttrMode SETATTR_DONTCHGNUMRULE = 0x0020; // Do not change NumRule.
+ const SetAttrMode SETATTR_APICALL = 0x0040; // Called from API (all UI related
+ // functionality will be disabled).
+ /// Force hint expand (only matters for hints with CH_TXTATR).
const SetAttrMode SETATTR_FORCEHINTEXPAND= 0x0080;
- /// the inserted item is a copy -- intended for use in ndtxt.cxx
+ /// The inserted item is a copy -- intended for use in ndtxt.cxx.
const SetAttrMode SETATTR_IS_COPY = 0x0100;
}
-//Umrechnung Twip<-> 1/100 mm fuer UNO
+// Conversion Twip <-> 1/100 mm for UNO
#define TWIP_TO_MM100(TWIP) ((TWIP) >= 0 ? (((TWIP)*127L+36L)/72L) : (((TWIP)*127L-36L)/72L))
#define MM100_TO_TWIP(MM100) ((MM100) >= 0 ? (((MM100)*72L+63L)/127L) : (((MM100)*72L-63L)/127L))
@@ -250,7 +249,7 @@ namespace nsSetAttrMode
#define CHAR_ZWNBSP ((sal_Unicode)0x2060)
-// returns the APP - CharClass instance - used for all ToUpper/ToLower/...
+// Returns the APP - CharClass instance - used for all ToUpper/ToLower/...
SW_DLLPUBLIC CharClass& GetAppCharClass();
SW_DLLPUBLIC LanguageType GetAppLanguage();
@@ -271,60 +270,50 @@ SW_DLLPUBLIC CollatorWrapper& GetAppCaseCollator();
SW_DLLPUBLIC const ::utl::TransliterationWrapper& GetAppCmpStrIgnore();
-//fuer Prepare() zur Benachrichtigung des Inhaltes durch das Layout auf
-//dem kurzen Dienstweg.
-//Der Inhalt sorgt dafuer, dass beim naechsten Aufruf von ::Format() das
-//minimal notwendige berechnet wird.
+// Official shortcut for Prepare() regarding notification of Content by the Layout.
+// Content provides for calculation of minimal requirements at the next call of ::Format().
enum PrepareHint
{
- PREP_BEGIN, //BEGIN
- PREP_CLEAR = PREP_BEGIN,//Komplett neuformatieren.
- PREP_WIDOWS_ORPHANS, //Nur Witwen- und Waisen-Regelung pruefen und ggf.
- //Aufspalten.
- PREP_FIXSIZE_CHG, //Die FixSize hat sich veraendert.
- PREP_FOLLOW_FOLLOWS, //Follow ist jetzt moeglicherweise direkter
- //Nachbar.
- PREP_ADJUST_FRM, //Groesse per Grow/Shrink Ausrichten ohne zu
- //Formatieren.
- PREP_FLY_CHGD, //Ein FlyFrm hat sich (Groesse) veraendert.
- PREP_FLY_ATTR_CHG, //Ein FlyFrm hat seine Attribute veraendert
- //(z.B. Umlauf)
- PREP_FLY_ARRIVE, //Ein FlyFrm ueberlappt den Bereich jetzt neu.
- PREP_FLY_LEAVE, //Ein FlyFrm hat den Bereich verlassen.
- PREP_FTN, //Fussnoten-Invalidierung
- PREP_POS_CHGD, //Position des Frm hat sich verandert
- //(Zum Fly-Umbruch pruefen). Im void* des Prepare()
- //wird ein sal_Bool& uebergeben, dieser zeigt mit sal_True,
- //dass ein Format ausgefuehrt wurde.
- PREP_UL_SPACE, //UL-Space hat sich veraendert, TxtFrms muessen
- //den Zeilenabstand neu kalkulieren.
- PREP_MUST_FIT, //Frm passen machen (aufspalten) auch wenn die
- //Attribute es nicht erlauben (z.B. zusammenhalten).
- PREP_WIDOWS, // Ein Follow stellt fest, dass in ihm die Orphans-
- // regel zuschlaegt und verschickt an seinen
- // Vorgaenger (Master/Follow) ein PREP_WIDOWS
- PREP_QUOVADIS, // Wenn eine Fussnote _zwischen_ zwei Absaetzen
- // aufgespalten werden muss, dann muss der
- // letzte auf der Seite noch ein QUOVADIS bekommen
- // damit er den Text hineinformatiert.
- PREP_BOSS_CHGD, // Wenn ein Frm die Spalte/Seite wechselt, wird dieses
- // Zusatzprepare zum POS_CHGD im MoveFwd/Bwd
- // verschickt (Ftn-Nummern joinen etc.)
- // Die Richtung wird ueber pVoid mitgeteilt:
+ PREP_BEGIN, // BEGIN.
+ PREP_CLEAR = PREP_BEGIN,// Reformat completely.
+ PREP_WIDOWS_ORPHANS, // Only check for widows and orphans and split in case of need.
+ PREP_FIXSIZE_CHG, // FixSize has changed.
+ PREP_FOLLOW_FOLLOWS, // Follow is now possibly adjacent.
+ PREP_ADJUST_FRM, // Adjust size via grow/shrink without formating.
+ PREP_FLY_CHGD, // A FlyFrm has changed its size.
+ PREP_FLY_ATTR_CHG, // A FlyFrm hat has changed its attributes
+ // (e. g. wrap).
+ PREP_FLY_ARRIVE, // A FlyFrm now overlaps range.
+ PREP_FLY_LEAVE, // A FlyFrm has left range.
+ PREP_FTN, // Invalidation of footnotes.
+ PREP_POS_CHGD, // Position of Frm has changed.
+ // (Check for Fly-break). In void* of Prepare()
+ // a sal_Bool& is passed. If this is sal_True,
+ // it indicateds that a format has been executed.
+ PREP_UL_SPACE, // UL-Space has changed, TxtFrms have to
+ // re-calculate line space.
+ PREP_MUST_FIT, // Make frm fit (split) even if the attributes do
+ // not allow that (e.g. "keep together").
+ PREP_WIDOWS, // A follow realizes that the orphan rule will be applied
+ // for it and sends a PREP_WIDOWS to its predecessor
+ // (Master/Follow).
+ PREP_QUOVADIS, // If a footnote has to be split between two paragraphs
+ // the last on the page has to receive a QUOVADIS in or-
+ // der to format the text into it.
+ PREP_BOSS_CHGD, // If a Frm changes its column/page this additional
+ // Prepare is sended to POS_CHGD in MoveFwd/Bwd
+ // (join Ftn-numbers etc.)
+ // Direction is communicated via pVoid:
// MoveFwd: pVoid == 0
// MoveBwd: pVoid == pOldPage
- PREP_SWAP, //Grafiken Swappen, fuer Grafiken im sichtbaren
- //Bereich.
- PREP_REGISTER, //Registerhaltige Frames invalidieren
- PREP_FTN_GONE, //Ein Follow verliert eine Fussnote, ggf. kann seine erste
- //Zeile hochrutschen
- PREP_MOVEFTN, //eine Fussnote wechselt die Seite, der Inhalt bekommt
- //zunaechst eine Hoehe von Null, damit nicht zuviel
- //Unruhe entsteht. Beim Formatieren prueft er, ob er
- //ueberhaupt passt und wechselt ggf. unbemerkt wieder
- //die Seite.
- PREP_ERGOSUM, //wg. Bewegung in FtnFrms QuoVadis/ErgoSum pruefen
- PREP_END //END
+ PREP_SWAP, // Swap graphic; for graphics in visible area.
+ PREP_REGISTER, // Invalidate frames with registers.
+ PREP_FTN_GONE, // A Follow loses its footnote, possibly its first line can move up.
+ PREP_MOVEFTN, // A footnote changes its page. Its contents receives at first a
+ // height of zero in order to avoid too much noise. At formating
+ // it checks whether it fits and if necessary changes its page again.
+ PREP_ERGOSUM, // Needed because of movement in FtnFrms. Check QuoVadis/ErgoSum.
+ PREP_END // END.
};
#endif
diff --git a/sw/inc/tabcol.hxx b/sw/inc/tabcol.hxx
index bc9e8b9..c873cba 100644
--- a/sw/inc/tabcol.hxx
+++ b/sw/inc/tabcol.hxx
@@ -41,31 +41,30 @@ struct SwTabColsEntry
long nPos;
long nMin;
long nMax;
- sal_Bool bHidden; //Fuer jeden Eintrag ein Flag, Hidden oder nicht.
- //Wenn das Flag Hidden sal_True ist liegt der Spalten-
- //trenner nicht in der aktuellen Zeile; er muss
- //mit gepflegt werden, darf aber nicht angezeigt
- //werden.
+ sal_Bool bHidden; // For each entry a flag, hidden or not.
+ // If the flag bHidden is sal_True column separator
+ // is not in current line. It must maintained
+ // but it may not be displayed.
};
typedef std::vector< SwTabColsEntry > SwTabColsEntries;
class SW_DLLPUBLIC SwTabCols
{
- long nLeftMin, //Linker aeusserer Rand (Bezugspunkt) in
- //Dokumentkordinaten.
- //Alle anderen Werte relativ zu diesem Punkt!
- nLeft, //Linker Rand der Tabelle.
- nRight, //Rechter Rand der Tabelle.
- nRightMax; //Maximaler rechter Rand der Tabelle.
-
- bool bLastRowAllowedToChange; // if the last row of the table frame
+ long nLeftMin, // Leftmost border (reference point) for
+ // document coordinates.
+ // All other values are relative to this point!
+ nLeft, // Left border of table.
+ nRight, // Right border of table.
+ nRightMax; // Maximum right border of table.
+
+ bool bLastRowAllowedToChange; // If the last row of the table frame
// is split across pages, it may not
- // change its size
+ // change its size.
SwTabColsEntries aData;
- //fuer den CopyCTor
+ //For the CopyCTor.
const SwTabColsEntries& GetData() const { return aData; }
public:
diff --git a/sw/inc/tblafmt.hxx b/sw/inc/tblafmt.hxx
index 69829db..7e091d8 100644
--- a/sw/inc/tblafmt.hxx
+++ b/sw/inc/tblafmt.hxx
@@ -30,15 +30,7 @@
/*************************************************************************
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-
-
- Die akt. Struktur der Autoformatierung darf nicht mehr veraendert werden.
- Diese wird durch unterschiedlichen Code vom StartWriter und vom StarCalc
- eingelesen/geschrieben.
- Sollte sich doch mal eine Aenderung nicht vermeiden lassen, dann auf
- jedenfall in beiden Applikationen aendern.
-
- The structure of table auto formatting should not changed. It is used
+ The structure of table auto formatting should not be changed. It is used
by different code of Writer and Calc. If a change is necessary, the
source code of both applications must be changed!
@@ -46,7 +38,7 @@
**************************************************************************/
#include <svl/svarray.hxx>
-#include "hintids.hxx" //_immmer_ vor den solar-items!
+#include "hintids.hxx" // _Always_ before the solar-items!
#include <svx/algitem.hxx>
#include <editeng/fontitem.hxx>
#include <editeng/fhgtitem.hxx>
@@ -124,7 +116,7 @@ public:
int operator==( const SwBoxAutoFmt& rCmp ) const;
SwBoxAutoFmt& operator=( const SwBoxAutoFmt& rNew );
- // die Get-Methoden
+ // The get-methods.
const SvxFontItem &GetFont() const { return aFont; }
const SvxFontHeightItem &GetHeight() const { return aHeight; }
const SvxWeightItem &GetWeight() const { return aWeight; }
@@ -151,7 +143,7 @@ public:
void GetValueFormat( String& rFmt, LanguageType& rLng, LanguageType& rSys ) const
{ rFmt = sNumFmtString; rLng = eNumFmtLanguage; rSys = eSysLanguage; }
- // die SetMethoden
+ // The set-methods.
void SetFont( const SvxFontItem& rNew ) { aFont = rNew; }
void SetHeight( const SvxFontHeightItem& rNew ) { aHeight = rNew; }
void SetWeight( const SvxWeightItem& rNew ) { aWeight = rNew; }
@@ -186,27 +178,27 @@ public:
sal_Bool SaveVerionNo( SvStream& rStream ) const;
#ifdef READ_OLDVERS
- // lade alte Version
+ // load old version.
sal_Bool LoadOld( SvStream& rStream, sal_uInt16 aLoadVer[] );
#endif
};
class SW_DLLPUBLIC SwTableAutoFmt
{
- friend void _FinitCore(); // zum Zerstoeren des dflt. Pointers
+ friend void _FinitCore(); // To destroy dflt. pointer.
static SwBoxAutoFmt* pDfltBoxAutoFmt;
String aName;
sal_uInt16 nStrResId;
- // common flags of Calc and Writer
+ // Common flags of Calc and Writer.
sal_Bool bInclFont : 1;
sal_Bool bInclJustify : 1;
sal_Bool bInclFrame : 1;
sal_Bool bInclBackground : 1;
sal_Bool bInclValueFormat : 1;
- // Calc specific flags
+ // Calc specific flags.
sal_Bool bInclWidthHeight : 1;
SwBoxAutoFmt* aBoxAutoFmt[ 16 ];
@@ -247,7 +239,7 @@ public:
sal_Bool Save( SvStream& rStream ) const;
#ifdef READ_OLDVERS
- // load old versions
+ // Load old versions.
sal_Bool LoadOld( SvStream& rStream, sal_uInt16 aLoadVer[] );
#endif
};
diff --git a/sw/inc/tblenum.hxx b/sw/inc/tblenum.hxx
index 7fbe46c..ecd5b14 100644
--- a/sw/inc/tblenum.hxx
+++ b/sw/inc/tblenum.hxx
@@ -28,7 +28,8 @@
#ifndef _TBLENUM_HXX
#define _TBLENUM_HXX
-//fuers aendern der Tabellen/Spalten/Zeilen Breiten/Hoehen
+
+// For changing table columns/rows widths/heights.
typedef sal_uInt16 TblChgWidthHeightType;
namespace nsTblChgWidthHeightType
@@ -43,30 +44,29 @@ namespace nsTblChgWidthHeightType
const TblChgWidthHeightType WH_CELL_BOTTOM = 7;
- // folgende koennen hinein verodert werden
- const TblChgWidthHeightType WH_FLAG_INSDEL = 0x4000; // Insert/Del-Modus: das Bigger-Flag
- // besagt was passiert:
- // bBigger -> Box wird entfernt
- // !bBigger-> Box wird eingefuegt
- const TblChgWidthHeightType WH_FLAG_BIGGER = 0x8000; // Box wird groesser -> sonst kleiner
+ // The following can "or"ed into.
+ const TblChgWidthHeightType WH_FLAG_INSDEL = 0x4000; // Insert/Del-mode: the Bigger-Flag
+ // tells what happens:
+ // bBigger -> box gets removed.
+ // !bBigger-> box gets inserted.
+ const TblChgWidthHeightType WH_FLAG_BIGGER = 0x8000; // Box becomes larger -> else smaller.
}
enum TblChgMode
{
- TBLFIX_CHGABS, // Tabelle feste Breite, den Nachbar andern
- TBLFIX_CHGPROP, // Tabelle feste Breite, alle Nachbarn aendern
- TBLVAR_CHGABS // Tabelle variable, alle Nachbarn aendern
+ TBLFIX_CHGABS, // Table fixed width, change neighbour.
+ TBLFIX_CHGPROP, // Table fixed width, change all neighbours.
+ TBLVAR_CHGABS // Table variable, change all neighbours.
};
enum SplitTbl_HeadlineOption
{
- HEADLINE_NONE = 0, // lasse alles wie es ist
+ HEADLINE_NONE = 0, // Leave everything in place.
HEADLINE_BORDERCOPY, // von der davor obere Line der vorhergehen Line
- HEADLINE_CNTNTCOPY, // kopiere die 1. Line komplett mit Inhalt
- HEADLINE_BOXATTRCOPY, // kopiere von der 1. Line die Box Attribute
- HEADLINE_BOXATRCOLLCOPY // kopiere von der 1. Line die Box Attribute
- // und die Absatzvorlagen
+ HEADLINE_CNTNTCOPY, // Copy 1st line with all contents.
+ HEADLINE_BOXATTRCOPY, // Copy box attributs of 1st line.
+ HEADLINE_BOXATRCOLLCOPY // Copy box attributes and paragraph styles of 1st line.
};
enum TableMergeErr
diff --git a/sw/inc/tblsel.hxx b/sw/inc/tblsel.hxx
index 9c59cfb..037736e 100644
--- a/sw/inc/tblsel.hxx
+++ b/sw/inc/tblsel.hxx
@@ -51,21 +51,20 @@ SV_DECL_PTRARR( SwCellFrms, SwCellFrm*, 16, 16 )
SV_DECL_PTRARR_SORT( SwSelBoxes, SwTableBoxPtr, 10, 20 )
-//Sucht alle Boxen zusammen, die in der Tabelle selektiert sind.
-//Je nach enum-Parameter wird die Selektion in der angegebenen Richtung
-//erweitert.
-//Die Boxen werden ueber das Layout zusammengsucht, es wird auch bei
-//aufgespaltenen Tabellen korrekt gearbeitet (siehe: MakeSelUnions()).
+// Collects all boxes in table that are selected.
+// Selection gets extended in given direction according to enum-parameter.
+// Boxes are collected via the Layout; works correctly if tables are split.
+// (Cf. MakeSelUnions().)
typedef sal_uInt16 SwTblSearchType;
namespace nsSwTblSearchType
{
- const SwTblSearchType TBLSEARCH_NONE = 0x1; // keine Erweiterung
- const SwTblSearchType TBLSEARCH_ROW = 0x2; // erweiter auf Zeilen
- const SwTblSearchType TBLSEARCH_COL = 0x3; // erweiter auf Spalten
+ const SwTblSearchType TBLSEARCH_NONE = 0x1; // No extension.
+ const SwTblSearchType TBLSEARCH_ROW = 0x2; // Extend to rows.
+ const SwTblSearchType TBLSEARCH_COL = 0x3; // Extend to columns.
- // als Flag zu den anderen Werten!!
- const SwTblSearchType TBLSEARCH_PROTECT = 0x8; // auch geschuetzte Boxen einsammeln
- const SwTblSearchType TBLSEARCH_NO_UNION_CORRECT = 0x10; // die zusammenges. Union nicht korrigieren
+ // As flag to the other values!
+ const SwTblSearchType TBLSEARCH_PROTECT = 0x8; // Collect protected boxes too.
+ const SwTblSearchType TBLSEARCH_NO_UNION_CORRECT = 0x10; // Do not correct collected Union.
}
SW_DLLPUBLIC void GetTblSel( const SwCrsrShell& rShell, SwSelBoxes& rBoxes,
@@ -74,60 +73,58 @@ SW_DLLPUBLIC void GetTblSel( const SwCrsrShell& rShell, SwSelBoxes& rBoxes,
void GetTblSel( const SwCursor& rCrsr, SwSelBoxes& rBoxes,
const SwTblSearchType = nsSwTblSearchType::TBLSEARCH_NONE );
-//wie vor, jedoch wird nicht von der Selektion sondern von den
-//Start- EndFrms ausgegangen.
+
+// As before, but don't start from selection but from Start- EndFrms.
void GetTblSel( const SwLayoutFrm* pStart, const SwLayoutFrm* pEnd,
SwSelBoxes& rBoxes, SwCellFrms* pCells,
const SwTblSearchType = nsSwTblSearchType::TBLSEARCH_NONE );
-// Desgleichen nocheinmal direkt per PaM's
+// As before but directly via PaMs.
void GetTblSelCrs( const SwCrsrShell& rShell, SwSelBoxes& rBoxes );
void GetTblSelCrs( const SwTableCursor& rTblCrsr, SwSelBoxes& rBoxes );
-// suche fuer eine AutoSumme die beteiligten Boxen zusammen
+// Collect boxes relevant for auto sum.
sal_Bool GetAutoSumSel( const SwCrsrShell&, SwCellFrms& );
-// check if the SelBoxes contains protected Boxes
+// Check if the SelBoxes contains protected Boxes.
sal_Bool HasProtectedCells( const SwSelBoxes& rBoxes );
-// teste, ob die Selektion ausgeglichen ist
+// Check if selection is balanced.
SV_DECL_PTRARR( SwChartBoxes, SwTableBoxPtr, 16, 16)
SV_DECL_PTRARR_DEL( SwChartLines, SwChartBoxes*, 25, 50)
sal_Bool ChkChartSel( const SwNode& rSttNd, const SwNode& rEndNd,
SwChartLines* pGetCLines = 0 );
-// teste ob die Celle in die SSelection gehoert
-// (wurde eine Funktion, damit GetTblSel() und MakeTblCrsr() immer
-// das "gleiche Verstaendnis" fuer die Selektion haben)
+// Check if cell is part of SSelection.
+// (Became a function, in order to make sure that GetTblSel() and MakeTblCrsr()
+// have always the same concept of the selection.
sal_Bool IsFrmInTblSel( const SwRect& rUnion, const SwFrm* pCell );
-// bestimme die Boxen, die zusammen gefasst werden sollen.
-// Dabei wird auf Layout Basis das Rechteck "angepasst". D.H. es
-// werden Boxen zugefuegt wenn welche an den Seiten ueberlappen
-// Zusaetzlich wird die neue Box erzeugt und mit dem entsprechenden
-// Inhalt gefuellt.
+// Determine boxes to be merged.
+// In this process the rectangle gets "adapted" on the base of the layout,
+// i.e. boxes are added if some overlap at the sides.
+// Additionally a new box is created and filled with the relevant content.
void GetMergeSel( const SwPaM& rPam, SwSelBoxes& rBoxes,
SwTableBox** ppMergeBox, SwUndoTblMerge* pUndo = 0 );
-// teste ob die selektierten Boxen ein gueltiges Merge erlauben
+// Check if selected boxes allow for a valid merge.
sal_uInt16 CheckMergeSel( const SwPaM& rPam );
sal_uInt16 CheckMergeSel( const SwSelBoxes& rBoxes );
sal_Bool IsEmptyBox( const SwTableBox& rBox, SwPaM& rPam );
-// teste ob ein Split oder InsertCol dazu fuehrt, das eine Box
-// kleiner als MINLAY wird.
+// Check if Split or InsertCol lead to a box becoming smaller than MINLAY.
sal_Bool CheckSplitCells( const SwCrsrShell& rShell, sal_uInt16 nDiv,
const SwTblSearchType = nsSwTblSearchType::TBLSEARCH_NONE );
sal_Bool CheckSplitCells( const SwCursor& rCrsr, sal_uInt16 nDiv,
const SwTblSearchType = nsSwTblSearchType::TBLSEARCH_NONE );
-//Fuer das Arbeiten auf TabSelektion auch fuer aufgespaltene Tabellen.
+// For working on tab selection also for split tables.
class SwSelUnion
{
- SwRect aUnion; //Das die Sel umschliessende Rechteck.
- SwTabFrm *pTable; //Die (Follow-)Table zu der Union.
+ SwRect aUnion; // The rectangle enclosing the selection.
+ SwTabFrm *pTable; // The (Follow-)Table for the Union.
public:
SwSelUnion( const SwRect &rRect, SwTabFrm *pTab ) :
@@ -141,18 +138,18 @@ public:
SV_DECL_PTRARR_DEL( SwSelUnions, SwSelUnion*, 10, 20 )
-//Ermittelt die von einer Tabellenselektion betroffenen Tabellen und die
-//Union-Rechteckte der Selektionen - auch fuer aufgespaltene Tabellen.
-//Wenn ein Parameter != nsSwTblSearchType::TBLSEARCH_NONE uebergeben wird, so wird die
-//Selektion in der angegebenen Richtung erweitert.
+// Gets the tables involved in a table selection and the union-rectangles of the selections
+// - also for split tables.
+// If a parameter is passed that != nsSwTblSearchType::TBLSEARCH_NONE
+// the selection is extended in the given direction.
void MakeSelUnions( SwSelUnions&, const SwLayoutFrm *pStart,
const SwLayoutFrm *pEnd,
const SwTblSearchType = nsSwTblSearchType::TBLSEARCH_NONE );
-// -------------------------------------------------------------------
-// Diese Klassen kopieren die aktuelle Tabellen-Selektion (rBoxes)
-// unter Beibehaltung der Tabellen-Strubktur in eine eigene Struktur
+
+// These classes copy the current table selections (rBoxes) into a
+// separate structure while keeping the table structure.
class _FndBox;
class _FndLine;
@@ -166,7 +163,7 @@ class _FndBox
_FndLines aLines;
_FndLine* pUpper;
- SwTableLine *pLineBefore; //Zum Loeschen/Restaurieren des Layouts.
+ SwTableLine *pLineBefore; // For deleting/restoring the layout.
SwTableLine *pLineBehind;
public:
diff --git a/sw/inc/tox.hxx b/sw/inc/tox.hxx
index 93b83a6..3dc80c8 100644
--- a/sw/inc/tox.hxx
+++ b/sw/inc/tox.hxx
@@ -73,7 +73,7 @@ class SW_DLLPUBLIC SwTOXMark
friend void _InitCore();
friend class SwTxtTOXMark;
- String aAltText; // Der Text des Eintrages ist unterschiedlich
+ String aAltText; // Text of caption is different.
String aPrimaryKey, aSecondaryKey;
// three more strings for phonetic sorting
diff --git a/sw/inc/txatbase.hxx b/sw/inc/txatbase.hxx
index 77de654..ac16b48 100644
--- a/sw/inc/txatbase.hxx
+++ b/sw/inc/txatbase.hxx
@@ -136,7 +136,7 @@ public:
};
-// --------------- Inline Implementierungen ------------------------
+// --------------- Inline Implementations ------------------------
inline const xub_StrLen* SwTxtAttr::GetEnd() const
{
diff --git a/sw/inc/txtatr.hxx b/sw/inc/txtatr.hxx
index fbfcec6..f8be8c3 100644
--- a/sw/inc/txtatr.hxx
+++ b/sw/inc/txtatr.hxx
@@ -32,7 +32,7 @@
#include <calbck.hxx>
-class SwTxtNode; // fuer SwTxtFld
+class SwTxtNode; // For SwTxtFld.
class SwCharFmt;
namespace sw {
@@ -51,7 +51,7 @@ public:
SwTxtCharFmt( SwFmtCharFmt& rAttr, xub_StrLen nStart, xub_StrLen nEnd );
virtual ~SwTxtCharFmt( );
- // werden vom SwFmtCharFmt hierher weitergeleitet (no derivation from SwClient!)
+ // Passed from SwFmtCharFmt (no derivation from SwClient!).
void ModifyNotification( const SfxPoolItem*, const SfxPoolItem* );
bool GetInfo( SfxPoolItem& rInfo ) const;
@@ -109,7 +109,7 @@ public:
SW_DLLPRIVATE void InitRuby(SwTxtNode & rNode);
- /// get and set TxtNode pointer
+ /// Get and set TxtNode pointer.
const SwTxtNode* GetpTxtNode() const { return m_pTxtNode; }
inline const SwTxtNode& GetTxtNode() const;
void ChgTxtNode( SwTxtNode* pNew ) { m_pTxtNode = pNew; }
@@ -119,7 +119,6 @@ public:
{ return (const_cast<SwTxtRuby*>(this))->GetCharFmt(); }
};
-// --------------- Inline Implementierungen ------------------------
inline const SwTxtNode& SwTxtRuby::GetTxtNode() const
{
diff --git a/sw/inc/txtflcnt.hxx b/sw/inc/txtflcnt.hxx
index b8c9543..ddde9a5 100644
--- a/sw/inc/txtflcnt.hxx
+++ b/sw/inc/txtflcnt.hxx
@@ -36,7 +36,7 @@ class SwTxtNode;
class SwDoc;
// SWTXT_FLYCNT ********************************
-// Attribut fuer zeilengebundene Frames (ohne Endindex)
+// Attribute for line-bound frames (without end index).
class SwTxtFlyCnt : public SwTxtAttr
{
@@ -45,13 +45,13 @@ class SwTxtFlyCnt : public SwTxtAttr
public:
SwTxtFlyCnt( SwFmtFlyCnt& rAttr, xub_StrLen nStart );
- // Setzt den Anker im pFmt und
+ // Sets anchor in pFmt and
void SetAnchor( const SwTxtNode *pNode );
inline SwFlyInCntFrm *GetFlyFrm( const SwFrm *pCurrFrm );
inline const SwFlyInCntFrm *GetFlyFrm( const SwFrm *pCurrFrm ) const;
- // erzeugt sich ein neues FlyFrameFormat
+ // creates for itself a new FlyFrameFormat.
void CopyFlyFmt( SwDoc* pDoc );
};
More information about the Libreoffice-commits
mailing list