This translates the german code-comments of the file docst.cxx
to english.
This is contributed under the terms of the LGPLv3+/MPL dual license.
---
sw/source/ui/app/docst.cxx | 101 ++++++++++++++++++++------------------------
1 files changed, 46 insertions(+), 55 deletions(-)
diff --git a/sw/source/ui/app/docst.cxx b/sw/source/ui/app/docst.cxx
index 8374fad..5025d3f 100644
--- a/sw/source/ui/app/docst.cxx
+++ b/sw/source/ui/app/docst.cxx
@@ -113,14 +113,13 @@ void SwDocShell::StateStyleSheet(SfxItemSet& rSet, SwWrtShell* pSh)
while (nWhich)
{
- // aktuelle Vorlage zu jeder Familie ermitteln
- //
+ // determine current template to every family
String aName;
switch (nWhich)
{
case SID_STYLE_APPLY:
- {//hier wird die Vorlage und ihre Familie an die StyleBox
- //uebergeben, damit diese Familie angezeigt wird
+ {// here the template and its family are passed to the StyleBox
+ // so that this family is being showed
if(pShell->IsFrmSelected())
{
SwFrmFmt* pFmt = pShell->GetCurFrmFmt();
@@ -260,7 +259,7 @@ void SwDocShell::StateStyleSheet(SfxItemSet& rSet, SwWrtShell* pSh)
/*--------------------------------------------------------------------
- Beschreibung: StyleSheet-Requeste auswerten
+ Description: evaluate StyleSheet-Requests
--------------------------------------------------------------------*/
@@ -460,7 +459,7 @@ void SwDocShell::ExecStyleSheet( SfxRequest& rReq )
nRet = Delete(aParam, nFamily);
break;
case SID_STYLE_APPLY:
- // Shellwechsel in ApplyStyles
+ // Shell-switch in ApplyStyles
nRet = ApplyStyles(aParam, nFamily, pActShell, rReq.GetModifier() );
break;
case SID_STYLE_WATERCAN:
@@ -492,7 +491,7 @@ void SwDocShell::ExecStyleSheet( SfxRequest& rReq )
if(bSetReturn)
{
- if(rReq.IsAPI()) // Basic bekommt nur TRUE oder FALSE
+ if(rReq.IsAPI()) // Basic only gets TRUE or FALSE
rReq.SetReturnValue(SfxUInt16Item(nSlot, nRet !=0));
else
rReq.SetReturnValue(SfxUInt16Item(nSlot, nRet));
@@ -501,7 +500,7 @@ void SwDocShell::ExecStyleSheet( SfxRequest& rReq )
}
/*--------------------------------------------------------------------
- Beschreibung: Edit
+ Description: Edit
--------------------------------------------------------------------*/
@@ -524,7 +523,7 @@ USHORT SwDocShell::Edit( const String &rName, const String &rParent, USHORT nFam
pStyle = &mxBasePool->Make( rName, (SfxStyleFamily)nFamily, nMask );
- // die aktuellen als Parent setzen
+ // set the current one as Parent
SwDocStyleSheet* pDStyle = (SwDocStyleSheet*)pStyle;
switch( nFamily )
{
@@ -616,14 +615,13 @@ USHORT SwDocShell::Edit( const String &rName, const String &rParent, USHORT
nFam
if(!pStyle)
return FALSE;
- // Dialoge zusammenstoepseln
- //
+ // put dialogues together
rtl::Reference< SwDocStyleSheet > xTmp( new SwDocStyleSheet( *(SwDocStyleSheet*)pStyle ) );
if( SFX_STYLE_FAMILY_PARA == nFamily )
{
SfxItemSet& rSet = xTmp->GetItemSet();
::SwToSfxPageDescAttr( rSet );
- // erstmal nur eine Null
+ // firstly only a Zero
rSet.Put(SwBackgroundDestinationItem(SID_PARA_BACKGRND_DESTINATION, 0));
// merge list level indent attributes into the item set if needed
xTmp->MergeIndentAttrsOfListStyle( rSet );
@@ -642,7 +640,7 @@ USHORT SwDocShell::Edit( const String &rName, const String &rParent, USHORT nFam
}
if (!bBasic)
{
- // vor dem Dialog wird der HtmlMode an der DocShell versenkt
+ // prior to the dialog the HtmlMode at the DocShell is being sunk
USHORT nHtmlMode = ::GetHtmlMode(this);
// In HTML mode, we do not always have a printer. In order to show
@@ -666,7 +664,7 @@ USHORT SwDocShell::Edit( const String &rName, const String &rParent, USHORT nFam
{
GetWrtShell()->StartAllAction();
- // nur bei Absatz-Vorlagen die Maske neu setzen
+ // newly set the mask only with paragraph-templates
if( bNew )
{
nRet = SFX_STYLE_FAMILY_PARA == pStyle->GetFamily()
@@ -723,9 +721,9 @@ USHORT SwDocShell::Edit( const String &rName, const String &rParent, USHORT nFam
mxBasePool->Broadcast( SfxStyleSheetHint( SFX_STYLESHEET_CREATED, *xTmp.get() ) );
// JP 19.09.97:
- // Dialog vorm EndAction zerstoeren - bei Seitenvorlagen kann
- // muss der ItemSet zerstoert werden, damit die Cursor aus den
- // Kopf-/Fusszeilen entfernt werden. Sonst kommts zu GPFs!!!
+ // Destroy dialog before EndAction - with page-templates the
+ // ItemSet must be destroyed, so that the cursors get removed
+ // from Headers/Footers. Otherwise "GPF" happen!!!
delete pDlg;
pDoc->SetModified();
@@ -749,12 +747,12 @@ USHORT SwDocShell::Edit( const String &rName, const String &rParent, USHORT
nFam
}
else
{
- // vor dem Dialog wird der HtmlMode an der DocShell versenkt
+ // prior to the dialog the HtmlMode at the DocShell is being sunk
PutItem(SfxUInt16Item(SID_HTML_MODE, ::GetHtmlMode(this)));
GetWrtShell()->StartAllAction();
- // nur bei Absatz-Vorlagen die Maske neu setzen
+ // newly set the mask only with paragraph-templates
if( bNew )
{
nRet = SFX_STYLE_FAMILY_PARA == pStyle->GetFamily()
@@ -799,7 +797,7 @@ USHORT SwDocShell::Edit( const String &rName, const String &rParent, USHORT nFam
}
/*--------------------------------------------------------------------
- Beschreibung: Delete
+ Description: Delete
--------------------------------------------------------------------*/
@@ -821,7 +819,7 @@ USHORT SwDocShell::Delete(const String &rName, USHORT nFamily)
}
/*--------------------------------------------------------------------
- Beschreibung: Vorlage anwenden
+ Description: apply template
--------------------------------------------------------------------*/
@@ -889,7 +887,7 @@ USHORT SwDocShell::ApplyStyles(const String &rName, USHORT nFamily,
}
/*--------------------------------------------------------------------
- Beschreibung: Giesskanne starten
+ Description: start watering-can
--------------------------------------------------------------------*/
@@ -948,7 +946,7 @@ USHORT SwDocShell::DoWaterCan(const String &rName, USHORT nFamily)
}
/*--------------------------------------------------------------------
- Beschreibung: Vorlage Updaten
+ Description: update template
--------------------------------------------------------------------*/
@@ -977,8 +975,7 @@ USHORT SwDocShell::UpdateStyle(const String &rName, USHORT nFamily, SwWrtShell*
GetWrtShell()->StartUndo(UNDO_INSFMTATTR, &aRewriter);
GetWrtShell()->FillByEx(pColl);
- // Vorlage auch anwenden, um harte Attributierung
- // zu entfernen
+ // also apply template to remove hard set attributes
GetWrtShell()->SetTxtFmtColl( pColl );
GetWrtShell()->EndUndo(UNDO_INSFMTATTR, NULL);
GetWrtShell()->EndAllAction();
@@ -1001,8 +998,7 @@ USHORT SwDocShell::UpdateStyle(const String &rName, USHORT nFamily, SwWrtShell*
pFrm->SetFmtAttr( aSet );
- // Vorlage auch anwenden, um harte Attributierung
- // zu entfernen
+ // also apply template to remove hard set attributes
pCurrWrtShell->SetFrmFmt( pFrm, TRUE );
pCurrWrtShell->EndAllAction();
}
@@ -1015,8 +1011,7 @@ USHORT SwDocShell::UpdateStyle(const String &rName, USHORT nFamily,
SwWrtShell*
{
pCurrWrtShell->StartAllAction();
pCurrWrtShell->FillByEx(pChar);
- // Vorlage auch anwenden, um harte Attributierung
- // zu entfernen
+ // also apply template to remove hard set attributes
pCurrWrtShell->EndAllAction();
}
@@ -1041,7 +1036,7 @@ USHORT SwDocShell::UpdateStyle(const String &rName, USHORT nFamily,
SwWrtShell*
}
/*--------------------------------------------------------------------
- Beschreibung: NewByExample
+ Description: NewByExample
--------------------------------------------------------------------*/
@@ -1053,8 +1048,8 @@ USHORT SwDocShell::MakeByExample( const String &rName, USHORT nFamily,
rName, (SfxStyleFamily)nFamily );
if(!pStyle)
{
- // JP 07.07.95: behalte die akt. Maske vom PI bei, dadurch werden
- // neue sofort in den sichtbaren Bereich einsortiert
+ // JP 07.07.95: preserve the current mask of PI, then the new one is
+ // immediately merged with the viewable area
if( SFXSTYLEBIT_ALL == nMask || SFXSTYLEBIT_USED == nMask )
nMask = SFXSTYLEBIT_USERDEF;
else
@@ -1073,11 +1068,10 @@ USHORT SwDocShell::MakeByExample( const String &rName, USHORT nFamily,
{
pCurrWrtShell->StartAllAction();
pCurrWrtShell->FillByEx(pColl);
- // Vorlage auch anwenden, um harte Attributierung
- // zu entfernen
+ // also apply template to remove hard set attributes
pColl->SetDerivedFrom(pCurrWrtShell->GetCurTxtFmtColl());
- // setze die Maske noch an der Collection:
+ // set the mask at the Collection:
USHORT nId = pColl->GetPoolFmtId() & 0x87ff;
switch( nMask & 0x0fff )
{
@@ -1121,8 +1115,7 @@ USHORT SwDocShell::MakeByExample( const String &rName, USHORT nFamily,
pFrm->SetDerivedFrom( pFFmt );
pFrm->SetFmtAttr( aSet );
- // Vorlage auch anwenden, um harte Attributierung
- // zu entfernen
+ // also apply template to remove hard set attributes
pCurrWrtShell->SetFrmFmt( pFrm );
pCurrWrtShell->EndAllAction();
}
@@ -1156,12 +1149,12 @@ USHORT SwDocShell::MakeByExample( const String &rName, USHORT nFamily,
pCurrWrtShell->GetDoc()->CopyPageDesc( rSrc, rDest );
- // PoolId darf NIE kopiert werden!
+ // PoolId must NEVER be copied!
rDest.SetPoolFmtId( nPoolId );
rDest.SetPoolHelpId( nHId );
rDest.SetPoolHlpFileId( nHFId );
- // werden Kopf-/Fusszeilen angelegt, so gibt es kein Undo mehr!
+ // when Headers/Footers are created, there is no Undo anymore!
pCurrWrtShell->GetDoc()->DelAllUndoObj();
pCurrWrtShell->EndAllAction();
@@ -1202,23 +1195,21 @@ void SwDocShell::LoadStyles( SfxObjectShell& rSource )
--------------------------------------------------*/
void SwDocShell::_LoadStyles( SfxObjectShell& rSource, BOOL bPreserveCurrentDocument )
{
-/* [Beschreibung]
-
- Diese Methode wird vom SFx gerufen, wenn aus einer Dokument-Vorlage
- Styles nachgeladen werden sollen. Bestehende Styles soll dabei
- "uberschrieben werden. Das Dokument mu"s daher neu formatiert werden.
- Daher werden die Applikationen in der Regel diese Methode "uberladen
- und in ihrer Implementierung die Implementierung der Basisklasse
- rufen.
+/* [Description]
+
+ This method is called by SFx if Styles have to be reloaded from a
+ document-template. Existing Styples should be overwritten by that.
+ That's why the document has to be reformatted. Therefore applications
+ will usually overload this method and call the baseclass' implementation
+ in their implementation.
*/
- // ist die Source unser Document, dann uebernehmen wir das
- // abpruefen selbst (wesentlich schneller und laeuft nicht ueber
- // die Kruecke SfxStylePool
+ // When the source is our document, we do the checking ourselves
+ // (much quicker and doesn't use the crutch StxStylePool).
if( rSource.ISA( SwDocShell ))
{
- //JP 28.05.99: damit die Kopf-/Fusszeilen nicht den fixen Inhalt
- // der Vorlage erhalten, einmal alle FixFelder der
- // Source aktualisieren
+ //JP 28.05.99: in order for the Headers/Footers not to get the fixed content
+ // of the template, update all the Source's
+ // FixFields once.
if(!bPreserveCurrentDocument)
((SwDocShell&)rSource).pDoc->SetFixFields(false, NULL);
if( pWrtShell )
@@ -1233,8 +1224,8 @@ void SwDocShell::_LoadStyles( SfxObjectShell& rSource, BOOL
bPreserveCurrentDocu
pDoc->ReplaceStyles( *((SwDocShell&)rSource).pDoc );
if( !bModified && pDoc->IsModified() && !pView )
{
- // die View wird spaeter angelegt, ueberschreibt aber das
- // Modify-Flag. Per Undo ist sowieso nichts mehr zu machen
+ // the View is created later, but overwrites the Modify-Flag.
+ // Undo doesn't work anymore anyways.
pDoc->SetUndoNoResetModified();
}
}
--
1.7.1
Context
- [Libreoffice] [PATCH] Translate german comments · Martin Kepplinger
Privacy Policy |
Impressum (Legal Info) |
Copyright information: Unless otherwise specified, all text and images
on this website are licensed under the
Creative Commons Attribution-Share Alike 3.0 License.
This does not include the source code of LibreOffice, which is
licensed under the Mozilla Public License (
MPLv2).
"LibreOffice" and "The Document Foundation" are
registered trademarks of their corresponding registered owners or are
in actual use as trademarks in one or more countries. Their respective
logos and icons are also subject to international copyright laws. Use
thereof is explained in our
trademark policy.