[Libreoffice-commits] core.git: sw/source
Thomas Beck
thomas.beck at cib.de
Tue Mar 28 10:41:29 UTC 2017
sw/source/filter/ww8/ww8par3.cxx | 291 ++++++++++++++++++---------------------
1 file changed, 141 insertions(+), 150 deletions(-)
New commits:
commit 5138170a4a3595d6b631b33c54f7aa166ce4639b
Author: Thomas Beck <thomas.beck at cib.de>
Date: Mon Mar 27 16:39:42 2017 +0200
tdf#39468 Comment translation GER-ENG
translated comments in sw/source/filter/ww8par3.cxx
Change-Id: I40b41cecb1c73b9678c51d7e4dc41745a96a243f
Reviewed-on: https://gerrit.libreoffice.org/35765
Tested-by: Jenkins <ci at libreoffice.org>
Reviewed-by: Thorsten Behrens <Thorsten.Behrens at CIB.de>
diff --git a/sw/source/filter/ww8/ww8par3.cxx b/sw/source/filter/ww8/ww8par3.cxx
index 990971d22d0c..4d23a150ac37 100644
--- a/sw/source/filter/ww8/ww8par3.cxx
+++ b/sw/source/filter/ww8/ww8par3.cxx
@@ -303,29 +303,29 @@ void SwWW8ImplReader::DeleteFormImpl()
m_pFormImpl = nullptr;
}
-// Hilfs-Deklarationen
+// Helper declarations
// Style Id's for each level
typedef sal_uInt16 WW8aIdSty[WW8ListManager::nMaxLevel];
-// Zeichenattribute aus GrpprlChpx
+// Character attributes from GrpprlChpx
typedef SfxItemSet* WW8aISet[WW8ListManager::nMaxLevel];
-// Zeichen Style Pointer
+// Character Style Pointer
typedef SwCharFormat* WW8aCFormat[WW8ListManager::nMaxLevel];
-struct WW8LST // nur DIE Eintraege, die WIR benoetigen!
+struct WW8LST // only THOSE entries, WE need!
{
WW8aIdSty aIdSty; // Style Id's for each level,
// nIStDNil if no style linked
sal_uInt32 nIdLst; // Unique List ID
- sal_uInt32 nTplC; // Unique template code - Was ist das bloss?
- bool bSimpleList:1; // Flag: Liste hat nur EINEN Level
- bool bRestartHdn:1; // WW6-Kompatibilitaets-Flag:
+ sal_uInt32 nTplC; // Unique template code - What is this?
+ bool bSimpleList:1; // Flag: List only has ONE level
+ bool bRestartHdn:1; // WW6-Combatibility-Flag:
// true if the list should start numbering over
}; // at the beginning of each section
const sal_uInt32 cbLSTF=28;
-struct WW8LFO // nur DIE Eintraege, die WIR benoetigen!
+struct WW8LFO // only THOSE entries, WE need!
{
SwNumRule* pNumRule; // Parent NumRule
sal_uInt32 nIdLst; // Unique List ID
@@ -333,28 +333,28 @@ struct WW8LFO // nur DIE Eintraege, die WIR benoetigen!
bool bSimpleList;
};
-struct WW8LVL // nur DIE Eintraege, die WIR benoetigen!
+struct WW8LVL // only THE entries, WE need!
{
sal_Int32 nStartAt; // start at value for this value
- sal_Int32 nV6DxaSpace;// Ver6-Compatible: min Space between Num anf text::Paragraph
- sal_Int32 nV6Indent; // Ver6-Compatible: Breite des Prefix Textes; ggfs. zur
- // Definition d. Erstzl.einzug nutzen!
- // Absatzattribute aus GrpprlPapx
- sal_uInt16 nDxaLeft; // linker Einzug
- short nDxaLeft1; // Erstzeilen-Einzug
+ sal_Int32 nV6DxaSpace;// Ver6-Compatible: min Space between Num and text::Paragraph
+ sal_Int32 nV6Indent; // Ver6-Compatible: Width of prefix text;
+ // Use definition of first line indent if appropriate!
+ // Paragraph attributes from GrpprlPapx
+ sal_uInt16 nDxaLeft; // left indent
+ short nDxaLeft1; // first line indent
sal_uInt8 nNFC; // number format code
- // Offset der Feldkodes im Num-X-String
+ // Offset of fieldcodes in Num-X-String
sal_uInt8 aOfsNumsXCH[WW8ListManager::nMaxLevel];
sal_uInt8 nLenGrpprlChpx; // length, in bytes, of the LVL's grpprlChpx
sal_uInt8 nLenGrpprlPapx; // length, in bytes, of the LVL's grpprlPapx
sal_uInt8 nAlign: 2; // alignment (left, right, centered) of the number
- sal_uInt8 bLegal: 1; // egal
- sal_uInt8 bNoRest:1; // egal
+ sal_uInt8 bLegal: 1; // doesn't matter
+ sal_uInt8 bNoRest:1; // doesn't matter
sal_uInt8 bV6Prev:1; // Ver6-Compatible: number will include previous levels
- sal_uInt8 bV6PrSp:1; // Ver6-Compatible: egal
- sal_uInt8 bV6: 1; // falls true , beachte die V6-Compatible Eintraege!
- sal_uInt8 bDummy: 1; // (macht das Byte voll)
+ sal_uInt8 bV6PrSp:1; // Ver6-Compatible: doesn't matter
+ sal_uInt8 bV6: 1; // if true, pay attention to the V6-Compatible Entries!
+ sal_uInt8 bDummy: 1; // (fills the byte)
};
@@ -363,8 +363,8 @@ struct WW8LFOLVL
sal_Int32 nStartAt; // start-at value if bFormat==false and bStartAt == true
// (if bFormat==true, the start-at is stored in the LVL)
sal_uInt8 nLevel; // the level to be overridden
- // dieses Byte ist _absichtlich_ nicht in das folgende Byte hineingepackt !!
- // (siehe Kommentar unten bei struct WW8LFOInfo)
+ // this byte has not been packed into the following byte on _purpose_ !!
+ // (see comment of struct WW8LFOInfo)
bool bStartAt :1; // true if the start-at value is overridden
bool bFormat :1; // true if the formatting is overridden
@@ -373,20 +373,20 @@ struct WW8LFOLVL
nStartAt(1), nLevel(0), bStartAt(true), bFormat(false) {}
};
-// in den ListenInfos zu speichernde Daten
+// Data to be saved in ListInfo
-struct WW8LSTInfo // sortiert nach nIdLst (in WW8 verwendete Listen-Id)
+struct WW8LSTInfo // sorted by nIdLst (in WW8 used list-Id)
{
std::vector<ww::bytes> maParaSprms;
WW8aIdSty aIdSty; // Style Id's for each level
- WW8aISet aItemSet; // Zeichenattribute aus GrpprlChpx
- WW8aCFormat aCharFormat; // Zeichen Style Pointer
+ WW8aISet aItemSet; // Character attributes from GrpprlChpx
+ WW8aCFormat aCharFormat; // Character Style Pointer
- SwNumRule* pNumRule; // Zeiger auf entsprechende Listenvorlage im Writer
- sal_uInt32 nIdLst; // WW8Id dieser Liste
- bool bSimpleList:1;// Flag, ob diese NumRule nur einen Level verwendet
- bool bUsedInDoc :1;// Flag, ob diese NumRule im Doc verwendet wird,
- // oder beim Reader-Ende geloescht werden sollte
+ SwNumRule* pNumRule; // Pointer to list-template in im Writer
+ sal_uInt32 nIdLst; // WW8Id of this list
+ bool bSimpleList:1;// Flag, if this NumRule only uses one Level
+ bool bUsedInDoc :1;// Flag, if this NumRule is used in the Doc,
+ // or is supposed to be deleted on Reader-End
WW8LSTInfo(SwNumRule* pNumRule_, WW8LST& aLST)
: pNumRule(pNumRule_), nIdLst(aLST.nIdLst),
@@ -399,28 +399,28 @@ struct WW8LSTInfo // sortiert nach nIdLst (in WW8 verwendete Listen-Id)
};
-// in den ListenFormatOverrideInfos zu speichernde Daten
+// Data to be saved in ListenFormatOverrideInfos
-struct WW8LFOInfo // unsortiert, d.h. Reihenfolge genau wie im WW8 Stream
+struct WW8LFOInfo // unordered, means ordered like in WW8 Stream
{
std::vector<ww::bytes> maParaSprms;
std::vector<WW8LFOLVL> maOverrides;
- SwNumRule* pNumRule; // Zeiger auf entsprechende Listenvorlage im Writer
- // entweder: Liste in LSTInfos oder eigene Liste
- // (im Ctor erstmal die aus den LSTInfos merken)
+ SwNumRule* pNumRule; // Pointer to list template in Writer
+ // either List in LSTInfos or own List
+ // (in Ctor use the list from LSTInfos first)
- sal_uInt32 nIdLst; // WW8-Id der betreffenden Liste
+ sal_uInt32 nIdLst; // WW8-Id of the relevant list
sal_uInt8 nLfoLvl; // count of levels whose format is overridden
- // Ja, ich natuerlich koennten wir nLfoLvl (mittels :4) noch in das folgende
- // Byte mit hineinpacken, doch waere das eine ziemliche Fehlerquelle,
- // an dem Tag, wo MS ihr Listenformat auf mehr als 15 Level aufbohren.
-
- bool bOverride :1;// Flag, ob die NumRule nicht in maLSTInfos steht,
- // sondern fuer m_LFOInfos NEU angelegt wurde
- bool bUsedInDoc :1;// Flag, ob diese NumRule im Doc verwendet wird,
- // oder beim Reader-Ende geloescht werden sollte
- bool bLSTbUIDSet :1;// Flag, ob bUsedInDoc in maLSTInfos gesetzt wurde,
- // und nicht nochmals gesetzt zu werden braucht
+ // yes we could include nLfoLvl (via :4) into the following byte,
+ // but it probably would be a source of error once MS increases their Listformat
+ // to more than 15 levels
+
+ bool bOverride :1;// Flag if NumRule is not included in maLSTInfos,
+ // but was created for m_LFOInfos
+ bool bUsedInDoc :1;// Flag if NumRule is used in Doc,
+ // or should be deleted on Reader-End
+ bool bLSTbUIDSet :1;// Flag, if bUsedInDoc is set in maLSTInfos
+
explicit WW8LFOInfo(const WW8LFO& rLFO);
};
@@ -436,9 +436,9 @@ WW8LFOInfo::WW8LFOInfo(const WW8LFO& rLFO)
{
}
-// Hilfs-Methoden
+// Helper methods
-// finden der Sprm-Parameter-Daten, falls Sprm im Grpprl enthalten
+// find Sprm-Parameter-Data, if Sprm is included in Grpprl
sal_uInt8* WW8ListManager::GrpprlHasSprm(sal_uInt16 nId, sal_uInt8& rSprms,
sal_uInt8 nLen)
{
@@ -455,7 +455,7 @@ public:
{ return (pEntry->nIdLst == mnIdLst); }
};
-// Zugriff ueber die List-Id des LST Eintrags
+// Access via List-Id of LST Entry
WW8LSTInfo* WW8ListManager::GetLSTByListId( sal_uInt32 nIdLst ) const
{
std::vector<WW8LSTInfo *>::const_iterator aResult =
@@ -509,9 +509,9 @@ bool WW8ListManager::ReadLVL(SwNumFormat& rNumFormat, SfxItemSet*& rpItemSet,
ww::bytes &rParaSprms)
{
sal_uInt8 aBits1(0);
- sal_uInt16 nStartNo(0); // Start-Nr. fuer den Writer
+ sal_uInt16 nStartNo(0); // Start-No. for Writer
SvxNumType nType(SVX_NUM_ARABIC);
- SvxAdjust eAdj; // Ausrichtung (Links/rechts/zent.)
+ SvxAdjust eAdj; // Alignment (Left/right/centered)
sal_Unicode cBullet(0x2190); // default safe bullet
sal_Unicode cGrfBulletCP(USHRT_MAX);
@@ -520,7 +520,7 @@ bool WW8ListManager::ReadLVL(SwNumFormat& rNumFormat, SfxItemSet*& rpItemSet,
OUString sPostfix;
WW8LVL aLVL;
- // 1. LVLF einlesen
+ // 1. read LVLF
memset(&aLVL, 0, sizeof( aLVL ));
rSt.ReadInt32( aLVL.nStartAt );
@@ -554,7 +554,7 @@ bool WW8ListManager::ReadLVL(SwNumFormat& rNumFormat, SfxItemSet*& rpItemSet,
rSt.SeekRel( 2 );
if( 0 != rSt.GetError()) return false;
- // 2. ggfs. PAPx einlesen und nach Einzug-Werten suchen
+ // 2. read PAPx if needed and search for indent values
short nTabPos = 0; // #i86652# - read tab setting
if( aLVL.nLenGrpprlPapx )
@@ -651,7 +651,7 @@ bool WW8ListManager::ReadLVL(SwNumFormat& rNumFormat, SfxItemSet*& rpItemSet,
}
}
- // 3. ggfs. CHPx einlesen und
+ // 3. read CHPx if needed
sal_uInt16 nWitchPicIsBullet = USHRT_MAX;
bool bIsPicBullet = false;
@@ -675,23 +675,23 @@ bool WW8ListManager::ReadLVL(SwNumFormat& rNumFormat, SfxItemSet*& rpItemSet,
bIsPicBullet = (*pSprmIsPicBullet) & 0x0001;
}
- // neues ItemSet fuer die Zeichenattribute anlegen
+ // create new Itemset for character attributes
rpItemSet = new SfxItemSet( rDoc.GetAttrPool(), RES_CHRATR_BEGIN,
RES_CHRATR_END - 1 );
- // Reader-ItemSet-Pointer darauf zeigen lassen
+ // Set Reader-ItemSet-Pointer to the newly created set
rReader.SetAktItemSet( rpItemSet );
- // Reader-Style auf den Style dieses Levels setzen
+ // Set Reader-Style to Style of this Level
sal_uInt16 nOldColl = rReader.GetNAktColl();
sal_uInt16 nNewColl = nLevelStyle;
if (ww::stiNil == nNewColl)
nNewColl = 0;
rReader.SetNAktColl( nNewColl );
- // Nun den GrpprlChpx einfach durchnudeln: die Read_xy() Methoden
- // in WW8PAR6.CXX rufen ganz normal ihr NewAttr() oder GetFormatAttr()
- // und diese merken am besetzten Reader-ItemSet-Pointer, dass dieser
- // spezielle ItemSet relevant ist - und nicht ein Stack oder Style!
+ // The Read_xy() methods in WW8PAR6.cxx are calling their respective
+ // NewAttr() or GetFormatAttr() which can determine, by using the assigned
+ // Reader-ItemSet-Pointer, whether this specificl ItemSet is relevant
+ // and not a Stack or Style!
sal_uInt16 nOldFlags1 = rReader.GetToggleAttrFlags();
sal_uInt16 nOldFlags2 = rReader.GetToggleBiDiAttrFlags();
@@ -703,18 +703,18 @@ bool WW8ListManager::ReadLVL(SwNumFormat& rNumFormat, SfxItemSet*& rpItemSet,
aSprmIter.advance();
}
- // Reader-ItemSet-Pointer und Reader-Style zuruecksetzen
+ // Reset Reader-ItemSet-Pointer and Reader-Style
rReader.SetAktItemSet( nullptr );
rReader.SetNAktColl( nOldColl );
rReader.SetToggleAttrFlags(nOldFlags1);
rReader.SetToggleBiDiAttrFlags(nOldFlags2);
}
- // 4. den Nummerierungsstring einlesen: ergibt Prefix und Postfix
+ // 4. Read numbering String. Results in prefix and postfix
OUString sNumString(sanitizeString(read_uInt16_PascalString(rSt)));
- // 5. gelesene Werte in Writer Syntax umwandeln
+ // 5. convert read values into Writer syntaxg
if( 0 <= aLVL.nStartAt )
nStartNo = (sal_uInt16)aLVL.nStartAt;
@@ -737,7 +737,7 @@ bool WW8ListManager::ReadLVL(SwNumFormat& rNumFormat, SfxItemSet*& rpItemSet,
nType = SVX_NUM_CHARS_LOWER_LETTER_N;
break;
case 5:
- // eigentlich: ORDINAL
+ // actually: ORDINAL
nType = SVX_NUM_ARABIC;
break;
case 23:
@@ -829,16 +829,15 @@ bool WW8ListManager::ReadLVL(SwNumFormat& rNumFormat, SfxItemSet*& rpItemSet,
}
}
- sal_uInt8 nUpperLevel = 0; // akt. Anzeigetiefe fuer den Writer
+ sal_uInt8 nUpperLevel = 0; // current displaydepth for Writer
for(sal_uInt8 nLevelB = 0; nLevelB < nMaxLevel; ++nLevelB)
{
if (!nUpperLevel && !aOfsNumsXCH[nLevelB])
nUpperLevel = nLevelB;
}
- // falls kein NULL als Terminierungs-Char kam,
- // ist die Liste voller Indices, d.h. alle Plaetze sind besetzt,
- // also sind alle Level anzuzeigen
+ // If the terminating char was not NULL, all indices of the list are
+ // filled, so the levels have to be displayed.
if (!nUpperLevel)
nUpperLevel = nMaxLevel;
@@ -908,7 +907,7 @@ bool WW8ListManager::ReadLVL(SwNumFormat& rNumFormat, SfxItemSet*& rpItemSet,
break;
}
- // 6. entsprechendes NumFormat konfigurieren
+ // 6. Configure NumFormat
if( bSetStartNo )
rNumFormat.SetStart( nStartNo );
rNumFormat.SetNumberingType( nType );
@@ -918,8 +917,8 @@ bool WW8ListManager::ReadLVL(SwNumFormat& rNumFormat, SfxItemSet*& rpItemSet,
{
// first character of the Prefix-Text is the Bullet
rNumFormat.SetBulletChar(cBullet);
- // Don't forget: unten, nach dem Bauen eventueller Styles auch noch
- // SetBulletFont() rufen !!!
+ // Don't forget: further below, after building styles
+ // Call SetBulletFont() !!!
}
//For i120928,position index info
else if (style::NumberingType::BITMAP == nType)
@@ -1012,13 +1011,13 @@ void WW8ListManager::AdjustLVL( sal_uInt8 nLevel, SwNumRule& rNumRule,
sal_uInt16 nWhich = aIter.GetCurItem()->Which();
while (true)
{
- if( // ggfs. passenden pItem im pLowerLevelItemSet finden
+ if( // search for appropriate pItem in pLowerLevelItemSet
(SfxItemState::SET != pLowerLevelItemSet->GetItemState(
nWhich, false, &pItem ) )
- || // virtuellen "!=" Operator anwenden
+ || // use virtual "!=" Operator
(*pItem != *aIter.GetCurItem() ) )
- // falls kein Item mit gleicher nWhich gefunden oder Werte
- // der Items ungleich, Ungleichheit merken und abbrechen!
+ // if no Item with equal nWhich was found or Item value was not equal
+ // store inequality and break!
{
nIdenticalItemSetLevel = nMaxLevel;
break;
@@ -1036,26 +1035,26 @@ void WW8ListManager::AdjustLVL( sal_uInt8 nLevel, SwNumRule& rNumRule,
SwCharFormat* pFormat;
if (nMaxLevel == nIdenticalItemSetLevel)
{
- // Style definieren
+ // Define Style
const OUString aName( (!sPrefix.isEmpty() ? sPrefix : rNumRule.GetName())
+ "z" + OUString::number( nLevel ) );
- // const Wegcasten
+ // remove const by casting
pFormat = rDoc.MakeCharFormat(aName, rDoc.GetDfltCharFormat());
bNewCharFormatCreated = true;
- // Attribute reinsetzen
+ // Set Attributes
pFormat->SetFormatAttr( *pThisLevelItemSet );
}
else
{
- // passenden Style hier anhaengen
+ // append Style
pFormat = rCharFormat[ nIdenticalItemSetLevel ];
}
- // merken
+ // store
rCharFormat[ nLevel ] = pFormat;
- // Style an das NumFormat haengen
+ // Append Style to NumFormat
aNumFormat.SetCharFormat( pFormat );
}
@@ -1075,7 +1074,7 @@ void WW8ListManager::AdjustLVL( sal_uInt8 nLevel, SwNumRule& rNumRule,
}
}
- // ggfs. Bullet Font an das NumFormat haengen
+ // if neccessary: Append Bullet Font to NumFormat
if( SVX_NUM_CHAR_SPECIAL == aNumFormat.GetNumberingType() )
{
@@ -1097,14 +1096,14 @@ void WW8ListManager::AdjustLVL( sal_uInt8 nLevel, SwNumRule& rNumRule,
aNumFormat.SetBulletFont( &aFont );
}
- // und wieder rein in die NumRule
+ // Set NumFormat in NumRule
rNumRule.Set(nLevel, aNumFormat);
}
SwNumRule* WW8ListManager::CreateNextRule(bool bSimple)
{
- // wird erstmal zur Bildung des Style Namens genommen
+ // Used to build the Style Name
const OUString sPrefix("WW8Num" + OUString::number(nUniqueList++));
// #i86652#
sal_uInt16 nRul =
@@ -1124,7 +1123,7 @@ SwNumRule* WW8ListManager::GetNumRule(size_t i)
return nullptr;
}
-// oeffentliche Methoden
+// public methods
WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
: maSprmParser(rReader_.GetFib()), rReader(rReader_)
@@ -1134,18 +1133,18 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
, nLastLFOPosition(USHRT_MAX)
{
- // LST und LFO gibts erst ab WW8
+ // LST and LFO only since WW8
if( ( 8 > rFib.m_nVersion )
|| ( rFib.m_fcPlcfLst == rFib.m_fcPlfLfo )
|| ( rFib.m_lcbPlcfLst < 2 )
- || ( rFib.m_lcbPlfLfo < 2) ) return; // offensichtlich keine Listen da
+ || ( rFib.m_lcbPlfLfo < 2) ) return; // no public lists
- // Arrays anlegen
+ // create Arrays
bool bLVLOk = true;
long nOriginalPos = rSt.Tell();
- // 1. PLCF LST auslesen und die Listen Vorlagen im Writer anlegen
+ // 1. read PLCF LST and create list templates in Writer
bool bOk = checkSeek(rSt, rFib.m_fcPlcfLst);
@@ -1162,7 +1161,7 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
if (!bOk)
return;
- // 1.1 alle LST einlesen
+ // 1.1 read all LST
const size_t nMinRecordSize = 10 + 2*nMaxLevel;
const size_t nMaxRecords = rSt.remainingSize() / nMinRecordSize;
if (nListCount > nMaxRecords)
@@ -1179,7 +1178,7 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
WW8LST aLST;
memset(&aLST, 0, sizeof( aLST ));
- // 1.1.1 Daten einlesen
+ // 1.1.1 read Data
rSt.ReadUInt32( aLST.nIdLst );
rSt.ReadUInt32( aLST.nTplC );
@@ -1221,7 +1220,7 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
nRemainingPlcfLst -= cbLSTF;
}
- // 1.2 alle LVL aller aLST einlesen
+ // 1.2 read all LVL of all aLST
sal_uInt16 nLSTInfos = static_cast< sal_uInt16 >(maLSTInfos.size());
for (sal_uInt16 nList = 0; nList < nLSTInfos; ++nList)
@@ -1230,7 +1229,7 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
if( !pListInfo || !pListInfo->pNumRule ) break;
SwNumRule& rMyNumRule = *pListInfo->pNumRule;
- // 1.2.1 betreffende(n) LVL(s) fuer diese aLST einlesen
+ // 1.2.1 read specific LVL(s) for this aLST
sal_uInt16 nLvlCount = static_cast< sal_uInt16 >(pListInfo->bSimpleList ? nMinLevel : nMaxLevel);
std::deque<bool> aNotReallyThere;
@@ -1239,20 +1238,20 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
for (sal_uInt16 nLevel = 0; nLevel < nLvlCount; ++nLevel)
{
SwNumFormat aNumFormat( rMyNumRule.Get( nLevel ) );
- // LVLF einlesen
+ // read LVLF
bLVLOk = ReadLVL( aNumFormat, pListInfo->aItemSet[nLevel],
pListInfo->aIdSty[nLevel], true, aNotReallyThere, nLevel,
pListInfo->maParaSprms[nLevel]);
if( !bLVLOk )
break;
- // und in die rMyNumRule aufnehmen
+ // and set in rMyNumRule
rMyNumRule.Set( nLevel, aNumFormat );
}
if( !bLVLOk )
break;
- // 1.2.2 die ItemPools mit den CHPx Einstellungen der verschiedenen
- // Level miteinander vergleichen und ggfs. Style(s) erzeugen
+ // 1.2.2 compare ItemPools and CHPx Settings of different Levels
+ // and create Style(s) if neccessary
for (sal_uInt16 nLevel = 0; nLevel < nLvlCount; ++nLevel)
{
@@ -1261,13 +1260,13 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
pListInfo->aCharFormat, bDummy );
}
- // 1.2.3 ItemPools leeren und loeschen
+ // 1.2.3 clear and delete ItemPools
for (sal_uInt16 nLevel = 0; nLevel < nLvlCount; ++nLevel)
delete pListInfo->aItemSet[ nLevel ];
}
- // 2. PLF LFO auslesen und speichern
+ // 2. read and save PLF LFO
bOk = checkSeek(rSt, rFib.m_fcPlfLfo);
@@ -1281,7 +1280,7 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
if (!bOk)
return;
- // 2.1 alle LFO einlesen
+ // 2.1 read all LFO
for (sal_Int32 nLfo = 0; nLfo < nLfoCount; ++nLfo)
{
@@ -1296,21 +1295,21 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
if (!rSt.good())
break;
rSt.SeekRel( 3 );
- // soviele Overrides existieren
+ // as many Overrides as there are
if ((nMaxLevel < aLFO.nLfoLvl) || rSt.GetError())
break;
- // die Parent NumRule der entsprechenden Liste ermitteln
+ // get the Parent NumRule of the current List
WW8LSTInfo* pParentListInfo = GetLSTByListId(aLFO.nIdLst);
if (pParentListInfo)
{
- // hier, im ersten Schritt, erst mal diese NumRule festhalten
+ // Save the NumRule in this first step
aLFO.pNumRule = pParentListInfo->pNumRule;
- // hat die Liste mehrere Level ?
+ // are there multiple Levels in the List?
aLFO.bSimpleList = pParentListInfo->bSimpleList;
}
- // und rein ins Merk-Array mit dem Teil
+ // store in Array
std::unique_ptr<WW8LFOInfo> pLFOInfo(new WW8LFOInfo(aLFO));
if (pParentListInfo)
{
@@ -1328,33 +1327,32 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
if( bOk )
{
- // 2.2 fuer alle LFO die zugehoerigen LFOLVL einlesen
+ // 2.2 read specific LFOLVL for all LFO
size_t nLFOInfos = m_LFOInfos.size();
for (size_t nLfo = 0; nLfo < nLFOInfos; ++nLfo)
{
WW8LFOInfo& rLFOInfo = *m_LFOInfos[nLfo];
- // stehen hierfuer ueberhaupt LFOLVL an ?
+ // Do LFOLVL exist?
if( rLFOInfo.bOverride )
{
WW8LSTInfo* pParentListInfo = GetLSTByListId(rLFOInfo.nIdLst);
if (!pParentListInfo)
break;
- // 2.2.1 eine neue NumRule fuer diese Liste anlegen
+ // 2.2.1 create new NumRule for this List
SwNumRule* pParentNumRule = rLFOInfo.pNumRule;
OSL_ENSURE(pParentNumRule, "ww: Impossible lists, please report");
if( !pParentNumRule )
break;
- // Nauemsprefix aufbauen: fuer NumRule-Name (eventuell)
- // und (falls vorhanden) fuer Style-Name (dann auf jeden Fall)
+ // create name-prefix for NumRule-Name
+ // and (if neccessary) for Style-Name
const OUString sPrefix("WW8NumSt" + OUString::number( nLfo + 1 ));
- // jetzt dem pNumRule seinen RICHTIGEN Wert zuweisen !!!
- // (bis dahin war hier die Parent NumRule vermerkt )
+ // Now assign pNumRule its actual value!!!
+ // (it contained the parent NumRule up to this point)
- // Dazu erst mal nachsehen, ob ein Style diesen LFO
- // referenziert:
+ // check if a Style is referencing this LFO
if( USHRT_MAX > rReader.StyleUsingLFO( nLfo ) )
{
sal_uInt16 nRul = rDoc.MakeNumRule(
@@ -1370,11 +1368,10 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
rLFOInfo.pNumRule->SetAutoRule(true); // = default
}
- // 2.2.2 alle LFOLVL (und ggfs. LVL) fuer die neue NumRule
- // einlesen
+ // 2.2.2 read all LFOLVL (and LVL) for the new NumRule
- WW8aISet aItemSet; // Zeichenattribute aus GrpprlChpx
- WW8aCFormat aCharFormat; // Zeichen Style Pointer
+ WW8aISet aItemSet; // Character attribues from GrpprlChpx
+ WW8aCFormat aCharFormat; // Character Style Pointer
memset(&aItemSet, 0, sizeof( aItemSet ));
memset(&aCharFormat, 0, sizeof( aCharFormat ));
@@ -1400,7 +1397,7 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
WW8LFOLVL aLFOLVL;
bLVLOk = false;
- // 2.2.2.1 den LFOLVL einlesen
+ // 2.2.2.1 read LFOLVL
rSt.ReadInt32( aLFOLVL.nStartAt );
sal_uInt8 aBits1(0);
@@ -1409,13 +1406,8 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
if (rSt.GetError())
break;
- // beachte: Die Witzbolde bei MS quetschen die
- // Override-Level-Nummer in vier Bits hinein, damit sie
- // wieder einen Grund haben, ihr Dateiformat zu aendern,
- // falls ihnen einfaellt, dass sie eigentlich doch gerne
- // bis zu 16 Listen-Level haetten. Wir tun das *nicht*
- // (siehe Kommentar oben bei "struct
- // WW8LFOInfo")
+ // Note: MS writes the Override-Level-Number into 4 bit.
+ // We do not! (See comment at "struct WW8LFOInfo")
aLFOLVL.nLevel = aBits1 & 0x0F;
if( (0xFF > aBits1) &&
(nMaxLevel > aLFOLVL.nLevel) )
@@ -1425,16 +1417,15 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
else
aLFOLVL.bStartAt = false;
- // 2.2.2.2 eventuell auch den zugehoerigen LVL einlesen
+ // 2.2.2.2 load dedicated LVL if neccessary
SwNumFormat aNumFormat(
rLFOInfo.pNumRule->Get(aLFOLVL.nLevel));
if (aBits1 & 0x20)
{
aLFOLVL.bFormat = true;
- // falls bStartup true, hier den Startup-Level
- // durch den im LVL vermerkten ersetzen LVLF
- // einlesen
+ // if bStartup is true, replace Startup-Level
+ // with the LVLF that is saved in the LVL
bLVLOk = ReadLVL(aNumFormat, aItemSet[nLevel],
pParentListInfo->aIdSty[nLevel],
aLFOLVL.bStartAt, aNotReallyThere, nLevel,
@@ -1449,7 +1440,7 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
writer_cast<sal_uInt16>(aLFOLVL.nStartAt));
}
- // 2.2.2.3 das NumFormat in die NumRule aufnehmen
+ // 2.2.2.3 Set NumFormat in NumRule
rLFOInfo.pNumRule->Set(aLFOLVL.nLevel, aNumFormat);
}
@@ -1461,7 +1452,7 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
if( !bLVLOk )
break;
- // 2.2.3 die LVL der neuen NumRule anpassen
+ // 2.2.3 adjust LVL of the new NumRule
sal_uInt16 aFlagsNewCharFormat = 0;
bool bNewCharFormatCreated = false;
@@ -1473,14 +1464,14 @@ WW8ListManager::WW8ListManager(SvStream& rSt_, SwWW8ImplReader& rReader_)
aFlagsNewCharFormat += (1 << nLevel);
}
- // 2.2.4 ItemPools leeren und loeschen
+ // 2.2.4 clear and delete ItemPools
for (sal_uInt8 nLevel = 0; nLevel < rLFOInfo.nLfoLvl; ++nLevel)
delete aItemSet[ nLevel ];
}
}
}
- // und schon sind wir fertig!
+ // and we're done!
rSt.Seek( nOriginalPos );
}
@@ -1659,7 +1650,7 @@ SwNumRule* WW8ListManager::GetNumRuleForActivation(sal_uInt16 nLFOPosition,
return pRet;
}
-// SwWW8ImplReader: anhaengen einer Liste an einen Style oder Absatz
+// SwWW8ImplReader: append a List to a Style or Paragraph
bool SwWW8ImplReader::SetTextFormatCollAndListLevel(const SwPaM& rRg,
SwWW8StyInf& rStyleInfo)
@@ -1739,11 +1730,11 @@ void SwWW8ImplReader::SetStylesList(sal_uInt16 nStyle, sal_uInt16 nActLFO,
if (rStyleInf.m_bValid)
{
OSL_ENSURE(m_pAktColl, "Cannot be called outside of style import");
- // Phase 1: Nummerierungsattribute beim Einlesen einer StyleDef
+ // Phase 1: Numbering attributes when reading a StyleDef
if( m_pAktColl )
{
- // jetzt nur die Parameter vermerken: die tatsaechliche Liste wird
- // spaeter drangehaengt, wenn die Listendefinitionen gelesen sind...
+ // only save the Parameters for now. The actual List will be appended
+ // at a later point, when whe Listdefinitions were read...
if (
(USHRT_MAX > nActLFO) &&
(WW8ListManager::nMaxLevel > nActLevel)
@@ -1782,7 +1773,7 @@ void SwWW8ImplReader::RegisterNumFormatOnStyle(sal_uInt16 nStyle)
rStyleInf.maWordLR =
ItemGet<SvxLRSpaceItem>(*rStyleInf.m_pFormat, RES_LR_SPACE);
- // Phase 2: aktualisieren der StyleDef nach einlesen aller Listen
+ // Phase 2: refresh StyleDef after reading all Lists
SwNumRule* pNmRule = nullptr;
const sal_uInt16 nLFO = rStyleInf.m_nLFOIndex;
const sal_uInt8 nLevel = rStyleInf.m_nListLevel;
@@ -1820,12 +1811,12 @@ void SwWW8ImplReader::RegisterNumFormatOnTextNode(sal_uInt16 nActLFO,
sal_uInt8 nActLevel,
const bool bSetAttr)
{
- // beachte: die Methode haengt die NumRule an den Text Node, falls
- // bSetAttr (dann muessen natuerlich vorher die Listen gelesen sein)
- // stellt sie NUR den Level ein, im Vertrauen darauf, dass am STYLE eine
- // NumRule haengt - dies wird NICHT ueberprueft !!!
+ // Note: the method appends NumRule to the Text Node if
+ // bSetAttr (of course the lists have to be read before)
+ // and only sets the Level. It does not check if there is a NumRule
+ // attachted to the STYLE !!!
- if (m_pLstManager) // sind die Listendeklarationen gelesen?
+ if (m_pLstManager) // are all list declarations read?
{
SwTextNode* pTextNd = m_pPaM->GetNode().GetTextNode();
OSL_ENSURE(pTextNd, "No Text-Node at PaM-Position");
@@ -1911,7 +1902,7 @@ void SwWW8ImplReader::RegisterNumFormatOnTextNode(sal_uInt16 nActLFO,
void SwWW8ImplReader::RegisterNumFormat(sal_uInt16 nActLFO, sal_uInt8 nActLevel)
{
- // sind wir erst beim Einlesen der StyleDef ?
+ // Are we reading the StyleDef ?
if (m_pAktColl)
SetStylesList( m_nAktColl , nActLFO, nActLevel);
else
@@ -1937,7 +1928,7 @@ void SwWW8ImplReader::Read_ListLevel(sal_uInt16, const sal_uInt8* pData,
if( !pData )
return;
- // die Streamdaten sind hier Null basiert, so wie wir es brauchen
+ // the Streamdata is zero based
m_nListLevel = *pData;
if (m_pStyles && !m_bVer67)
@@ -2590,7 +2581,7 @@ bool SwMSConvertControls::InsertControl(
aTmp <<= xTextRg;
xShapePropSet->setPropertyValue("TextRange", aTmp );
- // Das Control-Model am Control-Shape setzen
+ // Set the Control-Model for the Control-Shape
uno::Reference< drawing::XControlShape > xControlShape( xShape,
uno::UNO_QUERY );
uno::Reference< awt::XControlModel > xControlModel( rFComp,
More information about the Libreoffice-commits
mailing list