summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPhilipp Riemer <ruderphilipp@gmail.com>2013-05-05 18:47:23 +0200
committerPhilipp Riemer <ruderphilipp@gmail.com>2013-05-05 20:33:14 +0200
commite89804f1fcb323712ba35033ee9839d8a1f9f271 (patch)
treec5988246e835a455ffd890e2fc686ef4ff2ba027
parent24c3a58a0782f81eed3902c3aa16868229d24628 (diff)
fdo#39468: Translate German comments in sw/source/core/graphic
Change-Id: Ic78269f73b31125d7326b9aa1bfca76d7e881177
-rw-r--r--sw/source/core/graphic/grfatr.cxx4
-rw-r--r--sw/source/core/graphic/ndgrf.cxx115
2 files changed, 58 insertions, 61 deletions
diff --git a/sw/source/core/graphic/grfatr.cxx b/sw/source/core/graphic/grfatr.cxx
index b5f2d2e5a003..2ab9fe8362a2 100644
--- a/sw/source/core/graphic/grfatr.cxx
+++ b/sw/source/core/graphic/grfatr.cxx
@@ -79,7 +79,7 @@ bool SwMirrorGrf::QueryValue( uno::Any& rVal, sal_uInt8 nMemberId ) const
{
bool bRet = true;
sal_Bool bVal;
- // Vertikal und Horizontal sind mal getauscht worden!
+ // vertical and horizontal were swapped at some point
nMemberId &= ~CONVERT_TWIPS;
switch ( nMemberId )
{
@@ -105,7 +105,7 @@ bool SwMirrorGrf::PutValue( const uno::Any& rVal, sal_uInt8 nMemberId )
{
bool bRet = true;
sal_Bool bVal = *(sal_Bool*)rVal.getValue();
- // Vertikal und Horizontal sind mal getauscht worden!
+ // vertical and horizontal were swapped at some point
nMemberId &= ~CONVERT_TWIPS;
switch ( nMemberId )
{
diff --git a/sw/source/core/graphic/ndgrf.cxx b/sw/source/core/graphic/ndgrf.cxx
index 51797e71e60b..b95da0f26d2e 100644
--- a/sw/source/core/graphic/ndgrf.cxx
+++ b/sw/source/core/graphic/ndgrf.cxx
@@ -94,8 +94,12 @@ SwGrfNode::SwGrfNode( const SwNodeIndex & rWhere,
bGrafikArrived = sal_True;
}
-// Konstruktor fuer den SW/G-Reader. Dieser ctor wird verwendet,
-// wenn eine gelinkte Grafik gelesen wird. Sie liest diese NICHT ein.
+/** Create new SW/G reader.
+ *
+ * Use this ctor if you want to read a linked graphic.
+ *
+ * @note Does not read/open the image itself!
+ */
SwGrfNode::SwGrfNode( const SwNodeIndex & rWhere,
const String& rGrfName, const String& rFltName,
SwGrfFmtColl *pGrfColl,
@@ -123,7 +127,7 @@ SwGrfNode::SwGrfNode( const SwNodeIndex & rWhere,
if( INET_PROT_FILE == aUrl.GetProtocol() &&
FStatHelper::IsDocument( aUrl.GetMainURL( INetURLObject::NO_DECODE ) ))
{
- // File vorhanden, Verbindung herstellen ohne ein Update
+ // file exists, so create connection without an update
((SwBaseLink*)&refLink)->Connect();
}
}
@@ -141,15 +145,14 @@ sal_Bool SwGrfNode::ReRead(
OSL_ENSURE( pGraphic || pGrfObj || rGrfName.Len(),
"GraphicNode without a name, Graphic or GraphicObject" );
- // ReadRead mit Namen
+ // with name
if( refLink.Is() )
{
- OSL_ENSURE( !bInSwapIn, "ReRead: stehe noch im SwapIn" );
+ OSL_ENSURE( !bInSwapIn, "ReRead: I am still in SwapIn" );
if( rGrfName.Len() )
{
- // Besonderheit: steht im FltNamen DDE, handelt es sich um eine
- // DDE-gelinkte Grafik
+ // Note: If there is DDE in the FltName, than it is a DDE-linked graphic
String sCmd( rGrfName );
if( rFltName.Len() )
{
@@ -171,7 +174,7 @@ sal_Bool SwGrfNode::ReRead(
refLink->SetLinkSourceName( sCmd );
}
- else // kein Name mehr, Link aufheben
+ else // no name anymore, so remove link
{
GetDoc()->GetLinkManager().Remove( refLink );
refLink.Clear();
@@ -194,9 +197,8 @@ sal_Bool SwGrfNode::ReRead(
}
else
{
- // MIB 25.02.97: Daten der alten Grafik zuruecksetzen, damit
- // die korrekte Ersatz-Darstellung erscheint, wenn die
- // der neue Link nicht geladen werden konnte.
+ // reset data of the old graphic so that the correct placeholder is
+ // shown in case the new link could not be loaded
Graphic aGrf; aGrf.SetDefaultType();
maGrfObj.SetGraphic( aGrf, rGrfName );
@@ -242,17 +244,15 @@ sal_Bool SwGrfNode::ReRead(
maGrfObj.SetSwapState();
bReadGrf = sal_True;
}
- // Import einer Grafik:
- // Ist die Grafik bereits geladen?
+ // Was the graphic already loaded?
else if( !bNewGrf && GRAPHIC_NONE != maGrfObj.GetType() )
return sal_True;
-
else
{
if( HasStreamName() )
DelStreamName();
- // einen neuen Grafik-Link anlegen
+ // create new link for the graphic object
InsertLink( rGrfName, rFltName );
if( GetNodes().IsDocNodes() )
@@ -262,7 +262,7 @@ sal_Bool SwGrfNode::ReRead(
maGrfObj.SetGraphic( *pGraphic, rGrfName );
onGraphicChanged();
bReadGrf = sal_True;
- // Verbindung herstellen ohne ein Update; Grafik haben wir!
+ // create connection without update, as we have the graphic
((SwBaseLink*)&refLink)->Connect();
}
else if( pGrfObj )
@@ -271,14 +271,13 @@ sal_Bool SwGrfNode::ReRead(
maGrfObj.SetLink( rGrfName );
onGraphicChanged();
bReadGrf = sal_True;
- // Verbindung herstellen ohne ein Update; Grafik haben wir!
+ // create connection without update, as we have the graphic
((SwBaseLink*)&refLink)->Connect();
}
else
{
- // MIB 25.02.97: Daten der alten Grafik zuruecksetzen, damit
- // die korrekte Ersatz-Darstellung erscheint, wenn die
- // der neue Kink nicht geladen werden konnte.
+ // reset data of the old graphic so that the correct placeholder is
+ // shown in case the new link could not be loaded
Graphic aGrf; aGrf.SetDefaultType();
maGrfObj.SetGraphic( aGrf, rGrfName );
onGraphicChanged();
@@ -291,12 +290,12 @@ sal_Bool SwGrfNode::ReRead(
}
}
- // Bug 39281: Size nicht sofort loeschen - Events auf ImageMaps
- // sollten nicht beim Austauschen nicht ins "leere greifen"
+ // Bug 39281: Do not delete Size immediately - Events on ImageMaps should have
+ // something to work with when swapping
if( bSetTwipSize )
SetTwipSize( ::GetGraphicSizeTwip( maGrfObj.GetGraphic(), 0 ) );
- // erzeuge noch einen Update auf die Frames
+ // create an updates for the frames
if( bReadGrf && bNewGrf )
{
SwMsgPoolItem aMsgHint( RES_UPDATE_ATTR );
@@ -317,7 +316,7 @@ SwGrfNode::~SwGrfNode()
SwDoc* pDoc = GetDoc();
if( refLink.Is() )
{
- OSL_ENSURE( !bInSwapIn, "DTOR: stehe noch im SwapIn" );
+ OSL_ENSURE( !bInSwapIn, "DTOR: I am still in SwapIn" );
pDoc->GetLinkManager().Remove( refLink );
refLink->Disconnect();
}
@@ -335,8 +334,7 @@ SwGrfNode::~SwGrfNode()
// if( !pDoc->IsInDtor() && HasStreamName() )
// DelStreamName();
}
- //#39289# Die Frames muessen hier bereits geloescht weil der DTor der
- //Frms die Grafik noch fuer StopAnimation braucht.
+ //#39289# delete frames already here since the Frms' dtor needs the graphic for its StopAnimation
if( GetDepends() )
DelFrms();
}
@@ -433,7 +431,7 @@ SwGrfNode * SwNodes::MakeGrfNode( const SwNodeIndex & rWhere,
{
OSL_ENSURE( pGrfColl, "MakeGrfNode: Formatpointer ist 0." );
SwGrfNode *pNode;
- // Delayed erzeugen nur aus dem SW/G-Reader
+ // create object delayed, only from a SW/G-reader
if( bDelayed )
pNode = new SwGrfNode( rWhere, rGrfName,
rFltName, pGrfColl, pAutoAttr );
@@ -476,14 +474,14 @@ sal_Bool SwGrfNode::ImportGraphic( SvStream& rStrm )
return sal_False;
}
-// Returnwert:
-// -1 : ReRead erfolgreich
-// 0 : nicht geladen
-// 1 : Einlesen erfolgreich
-
+/**
+ * @return -1 if ReRead successful,
+ * 1 if reading successful,
+ * 0 if not loaded
+ */
short SwGrfNode::SwapIn( sal_Bool bWaitForData )
{
- if( bInSwapIn ) // nicht rekuriv!!
+ if( bInSwapIn ) // not recursively!
return !maGrfObj.IsSwappedOut();
short nRet = 0;
@@ -495,13 +493,13 @@ short SwGrfNode::SwapIn( sal_Bool bWaitForData )
if( GRAPHIC_NONE == maGrfObj.GetType() ||
GRAPHIC_DEFAULT == maGrfObj.GetType() )
{
- // noch nicht geladener Link
+ // link was not loaded yet
//TODO pLink->setInputStream(getInputStream());
if( pLink->SwapIn( bWaitForData ) )
nRet = -1;
else if( GRAPHIC_DEFAULT == maGrfObj.GetType() )
{
- // keine default Bitmap mehr, also neu Painten!
+ // no default bitmap anymore, thus re-paint
delete mpReplacementGraphic;
mpReplacementGraphic = 0;
@@ -512,7 +510,7 @@ short SwGrfNode::SwapIn( sal_Bool bWaitForData )
}
}
else if( maGrfObj.IsSwappedOut() ) {
- // nachzuladender Link
+ // link to download
//TODO pLink->setInputStream(getInputStream());
nRet = pLink->SwapIn( bWaitForData ) ? 1 : 0;
}
@@ -521,7 +519,7 @@ short SwGrfNode::SwapIn( sal_Bool bWaitForData )
}
else if( maGrfObj.IsSwappedOut() )
{
- // Die Grafik ist im Storage oder im TempFile drin
+ // graphic is in storage or in a temp file
if( !HasStreamName() )
nRet = (short)maGrfObj.SwapIn();
else
@@ -557,7 +555,7 @@ short SwGrfNode::SwapIn( sal_Bool bWaitForData )
}
else
nRet = 1;
- OSL_ENSURE( nRet, "Grafik kann nicht eingeswapt werden" );
+ OSL_ENSURE( nRet, "Cannot swap in graphic" );
if( nRet )
{
@@ -576,15 +574,14 @@ short SwGrfNode::SwapOut()
{
if( !refLink.Is() )
{
- // Das Swapping brauchen wir nur fuer Embedded Pictures
- // Die Grafik wird in eine TempFile geschrieben, wenn
- // sie frisch eingefuegt war, d.h. wenn es noch keinen
- // Streamnamen im Storage gibt.
+ // Swapping is only needed for embedded pictures.
+ // The graphic will be written into a temp file if it is new, i.e.
+ // if there is no stream name in the storage yet
if( !HasStreamName() )
if( !maGrfObj.SwapOut() )
return 0;
}
- // Geschriebene Grafiken oder Links werden jetzt weggeschmissen
+ // written graphics and links are removed here
return (short) maGrfObj.SwapOut( NULL );
}
return 1;
@@ -616,18 +613,20 @@ bool SwGrfNode::GetFileFilterNms( String* pFileNm, String* pFilterNm ) const
return bRet;
}
-// Eine Grafik Undo-faehig machen. Falls sie sich bereits in
-// einem Storage befindet, muss sie geladen werden.
+/** Make a graphic object ready for UNDO.
+ *
+ * If it is already in storage, it needs to be loaded.
+ */
sal_Bool SwGrfNode::SavePersistentData()
{
if( refLink.Is() )
{
- OSL_ENSURE( !bInSwapIn, "SavePersistentData: stehe noch im SwapIn" );
+ OSL_ENSURE( !bInSwapIn, "SavePersistentData: I am still in SwapIn" );
GetDoc()->GetLinkManager().Remove( refLink );
return sal_True;
}
- // Erst mal reinswappen, falls sie im Storage ist
+ // swap in first if already in storage
if( HasStreamName() && !SwapIn() )
return sal_False;
@@ -644,7 +643,7 @@ sal_Bool SwGrfNode::SavePersistentData()
// if( HasStreamName() )
// DelStreamName();
- // Und in TempFile rausswappen
+ // swap out into temp file
return (sal_Bool) SwapOut();
}
@@ -710,16 +709,15 @@ void SwGrfNode::ReleaseLink()
}
}
-
void SwGrfNode::SetTwipSize( const Size& rSz )
{
nGrfSize = rSz;
if( IsScaleImageMap() && nGrfSize.Width() && nGrfSize.Height() )
{
- // Image-Map an Grafik-Groesse anpassen
+ // resize Image-Map to size of the graphic
ScaleImageMap();
- // Image-Map nicht noch einmal skalieren
+ // do not re-scale Image-Map
SetScaleImageMap( sal_False );
}
}
@@ -729,7 +727,7 @@ void SwGrfNode::ScaleImageMap()
if( !nGrfSize.Width() || !nGrfSize.Height() )
return;
- // dann die Image-Map skalieren
+ // re-scale Image-Map
SwFrmFmt* pFmt = GetFlyFmt();
if( !pFmt )
@@ -753,7 +751,7 @@ void SwGrfNode::ScaleImageMap()
nWidth -= rBox.CalcLineSpace(BOX_LINE_LEFT) +
rBox.CalcLineSpace(BOX_LINE_RIGHT);
- OSL_ENSURE( nWidth>0, "Gibt es 0 twip breite Grafiken!?" );
+ OSL_ENSURE( nWidth>0, "Do any 0 twip wide graphics exist!?" );
if( nGrfSize.Width() != nWidth )
{
@@ -768,7 +766,7 @@ void SwGrfNode::ScaleImageMap()
nHeight -= rBox.CalcLineSpace(BOX_LINE_TOP) +
rBox.CalcLineSpace(BOX_LINE_BOTTOM);
- OSL_ENSURE( nHeight>0, "Gibt es 0 twip hohe Grafiken!?" );
+ OSL_ENSURE( nHeight>0, "Do any 0 twip high graphics exist!?" );
if( nGrfSize.Height() != nHeight )
{
@@ -784,12 +782,11 @@ void SwGrfNode::ScaleImageMap()
}
}
-
void SwGrfNode::DelStreamName()
{
if( HasStreamName() )
{
- // Dann die Grafik im Storage loeschen
+ // then remove graphic from storage
uno::Reference < embed::XStorage > xDocStg = GetDoc()->GetDocStorage();
if( xDocStg.is() )
{
@@ -936,7 +933,7 @@ void SwGrfNode::_GetStreamStorageNames( String& rStrmName,
SwCntntNode* SwGrfNode::MakeCopy( SwDoc* pDoc, const SwNodeIndex& rIdx ) const
{
- // kopiere die Formate in das andere Dokument:
+ // copy formats into the other document
SwGrfFmtColl* pColl = pDoc->CopyGrfColl( *GetGrfColl() );
Graphic aTmpGrf;
@@ -1058,12 +1055,12 @@ IMPL_LINK( SwGrfNode, SwapGraphic, GraphicObject*, pGrfObj )
return (long)pRet;
}
-// alle QuickDraw-Bitmaps eines speziellen Docs loeschen
+/// delete all QuickDraw-Bitmaps in the specified document
void DelAllGrfCacheEntries( SwDoc* pDoc )
{
if( pDoc )
{
- // alle Graphic-Links mit dem Namen aus dem Cache loeschen
+ // delete all Graphic-Links with this name from cache
const sfx2::LinkManager& rLnkMgr = pDoc->GetLinkManager();
const ::sfx2::SvBaseLinks& rLnks = rLnkMgr.GetLinks();
SwGrfNode* pGrfNd;