diff options
| author | Albert Thuswaldner <albert.thuswaldner@gmail.com> | 2011-03-11 15:39:32 +0530 |
|---|---|---|
| committer | Muthu Subramanian K <sumuthu@novell.com> | 2011-03-11 16:14:00 +0530 |
| commit | f5f7b4ef39034094546c176b884601fbc40dfcd6 (patch) | |
| tree | e8f5f7e52e24c3ff8ff6fcfef35b760546c4d8e1 | |
| parent | 5f7b3ed60471288983fc65194aafffdc32e6bd5c (diff) | |
Transalations (5)
31 files changed, 881 insertions, 1037 deletions
diff --git a/sfx2/source/appl/app.cxx b/sfx2/source/appl/app.cxx index 60d0f3a0478b..1f8b861cab3e 100644 --- a/sfx2/source/appl/app.cxx +++ b/sfx2/source/appl/app.cxx @@ -285,15 +285,16 @@ SfxApplication* SfxApplication::GetOrCreate() SfxApplication *pNew = new SfxApplication; //TODO/CLEANUP - //ist das Mutex-Handling OK? + // Is the Mutex-Handling OK? static ::osl::Mutex aProtector; ::osl::MutexGuard aGuard2( aProtector ); RTL_LOGFILE_CONTEXT( aLog, "sfx2 (mb93783) ::SfxApplication::SetApp" ); pApp = pNew; - // at the moment a bug may occur when Initialize_Impl returns FALSE, but this is only temporary because all code that may cause such a - // fault will be moved outside the SFX + // at the moment a bug may occur when Initialize_Impl returns FALSE, + // but this is only temporary because all code that may cause such + // a fault will be moved outside the SFX pApp->Initialize_Impl(); ::framework::SetImageProducer( GetImage ); @@ -341,7 +342,7 @@ SfxApplication::SfxApplication() #else if( !InitializeDde() ) { - ByteString aStr( "Kein DDE-Service moeglich. Fehler: " ); + ByteString aStr( "No DDE-Service possible. Error: " ); if( GetDdeService() ) aStr += ByteString::CreateFromInt32(GetDdeService()->GetError()); else @@ -384,16 +385,15 @@ SfxApplication::~SfxApplication() const String& SfxApplication::GetLastDir_Impl() const -/* [Beschreibung] +/* [Description] - Interne Methode, mit der im SFx das zuletzt mit der Methode - <SfxApplication::SetLastDir_Impl()> gesetzte Verzeichnis - zurueckgegeben wird. + Internal method by which the last set directory with the method + <SfxApplication::SetLastDir_Impl()> in SFX is returned. - Dieses ist i.d.R. das zuletzt durch den SfxFileDialog - angesprochene Verzeichnis. + This is usually the most recently addressed by the + SfxFileDialog directory. - [Querverweis] + [Cross-reference] <SfxApplication::SetLastDir_Impl()> */ @@ -403,11 +403,11 @@ const String& SfxApplication::GetLastDir_Impl() const const String& SfxApplication::GetLastSaveDirectory() const -/* [Beschreibung] +/* [Description] - Wie <SfxApplication::GetLastDir_Impl()>, nur extern + As <SfxApplication::GetLastDir_Impl()>, only external - [Querverweis] + [Cross-reference] <SfxApplication::GetLastDir_Impl()> */ @@ -419,15 +419,15 @@ const String& SfxApplication::GetLastSaveDirectory() const void SfxApplication::SetLastDir_Impl ( - const String& rNewDir /* kompletter Verzeichnis-Pfad als String */ + const String& rNewDir /* Complete directory path as a string * / ) -/* [Beschreibung] +/* [Description] - Interne Methode, mit der ein Verzeichnis-Pfad gesetzt wird, der - zuletzt (z.B. durch den SfxFileDialog) angesprochen wurde. + Internal Method, by which a directory path is set that was last addressed + (eg by the SfxFileDialog). - [Querverweis] + [Cross-reference] <SfxApplication::GetLastDir_Impl()> */ diff --git a/sfx2/source/appl/app.src b/sfx2/source/appl/app.src index e67059f2b33c..fa9d65a9fbf0 100644 --- a/sfx2/source/appl/app.src +++ b/sfx2/source/appl/app.src @@ -122,8 +122,8 @@ Resource BMP_SFX_COLOR SID_PASTE; // 060 SID_DELETE; // 061 SID_SELECTALL; // 062 - SID_SAVEDOC; // 063 vormals 046 - SID_EXITANDRETURN; // 064 vormals 054 + SID_SAVEDOC; // 063 was 046 + SID_EXITANDRETURN; // 064 was 054 SID_RECORDMACRO; // 095 SID_EDITMACRO; // 096 SID_HELPMENU; // 098 @@ -155,8 +155,8 @@ Resource BMP_SFX_MONO SID_PASTE; // 060 SID_DELETE; // 061 SID_SELECTALL; // 062 - SID_SAVEDOC; // 063 vormals 046 - SID_EXITANDRETURN; // 064 vormals 054 + SID_SAVEDOC; // 063 was 046 + SID_EXITANDRETURN; // 064 was 054 SID_RECORDMACRO; // 095 SID_EDITMACRO; // 096 SID_HELPMENU; // 098 diff --git a/sfx2/source/appl/appbas.cxx b/sfx2/source/appl/appbas.cxx index d57ad9c0f149..698514444ec7 100644 --- a/sfx2/source/appl/appbas.cxx +++ b/sfx2/source/appl/appbas.cxx @@ -148,7 +148,7 @@ SbxVariable* MakeVariable( StarBASIC *pBas, SbxObject *pObject, BasicManager* SfxApplication::GetBasicManager() { if ( pAppData_Impl->nBasicCallLevel == 0 ) - // sicherheitshalber + // precaution EnterBasicCall(); return BasicManagerRepository::getApplicationBasicManager( true ); @@ -194,7 +194,7 @@ void SfxApplication::EnterBasicCall() { DBG_TRACE( "SfxShellObject: BASIC-on-demand" ); - // zuerst das BASIC laden + // First load the BASIC GetBasic(); } } @@ -336,8 +336,8 @@ void SfxApplication::MacroExec_Impl( SfxRequest& rReq ) DBG_MEMTEST(); if ( SfxMacroConfig::IsMacroSlot( rReq.GetSlot() ) ) { - // SlotId referenzieren, damit nicht im Execute der Slot abgeschossen - // werden kann + // Create reference to SlotId, so that the excecute in the slot + // is not cancelled. GetMacroConfig()->RegisterSlotId(rReq.GetSlot()); SFX_REQUEST_ARG(rReq, pArgs, SfxStringItem, rReq.GetSlot(), sal_False); @@ -362,29 +362,29 @@ void SfxApplication::PlayMacro_Impl( SfxRequest &rReq, StarBASIC *pBasic ) EnterBasicCall(); sal_Bool bOK = sal_False; - // Makro und asynch-Flag + // Makro and asynch-Flag SFX_REQUEST_ARG(rReq,pMacro,SfxStringItem,SID_STATEMENT,sal_False); SFX_REQUEST_ARG(rReq,pAsynch,SfxBoolItem,SID_ASYNCHRON,sal_False); if ( pAsynch && pAsynch->GetValue() ) { - // asynchron ausf"uhren + // run asynchronously GetDispatcher_Impl()->Execute( SID_PLAYMACRO, SFX_CALLMODE_ASYNCHRON, pMacro, 0L ); rReq.Done(); } else if ( pMacro ) { - // Statement aufbereiten + // Process statement DBG_ASSERT( pBasic, "no BASIC found" ) ; String aStatement( '[' ); aStatement += pMacro->GetValue(); aStatement += ']'; - // P"aventiv den Request abschlie\sen, da er ggf. zerst"ort wird + // Finish the request preventatively because it maybe destroyed rReq.Done(); rReq.ReleaseArgs(); - // Statement ausf"uhren + // Process statement pBasic->Execute( aStatement ); bOK = 0 == SbxBase::GetError(); SbxBase::ResetError(); diff --git a/sfx2/source/appl/appcfg.cxx b/sfx2/source/appl/appcfg.cxx index 1f7613cc6756..d6ccd302b892 100644 --- a/sfx2/source/appl/appcfg.cxx +++ b/sfx2/source/appl/appcfg.cxx @@ -515,7 +515,7 @@ BOOL SfxApplication::IsSecureURL( const INetURLObject& rURL, const String* pRefe return SvtSecurityOptions().IsSecureURL( rURL.GetMainURL( INetURLObject::NO_DECODE ), *pReferer ); } //-------------------------------------------------------------------- -// TODO/CLEANUP: wieso zwei SetOptions Methoden? +// TODO/CLEANUP: Why two SetOptions Methods? void SfxApplication::SetOptions_Impl( const SfxItemSet& rSet ) { const SfxPoolItem *pItem = 0; @@ -603,14 +603,14 @@ void SfxApplication::SetOptions_Impl( const SfxItemSet& rSet ) aSaveOptions.SetDocInfoSave(((const SfxBoolItem *)pItem)->GetValue()); } - // offende Dokumente merken + // Mark open Documents if ( SFX_ITEM_SET == rSet.GetItemState(rPool.GetWhich(SID_ATTR_WORKINGSET), TRUE, &pItem)) { DBG_ASSERT(pItem->ISA(SfxBoolItem), "BoolItem expected"); aSaveOptions.SetSaveWorkingSet(((const SfxBoolItem *)pItem)->GetValue()); } - // Fenster-Einstellung speichern + // Save window settings if ( SFX_ITEM_SET == rSet.GetItemState(rPool.GetWhich(SID_ATTR_SAVEDOCVIEW), TRUE, &pItem)) { DBG_ASSERT(pItem->ISA(SfxBoolItem), "BoolItem expected"); @@ -695,16 +695,16 @@ void SfxApplication::SetOptions_Impl( const SfxItemSet& rSet ) USHORT nUndoCount = ((const SfxUInt16Item*)pItem)->GetValue(); aUndoOptions.SetUndoCount( nUndoCount ); - // um alle Undo-Manager zu erwischen: "uber alle Frames iterieren + // To catch all Undo-Managers: Iterate over all Frames for ( SfxViewFrame *pFrame = SfxViewFrame::GetFirst(); pFrame; pFrame = SfxViewFrame::GetNext(*pFrame) ) { - // den Dispatcher des Frames rausholen + // Get the Dispatcher of the Frames SfxDispatcher *pDispat = pFrame->GetDispatcher(); pDispat->Flush(); - // "uber alle SfxShells auf dem Stack des Dispatchers iterieren + // Iterate over all SfxShells on the Dispatchers Stack USHORT nIdx = 0; for ( SfxShell *pSh = pDispat->GetShell(nIdx); pSh; @@ -812,12 +812,12 @@ void SfxApplication::SetOptions_Impl( const SfxItemSet& rSet ) #endif } - // INet Session neu aufsetzen + // Set up INet Session again if ( bResetSession ) { } - // geaenderte Daten speichern + // Store changed data aInetOptions.flush(); } @@ -826,7 +826,7 @@ void SfxApplication::SetOptions(const SfxItemSet &rSet) { SvtPathOptions aPathOptions; - // Daten werden in DocInfo und IniManager gespeichert + // Data is saved in DocInfo and IniManager const SfxPoolItem *pItem = 0; SfxItemPool &rPool = GetPool(); @@ -925,7 +925,7 @@ void SfxApplication::SetOptions(const SfxItemSet &rSet) //-------------------------------------------------------------------- -// alle Dokumente speichern +// Save all Documents BOOL SfxApplication::SaveAll_Impl(BOOL bPrompt, BOOL bAutoSave) { @@ -996,7 +996,6 @@ SfxEventConfiguration* SfxApplication::GetEventConfig() const //-------------------------------------------------------------------- void SfxApplication::NotifyEvent( const SfxEventHint& rEventHint, bool bSynchron ) { - SfxObjectShell *pDoc = rEventHint.GetObjShell(); if ( pDoc && ( pDoc->IsPreview() || !pDoc->Get_Impl()->bInitialized ) ) return; diff --git a/sfx2/source/appl/appchild.cxx b/sfx2/source/appl/appchild.cxx index b53bb9e0e09d..204ef0bbf981 100644 --- a/sfx2/source/appl/appchild.cxx +++ b/sfx2/source/appl/appchild.cxx @@ -78,7 +78,7 @@ void SfxApplication::RegisterChildWindowContext_Impl( SfxModule *pMod, USHORT nI SfxChildWinFactory *pF = NULL; if ( pMod ) { - // Modul "ubergeben, ChildwindowFactory dort suchen + // Abandon Module, search there for ChildwindowFactory pFactories = pMod->GetChildWinFactories_Impl(); if ( pFactories ) { @@ -88,7 +88,7 @@ void SfxApplication::RegisterChildWindowContext_Impl( SfxModule *pMod, USHORT nI SfxChildWinFactory *pFac = (*pFactories)[nFactory]; if ( nId == pFac->nId ) { - // Factory gefunden, Context dort registrieren + // Factory found, registrer Context here. pF = pFac; break; } @@ -98,9 +98,9 @@ void SfxApplication::RegisterChildWindowContext_Impl( SfxModule *pMod, USHORT nI if ( !pF ) { - // Factory an der Application suchen - DBG_ASSERT( pAppData_Impl, "Keine AppDaten!" ); - DBG_ASSERT( pAppData_Impl->pFactArr, "Keine Factories!" ); + // Search for Factory in the Application + DBG_ASSERT( pAppData_Impl, "No AppData!" ); + DBG_ASSERT( pAppData_Impl->pFactArr, "No Factories!" ); pFactories = pAppData_Impl->pFactArr; USHORT nCount = pFactories->Count(); @@ -111,10 +111,10 @@ void SfxApplication::RegisterChildWindowContext_Impl( SfxModule *pMod, USHORT nI { if ( pMod ) { - // Wenn der Context von einem Modul registriert wurde, - // mu\s die ChildwindowFactory auch dort zur Verf"ugung - // stehen, sonst m"u\ste sich die Contextfactory im DLL-Exit - // wieder abmelden ! + // If the context of a module has been registered, then the + // ChildWindowFactory must also be available there, + // else the ContextFactory would have be unsubscribed on + // DLL-exit pF = new SfxChildWinFactory( pFac->pCtor, pFac->nId, pFac->nPos ); pMod->RegisterChildWindow( pF ); @@ -134,7 +134,7 @@ void SfxApplication::RegisterChildWindowContext_Impl( SfxModule *pMod, USHORT nI return; } - OSL_FAIL( "Kein ChildWindow fuer diesen Context!" ); + OSL_FAIL( "No ChildWindow for this Context!" ); } //-------------------------------------------------------------------- diff --git a/sfx2/source/appl/appdde.cxx b/sfx2/source/appl/appdde.cxx index b7151e768d14..03234cec803a 100644 --- a/sfx2/source/appl/appdde.cxx +++ b/sfx2/source/appl/appdde.cxx @@ -106,7 +106,6 @@ public: virtual BOOL Execute( const String* ); virtual BOOL StartAdviseLoop(); virtual BOOL MakeItem( const String& rItem ); - }; @@ -118,15 +117,14 @@ SV_IMPL_PTRARR( SfxDdeDocTopics_Impl, SfxDdeDocTopic_Impl *) BOOL SfxAppEvent_Impl( ApplicationEvent &rAppEvent, const String &rCmd, const String &rEvent ) -/* [Beschreibung] - - Pr"uft, ob 'rCmd' das Event 'rEvent' ist (ohne '(') und baut - aus diesem dann ein <ApplicationEvent> zusammen, das per - <Application::AppEvent()> ausgef"uhrt werden kann. Ist 'rCmd' das - angegegeben Event 'rEvent', dann wird TRUE zur"uckgegeben, sonst FALSE. +/* [Description] + Checks if 'rCmd' of the event 'rEvent' is (without '(') and then assemble + this data into a <ApplicationEvent>, which can be excecuted through + <Application::AppEvent()>. If 'rCmd' is the given event 'rEvent', then + TRUE is returned, otherwise FALSE. - [Beispiel] + [Example] rCmd = "Open(\"d:\doc\doc.sdw\")" rEvent = "Open" @@ -141,7 +139,7 @@ BOOL SfxAppEvent_Impl( ApplicationEvent &rAppEvent, aData.Erase( 0, aEvent.Len() ); if ( aData.Len() > 2 ) { - // in das ApplicationEvent-Format wandeln + // Transform into the ApplicationEvent Format aData.Erase( aData.Len()-1, 1 ); for ( USHORT n = 0; n < aData.Len(); ++n ) { @@ -165,32 +163,31 @@ BOOL SfxAppEvent_Impl( ApplicationEvent &rAppEvent, long SfxApplication::DdeExecute ( - const String& rCmd // in unserer BASIC-Syntax formuliert + const String& rCmd // Expressed in our BASIC-Syntax ) -/* [Beschreibung] +/* Description] - Diese Methode kann vom Applikationsentwickler "uberladen werden, - um an seine SfxApplication-Subklasse gerichtete DDE-Kommandos - zu empfangen. + This method can be overloaded by application developers, to receive + DDE-commands directed to thier SfxApplication subclass. - Die Basisimplementierung versteht die API-Funktionalit"at der - betreffenden SfxApplication-Subklasse in BASIC-Syntax. R"uckgabewerte - k"onnen dabei leider nicht "ubertragen werden. + The base implementation understands the API functionality of the + relevant SfxApplication subclass in BASIC syntax. Return values can + not be transferred, unfortunately. */ { - // Print oder Open-Event? + // Print or Open-Event? ApplicationEvent aAppEvent; if ( SfxAppEvent_Impl( aAppEvent, rCmd, DEFINE_CONST_UNICODE("Print") ) || SfxAppEvent_Impl( aAppEvent, rCmd, DEFINE_CONST_UNICODE("Open") ) ) GetpApp()->AppEvent( aAppEvent ); else { - // alle anderen per BASIC + // all others are BASIC EnterBasicCall(); StarBASIC* pBasic = GetBasic(); - DBG_ASSERT( pBasic, "Wo ist mein Basic???" ); + DBG_ASSERT( pBasic, "Where is the Basic???" ); SbxVariable* pRet = pBasic->Execute( rCmd ); LeaveBasicCall(); if( !pRet ) @@ -206,18 +203,17 @@ long SfxApplication::DdeExecute long SfxApplication::DdeGetData ( - const String&, // das anzusprechende Item + const String&, // the Item to be addressed const String&, // in: Format - ::com::sun::star::uno::Any& // out: angeforderte Daten + ::com::sun::star::uno::Any& // out: requested data ) -/* [Beschreibung] +/* [Description] - Diese Methode kann vom Applikationsentwickler "uberladen werden, - um an seine SfxApplication-Subklasse gerichtete DDE-Daten-Anforderungen - zu empfangen. + This method can be overloaded by application developers, to receive + DDE-data-requests directed to thier SfxApplication subclass. - Die Basisimplementierung liefert keine Daten und gibt 0 zur"uck. + The base implementation provides no data and returns 0. */ { @@ -228,18 +224,17 @@ long SfxApplication::DdeGetData long SfxApplication::DdeSetData ( - const String&, // das anzusprechende Item + const String&, // the Item to be addressed const String&, // in: Format - const ::com::sun::star::uno::Any& // out: angeforderte Daten + const ::com::sun::star::uno::Any& // out: requested data ) -/* [Beschreibung] +/* [Description] - Diese Methode kann vom Applikationsentwickler "uberladen werden, - um an seine SfxApplication-Subklasse gerichtete DDE-Daten - zu empfangen. + This method can be overloaded by application developers, to receive + DDE-data directed to thier SfxApplication subclass. - Die Basisimplementierung nimmt keine Daten entgegen und liefert 0 zur"uck. + The base implementation is not receiving any data and returns 0. */ { @@ -250,15 +245,15 @@ long SfxApplication::DdeSetData ::sfx2::SvLinkSource* SfxApplication::DdeCreateLinkSource ( - const String& // das zu erzeugende Item + const String& // the Item to be addressed ) -/* [Beschreibung] +/* [Description] - Diese Methode kann vom Applikationsentwickler "uberladen werden, - um an seiner SfxApplication-Subklasse einen DDE-Hotlink einzurichten + This method can be overloaded by application developers, to establish + a DDE-hotlink to thier SfxApplication subclass. - Die Basisimplementierung erzeugt keinen und liefert 0 zur"uck. + The base implementation is not generate a link and returns 0. */ { @@ -269,21 +264,20 @@ long SfxApplication::DdeSetData long SfxObjectShell::DdeExecute ( - const String& rCmd // in unserer BASIC-Syntax formuliert + const String& rCmd // Expressed in our BASIC-Syntax ) -/* [Beschreibung] +/* [Description] - Diese Methode kann vom Applikationsentwickler "uberladen werden, - um an seine SfxObjectShell-Subklasse gerichtete DDE-Kommandos - zu empfangen. + This method can be overloaded by application developers, to receive + DDE-commands directed to the thier SfxApplication subclass. - Die Basisimplementierung f"uhrt nichts aus und liefert 0 zur"uck. + The base implementation does nothing and returns 0. */ { StarBASIC* pBasic = GetBasic(); - DBG_ASSERT( pBasic, "Wo ist mein Basic???" ) ; + DBG_ASSERT( pBasic, "Where is the Basic???" ) ; SbxVariable* pRet = pBasic->Execute( rCmd ); if( !pRet ) { @@ -298,18 +292,17 @@ long SfxObjectShell::DdeExecute long SfxObjectShell::DdeGetData ( - const String&, // das anzusprechende Item + const String&, // the Item to be addressed const String&, // in: Format - ::com::sun::star::uno::Any& // out: angeforderte Daten + ::com::sun::star::uno::Any& // out: requested data ) -/* [Beschreibung] +/* [Description] - Diese Methode kann vom Applikationsentwickler "uberladen werden, - um an seine SfxObjectShell-Subklasse gerichtete DDE-Daten-Anforderungen - zu empfangen. + This method can be overloaded by application developers, to receive + DDE-data-requests directed to thier SfxApplication subclass. - Die Basisimplementierung liefert keine Daten und gibt 0 zur"uck. + The base implementation provides no data and returns 0. */ { @@ -320,18 +313,17 @@ long SfxObjectShell::DdeGetData long SfxObjectShell::DdeSetData ( - const String&, // das anzusprechende Item + const String&, // the Item to be addressed const String&, // in: Format - const ::com::sun::star::uno::Any& // out: angeforderte Daten + const ::com::sun::star::uno::Any& // out: requested data ) -/* [Beschreibung] +/* [Description] - Diese Methode kann vom Applikationsentwickler "uberladen werden, - um an seine SfxObjectShell-Subklasse gerichtete DDE-Daten - zu empfangen. + This method can be overloaded by application developers, to receive + DDE-data directed to thier SfxApplication subclass. - Die Basisimplementierung nimmt keine Daten entgegen und liefert 0 zur"uck. + The base implementation is not receiving any data and returns 0. */ { @@ -341,15 +333,15 @@ long SfxObjectShell::DdeSetData //-------------------------------------------------------------------- ::sfx2::SvLinkSource* SfxObjectShell::DdeCreateLinkSource ( - const String& // das zu erzeugende Item + const String& // the Item to be addressed ) -/* [Beschreibung] +/* [Description] - Diese Methode kann vom Applikationsentwickler "uberladen werden, - um an seiner SfxObjectShell-Subklasse einen DDE-Hotlink einzurichten + This method can be overloaded by application developers, to establish + a DDE-hotlink to thier SfxApplication subclass. - Die Basisimplementierung erzeugt keinen und liefert 0 zur"uck. + The base implementation is not generate a link and returns 0. */ { @@ -377,19 +369,18 @@ void SfxObjectShell::ReconnectDdeLinks(SfxObjectShell& rServer) long SfxViewFrame::DdeExecute ( - const String& rCmd // in unserer BASIC-Syntax formuliert + const String& rCmd // Expressed in our BASIC-Syntax ) -/* [Beschreibung] +/* [Description] - Diese Methode kann vom Applikationsentwickler "uberladen werden, - um an seine SfxViewFrame-Subklasse gerichtete DDE-Kommandos - zu empfangen. + This method can be overloaded by application developers, to receive + DDE-commands directed to the thier SfxApplication subclass. - Die Basisimplementierung versteht die API-Funktionalit"at des - betreffenden SfxViewFrame, der darin dargestellten SfxViewShell und - der betreffenden SfxObjectShell-Subklasse in BASIC-Syntax. - R"uckgabewerte k"onnen dabei leider nicht "ubertragen werden. + The base implementation understands the API functionality of the + relevant SfxViewFrame, which is shown and the relevant SfxViewShell + and the relevant SfxApplication subclass in BASIC syntax. Return + values can not be transferred, unfortunately. */ { @@ -403,18 +394,17 @@ long SfxViewFrame::DdeExecute long SfxViewFrame::DdeGetData ( - const String&, // das anzusprechende Item + const String&, // the Item to be addressed const String&, // in: Format - ::com::sun::star::uno::Any& // out: angeforderte Daten + ::com::sun::star::uno::Any& // out: requested data ) -/* [Beschreibung] +/* [Description] - Diese Methode kann vom Applikationsentwickler "uberladen werden, - um an seine SfxViewFrame-Subklasse gerichtete DDE-Daten-Anforderungen - zu empfangen. + This method can be overloaded by application developers, to receive + DDE-data-requests directed to thier SfxApplication subclass. - Die Basisimplementierung liefert keine Daten und gibt 0 zur"uck. + The base implementation provides no data and returns 0. */ { @@ -425,18 +415,17 @@ long SfxViewFrame::DdeGetData long SfxViewFrame::DdeSetData ( - const String& , // das anzusprechende Item - const String& , // in: Format - const ::com::sun::star::uno::Any& // out: angeforderte Daten + const String&, // the Item to be addressed + const String&, // in: Format + const ::com::sun::star::uno::Any& // out: requested data ) -/* [Beschreibung] +/* [Description] - Diese Methode kann vom Applikationsentwickler "uberladen werden, - um an seine SfxViewFrame-Subklasse gerichtete DDE-Daten - zu empfangen. + This method can be overloaded by application developers, to receive + DDE-data directed to thier SfxApplication subclass. - Die Basisimplementierung nimmt keine Daten entgegen und liefert 0 zur"uck. + The base implementation is not receiving any data and returns 0. */ { @@ -447,15 +436,15 @@ long SfxViewFrame::DdeSetData ::sfx2::SvLinkSource* SfxViewFrame::DdeCreateLinkSource ( - const String& // das zu erzeugende Item + const String& // the Item to be addressed ) -/* [Beschreibung] +/* [Description] - Diese Methode kann vom Applikationsentwickler "uberladen werden, - um an seiner SfxViewFrame-Subklasse einen DDE-Hotlink einzurichten + This method can be overloaded by application developers, to establish + a DDE-hotlink to thier SfxApplication subclass. - Die Basisimplementierung erzeugt keinen und liefert 0 zur"uck. + The base implementation is not generate a link and returns 0. */ { @@ -467,7 +456,7 @@ long SfxViewFrame::DdeSetData BOOL SfxApplication::InitializeDde() { DBG_ASSERT( !pAppData_Impl->pDdeService, - "Dde kann nicht mehrfach initialisiert werden" ); + "Dde can not be initialized multiple times" ); pAppData_Impl->pDdeService = new ImplDdeService( Application::GetAppName() ); int nError = pAppData_Impl->pDdeService->GetError(); @@ -475,10 +464,10 @@ BOOL SfxApplication::InitializeDde() { pAppData_Impl->pDocTopics = new SfxDdeDocTopics_Impl; - // wir wollen auf jedenfall RTF unterstuetzen! + // we certainly want to support RTF! pAppData_Impl->pDdeService->AddFormat( FORMAT_RTF ); - // Config-Pfad als Topic wegen Mehrfachstart + // Config path as a topic becauseof multiple starts INetURLObject aOfficeLockFile( SvtPathOptions().GetUserConfigPath() ); aOfficeLockFile.insertName( DEFINE_CONST_UNICODE( "soffice.lck" ) ); String aService( SfxDdeServiceName_Impl( @@ -503,19 +492,18 @@ void SfxAppData_Impl::DeInitDDE() void SfxApplication::AddDdeTopic( SfxObjectShell* pSh ) { - DBG_ASSERT( pAppData_Impl->pDocTopics, "es gibt gar keinen Dde-Service" ); - //OV: Im Serverbetrieb ist DDE abgeklemmt! + DBG_ASSERT( pAppData_Impl->pDocTopics, "There is no Dde-Service" ); + //OV: DDE is disconnected in server mode! if( !pAppData_Impl->pDocTopics ) return; - // doppeltes Eintragen verhindern + // prevent double submit String sShellNm; BOOL bFnd = FALSE; for( USHORT n = pAppData_Impl->pDocTopics->Count(); n; ) if( (*pAppData_Impl->pDocTopics)[ --n ]->pSh == pSh ) { - // falls das Document unbenannt wurde, ist trotzdem ein - // neues Topics anzulegen! + // If the document is untitled, is still a new Topic is created! if( !bFnd ) { bFnd = TRUE; @@ -534,8 +522,8 @@ void SfxApplication::AddDdeTopic( SfxObjectShell* pSh ) void SfxApplication::RemoveDdeTopic( SfxObjectShell* pSh ) { - DBG_ASSERT( pAppData_Impl->pDocTopics, "es gibt gar keinen Dde-Service" ); - //OV: Im Serverbetrieb ist DDE abgeklemmt! + DBG_ASSERT( pAppData_Impl->pDocTopics, "There is no Dde-Service" ); + //OV: DDE is disconnected in server mode! if( !pAppData_Impl->pDocTopics ) return; @@ -562,14 +550,14 @@ DdeService* SfxApplication::GetDdeService() BOOL ImplDdeService::MakeTopic( const String& rNm ) { - // Workaround gegen Event nach unserem Main() unter OS/2 - // passierte wenn man beim Beenden aus dem OffMgr die App neu startet + // Workaround for Event after Main() under OS/2 + // happens when exiting starts the App again if ( !Application::IsInExecute() ) return FALSE; - // das Topic rNm wird gesucht, haben wir es ? - // erstmal nur ueber die ObjectShells laufen und die mit dem - // Namen heraussuchen: + // The Topic rNm is sought, do we have it? + // First only loop over the ObjectShells to find those + // with the specific name: BOOL bRet = FALSE; String sNm( rNm ); sNm.ToLowerAscii(); @@ -579,7 +567,7 @@ BOOL ImplDdeService::MakeTopic( const String& rNm ) { String sTmp( pShell->GetTitle(SFX_TITLE_FULLNAME) ); sTmp.ToLowerAscii(); - if( sTmp == sNm ) // die wollen wir haben + if( sTmp == sNm ) { SFX_APP()->AddDdeTopic( pShell ); bRet = TRUE; @@ -595,9 +583,7 @@ BOOL ImplDdeService::MakeTopic( const String& rNm ) if ( aWorkPath.GetNewAbsURL( rNm, &aFile ) && SfxContentHelper::IsDocument( aFile.GetMainURL( INetURLObject::NO_DECODE ) ) ) { - // File vorhanden - - // dann versuche die Datei zu laden: + // File exists? then try to load it: SfxStringItem aName( SID_FILE_NAME, aFile.GetMainURL( INetURLObject::NO_DECODE ) ); SfxBoolItem aNewView(SID_OPEN_NEW_VIEW, TRUE); @@ -706,7 +692,7 @@ BOOL SfxDdeDocTopic_Impl::StartAdviseLoop() ::sfx2::SvLinkSource* pNewObj = pSh->DdeCreateLinkSource( GetCurItem() ); if( pNewObj ) { - // dann richten wir auch einen entsprechenden SvBaseLink ein + // then we also establish a corresponding SvBaseLink String sNm, sTmp( Application::GetAppName() ); ::sfx2::MakeLnkName( sNm, &sTmp, pSh->GetTitle(SFX_TITLE_FULLNAME), GetCurItem() ); new ::sfx2::SvBaseLink( sNm, OBJECT_DDE_EXTERN, pNewObj ); diff --git a/sfx2/source/appl/appinit.cxx b/sfx2/source/appl/appinit.cxx index 1bb0ddca965a..57d87b800d45 100644 --- a/sfx2/source/appl/appinit.cxx +++ b/sfx2/source/appl/appinit.cxx @@ -256,8 +256,8 @@ bool SfxApplication::Initialize_Impl() #ifdef DBG_UTIL - // Der SimplerErrorHandler dient Debugzwecken. In der Product werden - // nichtgehandelte Fehler durch Errorcode 1 an SFX gegeben. + // The SimplerErrorHandler is for debugging. In the Product errors + // not processed are given to SFX as Errorcode 1. new SimpleErrorHandler; #endif new SfxErrorHandler(RID_ERRHDL, ERRCODE_AREA_TOOLS, ERRCODE_AREA_LIB1); diff --git a/sfx2/source/appl/appmain.cxx b/sfx2/source/appl/appmain.cxx index e255bf219fc9..854499bdd89d 100644 --- a/sfx2/source/appl/appmain.cxx +++ b/sfx2/source/appl/appmain.cxx @@ -98,18 +98,19 @@ void SfxApplication::Init ( ) -/* [Beschreibung] - - Diese virtuelle Methode wird vom SFx aus Application:a:Main() gerufen, - bevor Execute() ausgef"uhrt wird und - - das Intro bereits angezeigt ist, - - das Applikationsfenster exisitiert, aber noch hidden ist, - - die Bindings bereits existieren (Controller sind anmeldbar), - - der Ini- und Config-Manager bereits existiert, - - die Standard-Controller bereits exisitieren, - - die SFx-Shells ihre Interfaces bereits registriert haben. - - [Querverweise] +/* [Description] + + This virtual method is called from SFx through Application::Main(), + before Execute() is called and: + - the Intro is already displayed, + - the Applications window exists, but it is still hidden, + - the Bindings already exist (Controller can be registered), + - the Init and Config-Manager already exists, + - the Standard-Controller already exists, + - the SFx-Shells have alredy registered their Interfaces. + + [Cross-reference] + <SfxApplication::Exit()> <SfxApplication::OpenClients()> */ @@ -120,7 +121,7 @@ void SfxApplication::Init #else if( !InitializeDde() ) { - ByteString aStr( "Kein DDE-Service moeglich. Fehler: " ); + ByteString aStr( "No DDE-Service possible. Error: " ); if( GetDdeService() ) aStr += GetDdeService()->GetError(); else @@ -135,17 +136,17 @@ void SfxApplication::Init void SfxApplication::Exit() -/* [Beschreibung] +/* [Description] - Diese virtuelle Methode wird vom SFx aus Application::Main() gerufen, - nachdem Execute() beendet ist und - - die Konfiguration (SfxConfigManager) bereits gespeichert wurde, - - die Fensterpostionen etc. in den SfxIniManager geschrieben wurden, - - das Applikationsfenster noch existiert, aber hidden ist - - s"amtliche Dokumente und deren Views bereits geschlossen sind. - - Dispatcher, Bindings etc. bereits zerst"ort sind + This virtual method is called from SFx through Application::Main(), + after Execute() has finished and + - the configuration (SfxConfigManager) was already saved, + - the window postions etc. in the SfxIniManager were written, + - the Application widow still exists, but is hidden + - all Documents and their Views already are closed. + - Dispatcher, Bindings etc. already destroyed. - [Querverweise] + [Cross-reference] <SfxApplication::Init(int,char*[])> */ @@ -162,14 +163,14 @@ void SfxApplication::PreInit( ) bool SfxApplication::InitLabelResMgr( const char* _pLabelPrefix, bool _bException ) { bool bRet = false; - // Label-DLL mit diversen Resourcen fuer OEM-Ver. etc. (Intro, Titel, About) + // Label-DLL with various resources for OEM-Ver. etc. (Intro, Titel, About) DBG_ASSERT( _pLabelPrefix, "Wrong initialisation!" ); if ( _pLabelPrefix ) { - // versuchen, die Label-DLL zu erzeugen + // try to create the Label-DLL pAppData_Impl->pLabelResMgr = CreateResManager( _pLabelPrefix ); - // keine separate Label-DLL vorhanden? + // no separate label-DLL available? if ( !pAppData_Impl->pLabelResMgr ) { if ( _bException ) diff --git a/sfx2/source/appl/appmisc.cxx b/sfx2/source/appl/appmisc.cxx index 66ba1dcb3821..50db1ffb8669 100644 --- a/sfx2/source/appl/appmisc.cxx +++ b/sfx2/source/appl/appmisc.cxx @@ -186,13 +186,12 @@ void SfxApplication::InitializeDisplayName_Impl() //-------------------------------------------------------------------- SfxProgress* SfxApplication::GetProgress() const -/* [Beschreibung] +/* [Description] - Liefert den f"ur die gesamte Applikation laufenden SfxProgress - oder 0, falls keiner f"ur die gesamte Applikation l"auft. + Returns the running SfxProgress for the entire application or 0 if + none is running for the entire application. - - [Querverweise] + [Cross-reference] <SfxProgress::GetActiveProgress(SfxViewFrame*)> <SfxViewFrame::GetProgress()const> @@ -210,7 +209,7 @@ SvUShorts* SfxApplication::GetDisabledSlotList_Impl() SvUShorts* pList = pAppData_Impl->pDisabledSlotList; if ( !pList ) { - // Gibt es eine Slotdatei ? + // Is there a slot file? INetURLObject aUserObj( SvtPathOptions().GetUserConfigPath() ); aUserObj.insertName( DEFINE_CONST_UNICODE( "slots.cfg" ) ); SvStream* pStream = ::utl::UcbStreamHelper::CreateStream( aUserObj.GetMainURL( INetURLObject::NO_DECODE ), STREAM_STD_READ ); @@ -226,7 +225,7 @@ SvUShorts* SfxApplication::GetDisabledSlotList_Impl() BOOL bSlots = ( pStream && !pStream->GetError() ); if( bSlots && bSlotsEnabled ) { - // SlotDatei einlesen + // Read Slot file String aTitle; pStream->ReadByteString(aTitle); if ( aTitle.CompareToAscii("SfxSlotFile" ) == COMPARE_EQUAL ) @@ -246,21 +245,20 @@ SvUShorts* SfxApplication::GetDisabledSlotList_Impl() pStream->ReadByteString(aTitle); if ( aTitle.CompareToAscii("END" ) != COMPARE_EQUAL || pStream->GetError() ) { - // Lesen schief gegangen + // Read failed DELETEZ( pList ); bError = sal_True; } } else { - // Streamerkennung fehlgeschlagen + // Stream detection failure bError = sal_True; } } else if ( bSlots != bSlotsEnabled ) { - // Wenn kein Slotlist-Eintrag, dann darf auch keine SlotDatei - // vorhanden sein + // If no slot list entry, then no slot file shall exist bError = sal_True; } @@ -276,9 +274,9 @@ SvUShorts* SfxApplication::GetDisabledSlotList_Impl() if ( bError ) { - // Wenn ein Sloteintrag vorhanden ist, aber keine oder eine fehlerhafte - // SlotDatei, oder aber eine Slotdatei, aber kein Sloteintrag, dann - // gilt dies als fehlerhafte Konfiguration + // If an entry slot is present, but no or faulty slot file, or a slot + // file, but no slot entry, then this is considered to be a + // misconfiguration new SfxSpecialConfigError_Impl( String( SfxResId( RID_SPECIALCONFIG_ERROR ) ) ); } diff --git a/sfx2/source/appl/appopen.cxx b/sfx2/source/appl/appopen.cxx index f2875b27e253..25381e4571e9 100644 --- a/sfx2/source/appl/appopen.cxx +++ b/sfx2/source/appl/appopen.cxx @@ -153,45 +153,45 @@ void SAL_CALL SfxOpenDocStatusListener_Impl::disposing( const EventObject& ) thr SfxObjectShellRef SfxApplication::DocAlreadyLoaded ( - const String& rName, // Name des Dokuments mit Pfad - BOOL bSilent, // TRUE: nicht nach neuer Sicht fragen - BOOL bActivate, // soll bestehende Sicht aktiviert werden + const String& rName, // Name of Documents including path + BOOL bSilent, // TRUE: do not ask for a new view + BOOL bActivate, // existing view to be activated BOOL bForbidVisible, const String* pPostStr ) -/* [Beschreibung] +/* [Description] - Stellt fest, ob ein Dokument mit dem Namen 'rName' bereits geladen - ist und liefert einen Pointer darauf zu"uck. + Determines whether a document with the name 'rName' already is loaded and + returns a pointer to this document. - Ist das Dokument noch nicht geladen, wird ein 0-Pointer zur"uckgeliefert. + If the document is not loaded, a 0-pointer is returned. */ { - // zu suchenden Namen als URL aufbereiten + // prepare to search for names as URL INetURLObject aUrlToFind( rName ); DBG_ASSERT( aUrlToFind.GetProtocol() != INET_PROT_NOT_VALID, "Invalid URL" ); String aPostString; if ( pPostStr ) aPostString = *pPostStr; - // noch offen? + // still open? SfxObjectShellRef xDoc; if ( !aUrlToFind.HasError() ) { - // dann bei den normal geoeffneten Docs + // then with the normally open Documents if ( !xDoc.Is() ) { - xDoc = SfxObjectShell::GetFirst( 0, FALSE ); // auch hidden Docs + xDoc = SfxObjectShell::GetFirst( 0, FALSE ); // also hidden Documents while( xDoc.Is() ) { if ( xDoc->GetMedium() && xDoc->GetCreateMode() == SFX_CREATE_MODE_STANDARD && !xDoc->IsAbortingImport() && !xDoc->IsLoading() ) { - // Vergleiche anhand der URLs + // Comparisons between URLs INetURLObject aUrl( xDoc->GetMedium()->GetName() ); if ( !aUrl.HasError() && aUrl == aUrlToFind && (!bForbidVisible || !SfxViewFrame::GetFirst( xDoc, TRUE )) && @@ -205,11 +205,10 @@ SfxObjectShellRef SfxApplication::DocAlreadyLoaded } } - // gefunden? + // Found? if ( xDoc.Is() && bActivate ) { - DBG_ASSERT( - !bForbidVisible, "Unsichtbares kann nicht aktiviert werden" ); + DBG_ASSERT(!bForbidVisible, "Invisible can not be enabled" ); SfxViewFrame* pFrame; for( pFrame = SfxViewFrame::GetFirst( xDoc ); @@ -289,17 +288,16 @@ private: sal_uInt32 CheckPasswd_Impl ( SfxObjectShell* pDoc, - SfxItemPool& /*rPool*/, // Pool, falls ein Set erzeugt werden mus - SfxMedium* pFile // das Medium, dessen Passwort gfs. erfragt werden soll + SfxItemPool& /*rPool*/, // Pool, if a Set has to be created + SfxMedium* pFile // the Medium and its Password shold be obtained ) -/* [Beschreibung] +/* [Description] - Zu einem Medium das Passwort erfragen; funktioniert nur, wenn es sich - um einen Storage handelt. - Wenn in der Documentinfo das Passwort-Flag gesetzt ist, wird - das Passwort vom Benutzer per Dialog erfragt und an dem Set - des Mediums gesetzt; das Set wird, wenn nicht vorhanden, erzeugt. + Ask for the password for a medium, only works if it concerns storage. + If the password flag is set in the Document Info, then the password is + requested through a user dialogue and the set at the Set of the medium. + If the set does not exist the it is created. */ { ULONG nRet = ERRCODE_NONE; @@ -542,7 +540,7 @@ void SfxApplication::NewDocExec_Impl( SfxRequest& rReq ) { DBG_MEMTEST(); - // keine Parameter vom BASIC nur Factory angegeben? + // No Parameter from BASIC only Factory given? SFX_REQUEST_ARG(rReq, pTemplNameItem, SfxStringItem, SID_TEMPLATE_NAME, FALSE); SFX_REQUEST_ARG(rReq, pTemplFileNameItem, SfxStringItem, SID_FILE_NAME, FALSE); SFX_REQUEST_ARG(rReq, pTemplRegionNameItem, SfxStringItem, SID_TEMPLATE_REGIONNAME, FALSE); @@ -550,7 +548,7 @@ void SfxApplication::NewDocExec_Impl( SfxRequest& rReq ) SfxObjectShellLock xDoc; String aTemplateRegion, aTemplateName, aTemplateFileName; - BOOL bDirect = FALSE; // "uber FileName anstelle Region/Template + BOOL bDirect = FALSE; // through FileName instead of Region/Template SfxErrorContext aEc(ERRCTX_SFX_NEWDOC); if ( !pTemplNameItem && !pTemplFileNameItem ) { @@ -786,8 +784,8 @@ void SfxApplication::OpenDocExec_Impl( SfxRequest& rReq ) rReq.RemoveItem( SID_FILE_NAME ); rReq.AppendItem( SfxStringItem( SID_FILE_NAME, aURL ) ); - // synchron ausf"uhren, damit beim Reschedulen nicht schon das n"achste Dokument - // geladen wird + // Run synchronous, so that not the next document is loaded + // when rescheduling // TODO/LATER: use URLList argument and always remove one document after another, each step in asychronous execution, until finished // but only if reschedule is a problem GetDispatcher_Impl()->Execute( SID_OPENDOC, SFX_CALLMODE_SYNCHRON, *rReq.GetArgs() ); diff --git a/sfx2/source/appl/appquit.cxx b/sfx2/source/appl/appquit.cxx index de1b791de8e7..4635c8260054 100644 --- a/sfx2/source/appl/appquit.cxx +++ b/sfx2/source/appl/appquit.cxx @@ -75,10 +75,10 @@ BOOL SfxApplication::QueryExit_Impl() { BOOL bQuit = TRUE; - // will trotzdem noch jemand, den man nicht abschiessen kann, die App haben? + // Does some instance, that can not be shut down, still require the app? if ( !bQuit ) { - // nicht wirklich beenden, nur minimieren + // Not really exit, only minimize InfoBox aInfoBox( NULL, SfxResId(MSG_CANT_QUIT) ); aInfoBox.Execute(); DBG_TRACE( "QueryExit => FALSE (in use)" ); @@ -97,14 +97,14 @@ void SfxApplication::Deinitialize() StarBASIC::Stop(); - // ggf. BASIC speichern + // Save BASIC if possible BasicManager* pBasMgr = BasicManagerRepository::getApplicationBasicManager( false ); if ( pBasMgr && pBasMgr->IsModified() ) SaveBasicManager(); SaveBasicAndDialogContainer(); - pAppData_Impl->bDowning = TRUE; // wegen Timer aus DecAliveCount und QueryExit + pAppData_Impl->bDowning = TRUE; // due to Timer from DecAliveCount and QueryExit DELETEZ( pAppData_Impl->pTemplates ); @@ -125,8 +125,8 @@ void SfxApplication::Deinitialize() // call derived application-exit Exit(); - // Controller u."a. freigeben - // dabei sollten auch restliche Komponenten ( Beamer! ) verschwinden + // Release Controller and others + // then the remaining components should alse disapear ( Beamer! ) BasicManagerRepository::resetApplicationBasicManager(); pAppData_Impl->pBasicManager->reset( NULL ); // this will also delete pBasMgr @@ -140,7 +140,7 @@ void SfxApplication::Deinitialize() SfxResId::DeleteResMgr(); DELETEZ(pAppData_Impl->pOfaResMgr); - // ab hier d"urfen keine SvObjects mehr existieren + // from here no SvObjects have to exists DELETEZ(pAppData_Impl->pMatcher); delete pAppData_Impl->pLabelResMgr; diff --git a/sfx2/source/appl/appreg.cxx b/sfx2/source/appl/appreg.cxx index 0d20fcc35295..f80f3895d6e5 100644 --- a/sfx2/source/appl/appreg.cxx +++ b/sfx2/source/appl/appreg.cxx @@ -92,7 +92,7 @@ void SfxApplication::RegisterToolBoxControl_Impl( SfxModule *pMod, SfxTbxCtrlFac if ( pF->nTypeId && pF->nTypeId == pFact->nTypeId && (pF->nSlotId == pFact->nSlotId || pF->nSlotId == 0) ) { - DBG_WARNING("TbxController-Registrierung ist nicht eindeutig!"); + DBG_WARNING("TbxController registration is not clearly defined!"); } } #endif @@ -117,7 +117,7 @@ void SfxApplication::RegisterStatusBarControl_Impl( SfxModule *pMod, SfxStbCtrlF if ( pF->nTypeId && pF->nTypeId == pFact->nTypeId && (pF->nSlotId == pFact->nSlotId || pF->nSlotId == 0) ) { - DBG_WARNING("StbController-Registrierung ist nicht eindeutig!"); + DBG_WARNING("StbController registration is not clearly defined!"); } } #endif @@ -142,7 +142,7 @@ void SfxApplication::RegisterMenuControl_Impl( SfxModule *pMod, SfxMenuCtrlFacto if ( pF->nTypeId && pF->nTypeId == pFact->nTypeId && (pF->nSlotId == pFact->nSlotId || pF->nSlotId == 0) ) { - DBG_WARNING("MenuController-Registrierung ist nicht eindeutig!"); + DBG_WARNING("MenuController register is not clearly defined!"); } } #endif diff --git a/sfx2/source/appl/appserv.cxx b/sfx2/source/appl/appserv.cxx index 46846329d74c..ead5de75cc37 100644 --- a/sfx2/source/appl/appserv.cxx +++ b/sfx2/source/appl/appserv.cxx @@ -267,7 +267,7 @@ void SfxApplication::MiscExec_Impl( SfxRequest& rReq ) // if terminate() was successful, SfxApplication is now dead! pAppData_Impl->bInQuit = FALSE; - // Returnwert setzten, ggf. terminieren + // Set return value, terminate if possible rReq.SetReturnValue( SfxBoolItem( rReq.GetSlot(), bTerminated ) ); return; } @@ -440,13 +440,12 @@ void SfxApplication::MiscExec_Impl( SfxRequest& rReq ) // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - case SID_HELPTIPS: { - // Parameter aus werten + // Evaluate Parameter SFX_REQUEST_ARG(rReq, pOnItem, SfxBoolItem, SID_HELPTIPS, FALSE); bool bOn = pOnItem ? ((SfxBoolItem*)pOnItem)->GetValue() : !Help::IsQuickHelpEnabled(); - // ausf"uhren if ( bOn ) Help::EnableQuickHelp(); else @@ -455,7 +454,7 @@ void SfxApplication::MiscExec_Impl( SfxRequest& rReq ) Invalidate(SID_HELPTIPS); bDone = true; - // ggf. recorden + // Record if possible if ( !rReq.IsAPI() ) rReq.AppendItem( SfxBoolItem( SID_HELPTIPS, bOn) ); break; @@ -468,13 +467,12 @@ void SfxApplication::MiscExec_Impl( SfxRequest& rReq ) } case SID_HELPBALLOONS: { - // Parameter auswerten + // Evaluate Parameter SFX_REQUEST_ARG(rReq, pOnItem, SfxBoolItem, SID_HELPBALLOONS, FALSE); bool bOn = pOnItem ? ((SfxBoolItem*)pOnItem)->GetValue() : !Help::IsBalloonHelpEnabled(); - // ausf"uhren if ( bOn ) Help::EnableBalloonHelp(); else @@ -483,7 +481,7 @@ void SfxApplication::MiscExec_Impl( SfxRequest& rReq ) Invalidate(SID_HELPBALLOONS); bDone = true; - // ggf. recorden + // Record if possible if ( !rReq.IsAPI() ) rReq.AppendItem( SfxBoolItem( SID_HELPBALLOONS, bOn) ); break; @@ -676,7 +674,7 @@ void SfxApplication::MiscExec_Impl( SfxRequest& rReq ) rtl::OUStringBuffer aBuf( aToolbarResName ); aBuf.append( pToolbarName->GetValue() ); - // Parameter auswerten + // Evaluate Parameter rtl::OUString aToolbarName( aBuf.makeStringAndClear() ); BOOL bShow( !xLayoutManager->isElementVisible( aToolbarName )); @@ -710,7 +708,7 @@ void SfxApplication::MiscState_Impl(SfxItemSet &rSet) LocaleDataWrapper aLocaleWrapper( ::comphelper::getProcessServiceFactory(), Application::GetSettings().GetLocale() ); const USHORT *pRanges = rSet.GetRanges(); - DBG_ASSERT(pRanges && *pRanges, "Set ohne Bereich"); + DBG_ASSERT(pRanges && *pRanges, "Set without range"); while ( *pRanges ) { for(USHORT nWhich = *pRanges++; nWhich <= *pRanges; ++nWhich) @@ -1413,7 +1411,7 @@ void SfxApplication::OfaExec_Impl( SfxRequest& rReq ) void SfxApplication::OfaState_Impl(SfxItemSet &rSet) { const USHORT *pRanges = rSet.GetRanges(); - DBG_ASSERT(pRanges && *pRanges, "Set ohne Bereich"); + DBG_ASSERT(pRanges && *pRanges, "Set without Region"); while ( *pRanges ) { for(USHORT nWhich = *pRanges++; nWhich <= *pRanges; ++nWhich) diff --git a/sfx2/source/appl/childwin.cxx b/sfx2/source/appl/childwin.cxx index 564994856ff0..149cf8d96add 100644 --- a/sfx2/source/appl/childwin.cxx +++ b/sfx2/source/appl/childwin.cxx @@ -213,8 +213,8 @@ SfxChildWindow* SfxChildWindow::CreateChildWindow( sal_uInt16 nId, SfxChildWinFactory* pFact=0; sal_uInt16 nOldMode = Application::GetSystemWindowMode(); - // Zuerst ChildWindow im SDT suchen; "Uberlagerungen m"ussen mit einem - // ChildWindowContext realisiert werden + // First search for ChildWindow in SDT; "Overloading has to be realized + // by using ChildWindowContext SfxApplication *pApp = SFX_APP(); { SfxChildWinFactArr_Impl &rFactories = pApp->GetChildWinFactories_Impl(); @@ -276,12 +276,12 @@ SfxChildWindow* SfxChildWindow::CreateChildWindow( sal_uInt16 nId, if ( pChild ) pChild->SetFactory_Impl( pFact ); - DBG_ASSERT(pFact && (pChild || !rInfo.bVisible), "ChildWindow-Typ nicht registriert!"); + DBG_ASSERT(pFact && (pChild || !rInfo.bVisible), "ChildWindow-Typ not registered!"); if ( pChild && !pChild->pWindow ) { DELETEZ(pChild); - DBG_WARNING("ChildWindow hat kein Fenster!"); + DBG_WARNING("ChildWindow has no Window!"); } return pChild; @@ -392,15 +392,15 @@ void SfxChildWindow::InitializeChildWinFactory_Impl( sal_uInt16 nId, SfxChildWin if ( aWinData.Len() ) { - // Nach Versionskennung suchen + // Search for version ID if ( aWinData.GetChar((sal_uInt16)0) != 0x0056 ) // 'V' = 56h - // Keine Versionskennung, daher nicht verwenden + // A version ID, so do not use return; - // 'V' l"oschen + // Delete 'V' aWinData.Erase(0,1); - // Version lesen + // Read version char cToken = ','; sal_uInt16 nPos = aWinData.Search( cToken ); sal_uInt16 nActVersion = (sal_uInt16)aWinData.Copy( 0, nPos + 1 ).ToInt32(); @@ -409,7 +409,7 @@ void SfxChildWindow::InitializeChildWinFactory_Impl( sal_uInt16 nId, SfxChildWin aWinData.Erase(0,nPos+1); - // Sichtbarkeit laden: ist als ein char codiert + // Load Visibility: is coded as a char rInfo.bVisible = (aWinData.GetChar(0) == 0x0056); // 'V' = 56h aWinData.Erase(0,1); nPos = aWinData.Search( cToken ); @@ -418,7 +418,7 @@ void SfxChildWindow::InitializeChildWinFactory_Impl( sal_uInt16 nId, SfxChildWin USHORT nNextPos = aWinData.Search( cToken, 2 ); if ( nNextPos != STRING_NOTFOUND ) { - // es gibt noch Extra-Information + // there is extra information rInfo.nFlags = (sal_uInt16)aWinData.Copy( nPos+1, nNextPos - nPos - 1 ).ToInt32(); aWinData.Erase( nPos, nNextPos-nPos+1 ); rInfo.aExtraString = aWinData; @@ -447,7 +447,7 @@ void SfxChildWindow::CreateContext( sal_uInt16 nContextId, SfxBindings& rBinding pFact = rFactories[nFactory]; if ( pFact->nId == GetType() ) { - DBG_ASSERT( pFact->pArr, "Kein Kontext angemeldet!" ); + DBG_ASSERT( pFact->pArr, "No context registered!" ); if ( !pFact->pArr ) break; @@ -479,7 +479,7 @@ void SfxChildWindow::CreateContext( sal_uInt16 nContextId, SfxBindings& rBinding pFact = rFactories[nFactory]; if ( pFact->nId == GetType() ) { - DBG_ASSERT( pFact->pArr, "Kein Kontext angemeldet!" ); + DBG_ASSERT( pFact->pArr, "No context registered!" ); if ( !pFact->pArr ) break; @@ -504,7 +504,7 @@ void SfxChildWindow::CreateContext( sal_uInt16 nContextId, SfxBindings& rBinding if ( !pCon ) { - OSL_FAIL( "Kein geeigneter Context gefunden!" ); + OSL_FAIL( "No suitable context found! "); return; } @@ -539,7 +539,7 @@ FloatingWindow* SfxChildWindowContext::GetFloatingWindow() const } else { - OSL_FAIL("Kein FloatingWindow-Context!"); + OSL_FAIL("No FloatingWindow-Context!"); return NULL; } } @@ -613,7 +613,7 @@ sal_Bool SfxChildWinInfo::GetExtraData_Impl sal_uInt16 *pPos ) const { - // ung"ultig? + // invalid? if ( !aExtraString.Len() ) return sal_False; String aStr; @@ -621,8 +621,8 @@ sal_Bool SfxChildWinInfo::GetExtraData_Impl if ( nPos == STRING_NOTFOUND ) return sal_False; - // Versuche, den Alignment-String "ALIGN:(...)" einzulesen; wenn - // er nicht vorhanden ist, liegt eine "altere Version vor + // Try to read the alignment string "ALIGN :(...)", but if + // it is not present, then use an older version if ( nPos != STRING_NOTFOUND ) { sal_uInt16 n1 = aExtraString.Search('(', nPos); @@ -631,20 +631,20 @@ sal_Bool SfxChildWinInfo::GetExtraData_Impl sal_uInt16 n2 = aExtraString.Search(')', n1); if ( n2 != STRING_NOTFOUND ) { - // Alignment-String herausschneiden + // Cut out Alignment string aStr = aExtraString.Copy(nPos, n2 - nPos + 1); aStr.Erase(nPos, n1-nPos+1); } } } - // Zuerst das Alignment extrahieren + // First extract the Alignment if ( !aStr.Len() ) return sal_False; if ( pAlign ) *pAlign = (SfxChildAlignment) (sal_uInt16) aStr.ToInt32(); - // Dann das LastAlignment + // then the LastAlignment nPos = aStr.Search(','); if ( nPos == STRING_NOTFOUND ) return sal_False; @@ -652,10 +652,10 @@ sal_Bool SfxChildWinInfo::GetExtraData_Impl if ( pLastAlign ) *pLastAlign = (SfxChildAlignment) (sal_uInt16) aStr.ToInt32(); - // Dann die Splitting-Informationen + // Then the splitting information nPos = aStr.Search(','); if ( nPos == STRING_NOTFOUND ) - // Dockt nicht in einem Splitwindow + // No docking in a Splitwindow return sal_True; aStr.Erase(0, nPos+1); Point aChildPos; @@ -699,8 +699,6 @@ void SfxChildWindow::Hide() } } - - void SfxChildWindow::Show( USHORT nFlags ) { switch ( pWindow->GetType() ) diff --git a/sfx2/source/appl/fileobj.cxx b/sfx2/source/appl/fileobj.cxx index 84fbc325b505..0dff92fedf50 100644 --- a/sfx2/source/appl/fileobj.cxx +++ b/sfx2/source/appl/fileobj.cxx @@ -110,9 +110,9 @@ BOOL SvFileObject::GetData( ::com::sun::star::uno::Any & rData, case FILETYPE_TEXT: if( FORMAT_FILE == nFmt ) { - // das Medium muss in der Applikation geoffnet werden, um die - // relativen Datei Links aufzuloesen!!!! Wird ueber den - // LinkManager und damit von dessen Storage erledigt. + // The media in the application must be opened to lookup the + // relative file links!! This is done through the link manager + // of the Storage. rData <<= rtl::OUString( sFileNm ); } break; @@ -127,18 +127,15 @@ BOOL SvFileObject::GetData( ::com::sun::star::uno::Any & rData, { Graphic aGrf; - // falls das Nativformat doch erwuenscht ist, muss am - // Ende das Flag zurueckgesetzt werden. -// wird einzig und allein im sw/ndgrf.cxx benutzt, wenn der Link vom -// GraphicNode entfernt wird. + // If the native format is reqested, has to be reset at the + // end of the flag. Is solely in the sw/ndgrf.cxx used when + // the link is removed form GraphicNode. BOOL bOldNativFormat = bNativFormat; - // falls gedruckt werden soll, warten wir bis die - // Daten vorhanden sind + // If about to print, waiting for the data to be available if( bGetSynchron ) { - // testhalber mal ein LoadFile rufen um das nach- - // laden ueberahaupt anzustossen + // call a LoadFile every second time to test the loading if( !xMed.Is() ) LoadFile_Impl(); @@ -154,13 +151,10 @@ BOOL SvFileObject::GetData( ::com::sun::star::uno::Any & rData, } if( pDownLoadData || - ( !bWaitForData && ( xMed.Is() || // wurde als URL geladen + ( !bWaitForData && ( xMed.Is() || // was loaded as URL ( bSynchron && LoadFile_Impl() && xMed.Is() ) )) ) { - // falls - - // falls es uebers Internet gesogen wurde, nicht - // wieder versuchen + // If it was loaded from the Internet, do not retry if( !bGetSynchron ) bLoadAgain = !xMed->IsRemote(); bLoadError = !GetGraphic_Impl( aGrf, xMed->GetInStream() ); @@ -206,7 +200,7 @@ BOOL SvFileObject::GetData( ::com::sun::star::uno::Any & rData, bNativFormat = bOldNativFormat; - // alles fertig? + // Everything ready? if( xMed.Is() && !bSynchron && bClearMedium ) { xMed.Clear(); @@ -223,16 +217,12 @@ BOOL SvFileObject::GetData( ::com::sun::star::uno::Any & rData, return sal_True/*0 != aTypeList.Count()*/; } - - - BOOL SvFileObject::Connect( sfx2::SvBaseLink* pLink ) { if( !pLink || !pLink->GetLinkManager() ) return FALSE; - // teste doch mal, ob nicht ein anderer Link mit der gleichen - // Verbindung schon existiert + // Test if not another link of the same connection already exists pLink->GetLinkManager()->GetDisplayNames( pLink, 0, &sFileNm, 0, &sFilter ); if( OBJECT_CLIENT_GRF == pLink->GetObjType() ) @@ -270,19 +260,18 @@ BOOL SvFileObject::Connect( sfx2::SvBaseLink* pLink ) SetUpdateTimeout( 0 ); - // und jetzt bei diesem oder gefundenem Pseudo-Object anmelden + // and now register by this or other found Pseudo-Object AddDataAdvise( pLink, SotExchange::GetFormatMimeType( pLink->GetContentType()), 0 ); return TRUE; } - BOOL SvFileObject::LoadFile_Impl() { - // wir sind noch im Laden!! + // We are still at Loading!! if( bWaitForData || !bLoadAgain || xMed.Is() || pDownLoadData ) return FALSE; - // z.Z. nur auf die aktuelle DocShell + // at the moment on the current DocShell xMed = new SfxMedium( sFileNm, STREAM_STD_READ, TRUE ); SvLinkSource::StreamToLoadFrom aStreamToLoadFrom = getStreamToLoadFrom(); @@ -305,7 +294,7 @@ BOOL SvFileObject::LoadFile_Impl() bClearMedium = !xMed.Is(); if( bClearMedium ) - xMed = xTmpMed; // falls gleich im DownLoad schon schluss ist + xMed = xTmpMed; // If already finished in DownLoad return bDataReady; } @@ -315,7 +304,7 @@ BOOL SvFileObject::LoadFile_Impl() bLoadAgain = !xMed->IsRemote(); bWaitForData = FALSE; - // Grafik ist fertig, also DataChanged von der Statusaederung schicken: + // Graphic is finished, also send DataChanged of the Status change: SendStateChg_Impl( xMed->GetInStream() && xMed->GetInStream()->GetError() ? sfx2::LinkManager::STATE_LOAD_ERROR : sfx2::LinkManager::STATE_LOAD_OK ); return TRUE; @@ -333,7 +322,7 @@ BOOL SvFileObject::GetGraphic_Impl( Graphic& rGrf, SvStream* pStream ) String aEmptyStr; int nRes; - // vermeiden, dass ein native Link angelegt wird + // To avoid that a native link is created if( ( !pStream || !pDownLoadData ) && !rGrf.IsLink() && !rGrf.GetContext() && !bNativFormat ) rGrf.SetLink( GfxLink() ); @@ -369,7 +358,7 @@ BOOL SvFileObject::GetGraphic_Impl( Graphic& rGrf, SvStream* pStream ) } else if( FALSE ) { - // Timer aufsetzen, um zurueck zukehren + // Set up Timer, to return back pDownLoadData->aTimer.Start(); } } @@ -383,14 +372,14 @@ BOOL SvFileObject::GetGraphic_Impl( Graphic& rGrf, SvStream* pStream ) { if( xMed.Is() && !pStream ) { - DBG_WARNING3( "GrafikFehler [%d] - [%s] URL[%s]", + DBG_WARNING3( "Graphic error [%d] - [%s] URL[%s]", nRes, xMed->GetPhysicalName().GetBuffer(), sFileNm.GetBuffer() ); } else { - DBG_WARNING2( "GrafikFehler [%d] - [%s]", + DBG_WARNING2( "Graphic error [%d] - [%s]", nRes, sFileNm.GetBuffer() ); } } @@ -457,7 +446,7 @@ void SvFileObject::Edit( Window* pParent, sfx2::SvBaseLink* pLink, const Link& r { case OBJECT_CLIENT_GRF: { - nType = FILETYPE_GRF; // falls noch nicht gesetzt + nType = FILETYPE_GRF; // If not set already SvxOpenGraphicDialog aDlg(SfxResId(RID_SVXSTR_EDITGRFLINK)); aDlg.EnableLink(sal_False); @@ -516,19 +505,18 @@ void SvFileObject::Edit( Window* pParent, sfx2::SvBaseLink* pLink, const Link& r IMPL_STATIC_LINK( SvFileObject, LoadGrfReady_Impl, void*, EMPTYARG ) { - // wenn wir von hier kommen, kann es kein Fehler mehr sein + // When we come form here there it can not be an error no more. pThis->bLoadError = FALSE; pThis->bWaitForData = FALSE; pThis->bInCallDownLoad = FALSE; if( !pThis->bInNewData && !pThis->bDataReady ) { - // Grafik ist fertig, also DataChanged von der Status- - // aederung schicken: + // Graphic is finished, also send DataChanged from Status change pThis->bDataReady = TRUE; pThis->SendStateChg_Impl( sfx2::LinkManager::STATE_LOAD_OK ); - // und dann nochmal die Daten senden + // and then send the data again pThis->NotifyDataChanged(); } @@ -561,7 +549,7 @@ IMPL_STATIC_LINK( SvFileObject, DelMedium_Impl, SfxMediumRef*, pDelMed ) IMPL_STATIC_LINK( SvFileObject, LoadGrfNewData_Impl, void*, EMPTYARG ) { - // wenn wir von hier kommen, kann es kein Fehler mehr sein + // When we come form here there it can not be an error no more. if( pThis->bInNewData ) return 0; @@ -572,13 +560,11 @@ IMPL_STATIC_LINK( SvFileObject, LoadGrfNewData_Impl, void*, EMPTYARG ) { pThis->pDownLoadData = new Impl_DownLoadData( STATIC_LINK( pThis, SvFileObject, LoadGrfNewData_Impl ) ); - - // Null-Link setzen, damit keine temporaeren Grafiken - // rausgeswapt werden; der Filter prueft, ob schon - // ein Link gesetzt ist => falls dies zutrifft, wird - // _kein_ neuer Link gesetzt; der Link muss hier gesetzt werden, - // (bevor das erste Mal gefiltert wird), um zu verhindern, - // dass der Kontext zurueckgesetzt wird (aynchrones Laden) + // Set Zero-link, so that no temporary graphics can be swapped out, + // the filter checks whether a link is set already => if so, is _no_ + // new link set, the link here must be set (before it is first + // filtered), to prevent, that the context will be reset + // (aynchronous loading) if( !pThis->bNativFormat ) { static GfxLink aDummyLink; @@ -594,7 +580,7 @@ IMPL_STATIC_LINK( SvFileObject, LoadGrfNewData_Impl, void*, EMPTYARG ) if( ERRCODE_IO_PENDING == pStrm->GetError() ) pStrm->ResetError(); - // im DataChanged ein DataReady? + // a DataReady in DataChanged? else if( pThis->bWaitForData && pThis->pDownLoadData ) { pThis->bLoadError = TRUE; @@ -603,8 +589,7 @@ IMPL_STATIC_LINK( SvFileObject, LoadGrfNewData_Impl, void*, EMPTYARG ) if( pThis->bDataReady ) { - // Grafik ist fertig, also DataChanged von der Status- - // aederung schicken: + // Graphic is finished, also send DataChanged from Status change pThis->SendStateChg_Impl( pStrm->GetError() ? sfx2::LinkManager::STATE_LOAD_ERROR : sfx2::LinkManager::STATE_LOAD_OK ); } @@ -638,14 +623,14 @@ IMPL_LINK( SvFileObject, DialogClosedHdl, sfx2::FileDialogHelper*, _pFileDlg ) return 0; } -/* [Beschreibung] +/* [Description] + + The method determines whether the data-object can be read from a DDE. - Die Methode stellt fest, ob aus einem DDE-Object die Daten gelesen - werden kann. - Zurueckgegeben wird: - ERRCODE_NONE wenn sie komplett gelesen wurde - ERRCODE_SO_PENDING wenn sie noch nicht komplett gelesen wurde - ERRCODE_SO_FALSE sonst + The following can be returned: + ERRCODE_NONE if it has been completely read + ERRCODE_SO_PENDING if it has not been completely read + ERRCODE_SO_FALSE otherwise */ BOOL SvFileObject::IsPending() const { @@ -678,10 +663,10 @@ BOOL SvFileObject::IsDataComplete() const void SvFileObject::CancelTransfers() { - // und aus dem Cache austragen, wenn man mitten im Laden ist + // unsubscribe from the cache if in the middle of loading if( !bDataReady ) { - // nicht noch mal aufsetzen + // Do not set-up again bLoadAgain = FALSE; bDataReady = bLoadError = bWaitForData = TRUE; SendStateChg_Impl( sfx2::LinkManager::STATE_LOAD_ABORT ); diff --git a/sfx2/source/appl/fileobj.hxx b/sfx2/source/appl/fileobj.hxx index 9f9fff9798e3..a902b5875410 100644 --- a/sfx2/source/appl/fileobj.hxx +++ b/sfx2/source/appl/fileobj.hxx @@ -83,8 +83,7 @@ public: virtual BOOL Connect( sfx2::SvBaseLink* ); virtual void Edit( Window *, sfx2::SvBaseLink *, const Link& rEndEditHdl ); - // erfrage ob das man direkt auf die Daten zugreifen kann oder ob das - // erst angestossen werden muss + // Ask whether you can access data directly or whether it has to be triggered virtual BOOL IsPending() const; virtual BOOL IsDataComplete() const; diff --git a/sfx2/source/appl/impldde.cxx b/sfx2/source/appl/impldde.cxx index a0c4bf1370f1..efafab525c12 100644 --- a/sfx2/source/appl/impldde.cxx +++ b/sfx2/source/appl/impldde.cxx @@ -237,8 +237,6 @@ BOOL SvDDEObject::Connect( SvBaseLink * pSvLink ) pConnection = new DdeConnection( sServer, sTopic ); if( pConnection->GetError() ) { - // kann man denn das System-Topic ansprechen ? - // dann ist der Server oben, kennt nur nicht das Topic! // Is it possible to address the system-Topic? // then the server is up, it just does not know the topic! if( sTopic.EqualsIgnoreCaseAscii( "SYSTEM" ) ) diff --git a/sfx2/source/appl/linkmgr2.cxx b/sfx2/source/appl/linkmgr2.cxx index ea450ab8866f..06c3e1bd741c 100644 --- a/sfx2/source/appl/linkmgr2.cxx +++ b/sfx2/source/appl/linkmgr2.cxx @@ -119,11 +119,7 @@ void LinkManager::CloseCachedComps() maCachedComps.clear(); } -/************************************************************************ -|* LinkManager::Remove() -|* -|* Description -*************************************************************************/ +//-------------------------------------------------------------------------- void LinkManager::Remove( SvBaseLink *pLink ) { @@ -343,7 +339,7 @@ void LinkManager::UpdateAllLinks( if( USHRT_MAX == nFndPos ) continue; // was not available! - // Graphic-Links not to update jet + // Graphic-Links not to update yet if( !pLink->IsVisible() || ( !bUpdateGrfLinks && OBJECT_CLIENT_GRF == pLink->GetObjType() )) continue; @@ -361,11 +357,7 @@ void LinkManager::UpdateAllLinks( CloseCachedComps(); } -/************************************************************************ -|* SvBaseLink::CreateObject() -|* -|* Description -*************************************************************************/ +//-------------------------------------------------------------------------- SvLinkSourceRef LinkManager::CreateObj( SvBaseLink * pLink ) { @@ -522,7 +514,7 @@ ULONG LinkManager::RegisterStatusInfoId() // nFormat = Exchange::RegisterFormatName( "StatusInfo vom SvxInternalLink" ); nFormat = SotExchange::RegisterFormatName( String::CreateFromAscii( RTL_CONSTASCII_STRINGPARAM( - "StatusInfo vom SvxInternalLink" ))); + "StatusInfo from SvxInternalLink" ))); } return nFormat; } diff --git a/sfx2/source/appl/lnkbase2.cxx b/sfx2/source/appl/lnkbase2.cxx index bfb81f7ab610..f37b672acbc9 100644 --- a/sfx2/source/appl/lnkbase2.cxx +++ b/sfx2/source/appl/lnkbase2.cxx @@ -29,7 +29,6 @@ // MARKER(update_precomp.py): autogen include statement, do not remove #include "precompiled_sfx2.hxx" - #include <sfx2/lnkbase.hxx> #include <sot/exchange.hxx> #include <com/sun/star/uno/Any.hxx> @@ -131,12 +130,7 @@ public: BOOL IsInDTOR() const { return bIsInDTOR; } }; - -/************************************************************************ -|* SvBaseLink::SvBaseLink() -|* -|* Description -*************************************************************************/ +//-------------------------------------------------------------------------- SvBaseLink::SvBaseLink() { @@ -147,11 +141,7 @@ SvBaseLink::SvBaseLink() bWasLastEditOK = FALSE; } -/************************************************************************ -|* SvBaseLink::SvBaseLink() -|* -|* Description -*************************************************************************/ +//-------------------------------------------------------------------------- SvBaseLink::SvBaseLink( USHORT nUpdateMode, ULONG nContentType ) { @@ -167,11 +157,7 @@ SvBaseLink::SvBaseLink( USHORT nUpdateMode, ULONG nContentType ) pImplData->ClientType.bIntrnlLnk = FALSE; } -/************************************************************************ -|* SvBaseLink::SvBaseLink() -|* -|* Description -*************************************************************************/ +//-------------------------------------------------------------------------- SvBaseLink::SvBaseLink( const String& rLinkName, USHORT nObjectType, SvLinkSource* pObj ) { @@ -208,11 +194,7 @@ SvBaseLink::SvBaseLink( const String& rLinkName, USHORT nObjectType, SvLinkSourc xObj = pObj; } -/************************************************************************ -|* SvBaseLink::~SvBaseLink() -|* -|* Description -*************************************************************************/ +//-------------------------------------------------------------------------- SvBaseLink::~SvBaseLink() { @@ -242,11 +224,7 @@ IMPL_LINK( SvBaseLink, EndEditHdl, String*, _pNewName ) return 0; } -/************************************************************************ -|* SvBaseLink::SetObjType() -|* -|* Description -*************************************************************************/ +//-------------------------------------------------------------------------- void SvBaseLink::SetObjType( USHORT nObjTypeP ) { @@ -256,33 +234,21 @@ void SvBaseLink::SetObjType( USHORT nObjTypeP ) nObjType = nObjTypeP; } -/************************************************************************ -|* SvBaseLink::SetName() -|* -|* Description -*************************************************************************/ +//-------------------------------------------------------------------------- void SvBaseLink::SetName( const String & rNm ) { aLinkName = rNm; } -/************************************************************************ -|* SvBaseLink::GetName() -|* -|* Description -*************************************************************************/ +//-------------------------------------------------------------------------- String SvBaseLink::GetName() const { return aLinkName; } -/************************************************************************ -|* SvBaseLink::SetObj() -|* -|* Description -*************************************************************************/ +//-------------------------------------------------------------------------- void SvBaseLink::SetObj( SvLinkSource * pObj ) { @@ -293,11 +259,7 @@ void SvBaseLink::SetObj( SvLinkSource * pObj ) xObj = pObj; } -/************************************************************************ -|* SvBaseLink::SetLinkSourceName() -|* -|* Description -*************************************************************************/ +//-------------------------------------------------------------------------- void SvBaseLink::SetLinkSourceName( const String & rLnkNm ) { @@ -315,23 +277,14 @@ void SvBaseLink::SetLinkSourceName( const String & rLnkNm ) ReleaseRef(); // should be superfluous } -/************************************************************************ -|* SvBaseLink::GetLinkSourceName() -|* -|* Description -*************************************************************************/ +//-------------------------------------------------------------------------- String SvBaseLink::GetLinkSourceName() const { return aLinkName; } - -/************************************************************************ -|* SvBaseLink::SetUpdateMode() -|* -|* Description -*************************************************************************/ +//-------------------------------------------------------------------------- void SvBaseLink::SetUpdateMode( USHORT nMode ) { diff --git a/sfx2/source/appl/module.cxx b/sfx2/source/appl/module.cxx index 09ce47563a5e..a8d2c24b939a 100644 --- a/sfx2/source/appl/module.cxx +++ b/sfx2/source/appl/module.cxx @@ -197,7 +197,7 @@ SfxSlotPool* SfxModule::GetSlotPool() const void SfxModule::RegisterChildWindow(SfxChildWinFactory *pFact) { - DBG_ASSERT( pImpl, "No real Modul!" ); + DBG_ASSERT( pImpl, "No real Module!" ); if (!pImpl->pFactArr) pImpl->pFactArr = new SfxChildWinFactArr_Impl; @@ -221,7 +221,7 @@ void SfxModule::RegisterChildWindow(SfxChildWinFactory *pFact) void SfxModule::RegisterChildWindowContext( USHORT nId, SfxChildWinContextFactory *pFact) { - DBG_ASSERT( pImpl, "No real Modul!" ); + DBG_ASSERT( pImpl, "No real Module!" ); USHORT nCount = pImpl->pFactArr->Count(); for (USHORT nFactory=0; nFactory<nCount; ++nFactory) diff --git a/sfx2/source/appl/workwin.cxx b/sfx2/source/appl/workwin.cxx index ae05593fa188..5c655496f439 100644 --- a/sfx2/source/appl/workwin.cxx +++ b/sfx2/source/appl/workwin.cxx @@ -597,7 +597,7 @@ SfxWorkWindow::SfxWorkWindow( Window *pWin, SfxBindings& rB, SfxWorkWindow* pPar m_aProgressBarResName( RTL_CONSTASCII_USTRINGPARAM( "private:resource/progressbar/progressbar" )) { DBG_CTOR(SfxWorkWindow, 0); - DBG_ASSERT (pBindings, "Keine Bindings!"); + DBG_ASSERT (pBindings, "No Bindings!"); pBindings->SetWorkWindow_Impl( this ); @@ -1028,7 +1028,7 @@ SfxChild_Impl* SfxWorkWindow::RegisterChild_Impl( Window& rWindow, SfxChildAlignment eAlign, BOOL bCanGetFocus ) { DBG_CHKTHIS(SfxWorkWindow, 0); - DBG_ASSERT( pChilds->Count() < 255, "too many childs" ); + DBG_ASSERT( pChilds->Count() < 255, "too many children" ); DBG_ASSERT( SfxChildAlignValid(eAlign), "invalid align" ); DBG_ASSERT( !FindChild_Impl(rWindow), "child registered more than once" ); @@ -2531,7 +2531,6 @@ SfxChildWindow* SfxWorkWindow::GetChildWindow_Impl(USHORT nId) void SfxWorkWindow::ResetChildWindows_Impl() { - for ( USHORT n = 0; n < pChildWins->Count(); ++n ) { (*pChildWins)[n]->nId = 0; diff --git a/sfx2/source/view/frame.cxx b/sfx2/source/view/frame.cxx index 41452da24cad..428ee5f9d114 100644 --- a/sfx2/source/view/frame.cxx +++ b/sfx2/source/view/frame.cxx @@ -125,7 +125,7 @@ SfxFrame::~SfxFrame() if ( pChildArr ) { - DBG_ASSERT( !pChildArr->Count(), "Childs nicht entfernt!" ); + DBG_ASSERT( !pChildArr->Count(), "Children are not removed!" ); delete pChildArr; } @@ -134,7 +134,7 @@ SfxFrame::~SfxFrame() sal_Bool SfxFrame::DoClose() { - // Eigentlich wird noch ein PrepareClose gebraucht !!! + // Actually, one more PrepareClose is still needed! BOOL bRet = FALSE; if ( !pImp->bClosing ) { @@ -177,7 +177,7 @@ sal_Bool SfxFrame::DoClose_Impl() if ( pImp->pCurrentViewFrame ) pBindings = &pImp->pCurrentViewFrame->GetBindings(); - // Bei internen Tasks m"ussen Controller und Tools abger"aumt werden + // For internal tasks Controllers and Tools must be cleared if ( pImp->pWorkWin ) pImp->pWorkWin->DeleteControllers_Impl(); @@ -257,7 +257,7 @@ SfxFrame* SfxFrame::GetChildFrame( sal_uInt16 nPos ) const { if ( pChildArr && pChildArr->Count() > nPos ) { - DBG_ASSERT( nPos < pChildArr->Count(), "Falscher Index!"); + DBG_ASSERT( nPos < pChildArr->Count(), "Wrong Index!"); return (*pChildArr)[nPos]; } @@ -266,7 +266,7 @@ SfxFrame* SfxFrame::GetChildFrame( sal_uInt16 nPos ) const void SfxFrame::RemoveChildFrame_Impl( SfxFrame* pFrame ) { - DBG_ASSERT( pChildArr, "Unbekannter Frame!"); + DBG_ASSERT( pChildArr, "Unknown Frame!"); sal_uInt16 nPos = pChildArr->GetPos(pFrame); pChildArr->Remove( nPos ); }; @@ -306,7 +306,7 @@ void SfxFrame::CancelTransfers( sal_Bool /*bCancelLoadEnv*/ ) for( pFrm = SfxViewFrame::GetFirst( pObj ); pFrm && &pFrm->GetFrame() == this; pFrm = SfxViewFrame::GetNext( *pFrm, pObj ) ) ; - // Keine anderer Frame mehr auf Doc -> Cancel + // No more Frame in Document -> Cancel if( !pFrm ) { pObj->CancelTransfers(); @@ -314,12 +314,12 @@ void SfxFrame::CancelTransfers( sal_Bool /*bCancelLoadEnv*/ ) } } - // zuerst Nachladende Frames stoppen + // First stop multiload Frames sal_uInt16 nCount = GetChildFrameCount(); for( sal_uInt16 n = 0; n<nCount; n++ ) GetChildFrame( n )->CancelTransfers(); - // ggf. StarOne-Loader canceln + // Check if StarOne-Loader should be canceled SfxFrameWeak wFrame( this ); if (wFrame.Is()) pImp->bInCancelTransfers = sal_False; @@ -362,9 +362,10 @@ void SfxFrame::SetFrameType_Impl( sal_uInt32 n ) void SfxFrame::GetViewData_Impl() { - // Alle zwischen Laden und Entfernen "anderbaren Daten aktualisieren; die - // festen Daten werden nur einmal ( nach PrepareForDoc_Impl in UpdateDescriptor ) - // geholt, um Zeit zu sparen. + // Update all modifiable data between load and unload, the + // fixed data is only processed once (after PrepareForDoc_Impl in + // updateDescriptor) to save time. + SfxViewFrame* pViewFrame = GetCurrentViewFrame(); if( pViewFrame && pViewFrame->GetViewShell() ) { @@ -385,7 +386,7 @@ void SfxFrame::GetViewData_Impl() pSet->Put( SfxUInt16Item( SID_VIEW_ID, pViewFrame->GetCurViewId() ) ); if ( pChildArr ) { - // Bei Framesets m"ussen auch die Daten der ChildViews geholt werden + // For Framesets also the data from the ChildViews hace to be processed sal_uInt16 nCount = pChildArr->Count(); for ( sal_uInt16 n=nCount; n>0; n--) { @@ -400,15 +401,15 @@ void SfxFrame::GetViewData_Impl() void SfxFrame::UpdateDescriptor( SfxObjectShell *pDoc ) { - // Beim PrepareForDoc_Impl wird der Descriptor des Frames aktualisiert - // und sein ItemSet neu initialisiert. Alle Daten, die f"ur ein sp"ateres - // Restaurieren der View n"otig sind, sind damit festgehalten. - // Soll das Dokument ersetzt werden, wird durch GetViewData_Impl (s.o.) - // die neueste Information hinzugef"ugt. Alles zusammen wird dann in der - // Browse-History gesichert. Beim Aktivieren eines solchen FramePickEntry - // wird das komplette ItemSet und der Descriptor im OpenDoc mitgeschickt. - // Hier werden nur die festen Eigenschaften gesichert; die "anderbaren werden - // durch GetViewData geholt ( spart Zeit ). + // For PrepareForDoc_Impl frames, the descriptor of the updated + // and new itemset to be initialized. All data fir restoring the view + // are thus saved. If the document be replaced, GetViewData_Impl (so) + // the latest information hinzugef by "added. All together then the + // browser-history saved in. When you activate such frame pick entry + // is complete itemsets and the descriptor in the OpenDoc sent;. + // Here only the fixed properties identified "other adjustable, the + // retrieved by GetViewData (saves time). + DBG_ASSERT( pDoc, "NULL-Document inserted ?!" ); GetParentFrame(); @@ -420,7 +421,7 @@ void SfxFrame::UpdateDescriptor( SfxObjectShell *pDoc ) GetDescriptor()->SetEditable( bEditable ); - // FileOpen-Parameter merken + // Mark FileOpen parameter SfxItemSet* pItemSet = pMed->GetItemSet(); String aMedName( pMed->GetName() ); @@ -435,7 +436,7 @@ void SfxFrame::UpdateDescriptor( SfxObjectShell *pDoc ) SfxItemSet *pSet = GetDescriptor()->GetArgs(); - // Alle alten Items l"oschen + // Delete all old Items pSet->ClearItem(); if ( pRefererItem ) @@ -456,13 +457,13 @@ void SfxFrame::UpdateDescriptor( SfxObjectShell *pDoc ) void SfxFrame::SetDescriptor( SfxFrameDescriptor *pD ) { - DBG_ASSERT( pD, "Kein Descriptor!" ); - DBG_ASSERT( pD != pImp->pDescr, "Descriptor ist schon gesetzt!" ); + DBG_ASSERT( pD, "No Descriptor!" ); + DBG_ASSERT( pD != pImp->pDescr, "Descriptor is already set!" ); if ( pImp->pDescr ) { - // Nur TopLevel-Frames verwalten ihren Descriptor selbst, bei den - // anderen tut es das Frameset + // Only TopLevel-Frames handels their Descriptor, for the others + // this is done by the Frameset if ( !pParentFrame ) delete pImp->pDescr; } @@ -473,12 +474,12 @@ void SfxFrame::SetDescriptor( SfxFrameDescriptor *pD ) SfxFrameDescriptor* SfxFrame::GetDescriptor() const { - // On Demand einen FrameDescriptor anlegen; wenn es kein TopLevel-Frame - // ist, f"uhrt es zu Fehlern, da keine g"ulige Verkettung hergestellt wird + // Create a FrameDescriptor On Demand; if there is no TopLevel-Frame + // will result in an error, as no valid link is created. if ( !pImp->pDescr ) { - DBG_ASSERT( !GetParentFrame(), "Kein TopLevel-Frame, aber kein Descriptor!" ); + DBG_ASSERT( !GetParentFrame(), "No TopLevel-Frame, but no Descriptor!" ); pImp->pDescr = new SfxFrameDescriptor; if ( GetCurrentDocument() ) pImp->pDescr->SetURL( GetCurrentDocument()->GetMedium()->GetOrigURL() ); @@ -492,7 +493,7 @@ void SfxFrame::GetTargetList( TargetList& rList ) const { if ( !GetParentFrame() ) { - // Einen Leerstring f"ur 'Kein Target' + // An empty string for 'No Target' rList.push_back( new String() ); rList.push_back( new String( DEFINE_CONST_UNICODE( "_top" ) ) ); rList.push_back( new String( DEFINE_CONST_UNICODE( "_parent" ) ) ); @@ -685,19 +686,19 @@ SfxFrameIterator::SfxFrameIterator( const SfxFrame& rFrame, sal_Bool bRecur ) SfxFrame* SfxFrameIterator::FirstFrame() { - // GetFirst beginnt die Iteration beim ersten ChildFrame + // GetFirst starts the iteration at the first child frame return pFrame->GetChildFrame( 0 ); } SfxFrame* SfxFrameIterator::NextFrame( SfxFrame& rPrev ) { - // Zuerst auf Kinder testen, wenn Rekursion erw"unscht + // If recursion is requested testing is done first on Children. SfxFrame *pRet = NULL; if ( bRecursive ) pRet = rPrev.GetChildFrame( 0 ); if ( !pRet ) { - // Anderenfalls mit den Geschwistern von rPrev weitermachen + // In other case continue with the siblings of rPrev pRet = NextSibling_Impl( rPrev ); } diff --git a/sfx2/source/view/frame2.cxx b/sfx2/source/view/frame2.cxx index 773bbaf68aec..e4c3c692d695 100644 --- a/sfx2/source/view/frame2.cxx +++ b/sfx2/source/view/frame2.cxx @@ -438,7 +438,6 @@ void SfxFrame::PositionWindow_Impl( const Rectangle& rWinArea ) const { Window *pWin = pImp->pExternalContainerWindow; - // Groesse setzen const Size aAppWindow( pImp->pExternalContainerWindow->GetDesktopRectPixel().GetSize() ); Point aPos( rWinArea.TopLeft() ); Size aSz( rWinArea.GetSize() ); diff --git a/sfx2/source/view/orgmgr.cxx b/sfx2/source/view/orgmgr.cxx index a1ba8ac7ef67..e54754f611bf 100644 --- a/sfx2/source/view/orgmgr.cxx +++ b/sfx2/source/view/orgmgr.cxx @@ -57,23 +57,22 @@ using namespace ::com::sun::star; //========================================================================= -/* [Beschreibung] - - Implementierungsklasse; einzelner Eintrag in der Dateiansicht +/* [Description] + Implementation class, single entry in the file view. */ struct _FileListEntry { - String aFileName; // Dateiname mit komplettem Pfad - String aBaseName; // Dateiname + String aFileName; // File Name with complete path + String aBaseName; // File Name const CollatorWrapper* pCollator; - SfxObjectShellLock aDocShell; // ObjectShell als Ref-Klasse + SfxObjectShellLock aDocShell; // ObjectShell as reference class - BOOL bFile; // als Datei auf Platte - // (!= unbenannt1, nicht als Dok. geladen; - // diese werden nicht gespeichert!) - BOOL bOwner; // selbst erzeugt + BOOL bFile; // As File on disk + // (!= not processed, not loaded as document + // these are not saved!) + BOOL bOwner; // self-generated BOOL bNoName; BOOL bOwnFormat; @@ -139,22 +138,21 @@ SV_IMPL_OP_PTRARR_SORT(_SfxObjectList, _FileListEntry*) BOOL _FileListEntry::DeleteObjectShell() -/* [Beschreibung] - - Freigabe der DokumentShell +/* [Description] - [Returnwert] TRUE: alles Ok - FALSE: es ist ein Fehler aufgetreten (das - Dokument konnte nicht gesichert werden) + Release of ther DocumentShell + [Return value] TRUE: Everything is ok + FALSE: An error occured + (the document could not be saved) */ { BOOL bRet = TRUE; - //Falls wir die Shell angelegt haben und sie veraendert wurde + if(bOwner && aDocShell.Is() && aDocShell->IsModified()) { - //Mussten wir konvertieren? + // Converted? if( bOwnFormat ) { if(!aDocShell->Save() ) @@ -178,7 +176,7 @@ BOOL _FileListEntry::DeleteObjectShell() } else { - // Falls konvertiert im eigenen Format speichern + // If converted save in native format INetURLObject aObj( aFileName ); String aTitle = aObj.getName( INetURLObject::LAST_SEGMENT, true, INetURLObject::DECODE_WITH_CHARSET ); @@ -234,13 +232,9 @@ SfxOrganizeMgr::SfxOrganizeMgr( SfxOrganizeListBox_Impl *pLeft, bDeleteTemplates(pTempl == 0), bModified(0) -/* [Beschreibung] - - Konstruktor - - Das aktuelle Dokument wird in die Liste der Dokumente - aufgenommen. +/* [Description] + Constructor. The current document is added to the list of documents. */ { pImpl->pDocList = new SfxObjectList; @@ -275,17 +269,17 @@ SfxOrganizeMgr::~SfxOrganizeMgr() SfxObjectShellRef SfxOrganizeMgr::CreateObjectShell( USHORT nIdx ) -/* [Beschreibung] +/* [Description] - Zugriff auf die DokumentShell an der Position nIdx + Access to the DocumentShell at the position nIdx. - [Returnwert] Referenz auf die DokumentShell + [Return value] Reference to the DocumentShell */ { _FileListEntry* pEntry = (*pImpl->pDocList)[nIdx]; - // andernfalls Doc-Shell anlegen + // otherwise create Doc-Shell if ( !pEntry->aDocShell.Is() ) { INetURLObject aFileObj( pEntry->aFileName ); @@ -336,14 +330,13 @@ SfxObjectShellRef SfxOrganizeMgr::CreateObjectShell( USHORT nIdx ) BOOL SfxOrganizeMgr::DeleteObjectShell(USHORT nIdx) -/* [Beschreibung] +/* [Description] - Freigabe der DokumentShell an der Position nIdx - - [Returnwert] TRUE: alles Ok - FALSE: es ist ein Fehler aufgetreten (das - Dokument konnte nicht gesichert werden) + Release DocumentShell at position nIdx + [Return value] TRUE: Everything is ok + FALSE: An error occured + (the document could not be saved) */ { return (*pImpl->pDocList)[nIdx]->DeleteObjectShell(); @@ -353,12 +346,12 @@ BOOL SfxOrganizeMgr::DeleteObjectShell(USHORT nIdx) SfxObjectShellRef SfxOrganizeMgr::CreateObjectShell(USHORT nRegion, USHORT nIdx) -/* [Beschreibung] +/* [Description] - Zugriff auf die DokumentShell an der Position nIdx im Bereich - nRegion (Dokumentvorlage) + Access to the DocumentShell at Position nIdx in Region + nRegion (Document template) - [Returnwert] Referenz auf die DokumentShell + [Return value] Reference to the DocumentShell */ { @@ -369,15 +362,14 @@ SfxObjectShellRef SfxOrganizeMgr::CreateObjectShell(USHORT nRegion, BOOL SfxOrganizeMgr::DeleteObjectShell(USHORT nRegion, USHORT nIdx) -/* [Beschreibung] - - Freigabe der DokumentShell an der Position nIdx im Bereich - nRegion (Dokumentvorlage) +/* [Description] - [Returnwert] TRUE: alles Ok - FALSE: es ist ein Fehler aufgetreten (das - Dokument konnte nicht gesichert werden) + Release of the DocumentShell at Position nIdx in Region + nRegion (Document template) + [Return value] TRUE: Everything is ok + FALSE: An error occured + (the document could not be saved) */ { @@ -391,22 +383,22 @@ BOOL SfxOrganizeMgr::Copy(USHORT nTargetRegion, USHORT nSourceRegion, USHORT nSourceIdx) -/* [Beschreibung] +/* [Description] - Kopieren einer Dokumentvorlage + Copy of a Document Template [Parameter] - USHORT nTargetRegion Index des Zielbereiches - USHORT nTargetIdx Index Zielposition - USHORT nSourceRegion Index des Quellbereiches - USHORT nSourceIdx Index der zu kopierenden / z uverschiebenden - Dokumentvorlage + USHORT nTargetRegion Index of the Target Region + USHORT nTargetIdx Index of the Target Position + USHORT nSourceRegion Index of the Source Region + USHORT nSourceIdx Index of the template to be + copied/moved. - [R"uckgabewert] Erfolg (TRUE) oder Mi"serfolg (FALSE) + [Return value] Success (TRUE) or Failure (FALSE) - [Querverweise] + [Cross-reference] <SfxDocumentTemplates::Copy(USHORT nTargetRegion, USHORT nTargetIdx, @@ -416,7 +408,7 @@ BOOL SfxOrganizeMgr::Copy(USHORT nTargetRegion, */ { - if(nSourceIdx == USHRT_MAX) // keine Verzeichnisse kopieren + if(nSourceIdx == USHRT_MAX) // No directories copied return FALSE ; const BOOL bOk = pTemplates->Copy(nTargetRegion, nTargetIdx, nSourceRegion, nSourceIdx); @@ -432,32 +424,30 @@ BOOL SfxOrganizeMgr::Move(USHORT nTargetRegion, USHORT nSourceRegion, USHORT nSourceIdx) -/* [Beschreibung] +/* [Description] - Verschieben einer Dokumentvorlage + Moving a template [Parameter] - USHORT nTargetRegion Index des Zielbereiches - USHORT nTargetIdx Index Zielposition - USHORT nSourceRegion Index des Quellbereiches - USHORT nSourceIdx Index der zu kopierenden / z uverschiebenden - Dokumentvorlage - - [R"uckgabewert] Erfolg (TRUE) oder Mi"serfolg (FALSE) + USHORT nTargetRegion Index of the Target Region + USHORT nTargetIdx Index of the Target Position + USHORT nSourceRegion Index of the Source Region + USHORT nSourceIdx Index of the template to be + copied/moved. + [Return value] Success (TRUE) or Failure (FALSE) - [Querverweise] + [Cross-reference] <SfxDocumentTemplates::Move(USHORT nTargetRegion, USHORT nTargetIdx, USHORT nSourceRegion, USHORT nSourceIdx)> - */ { - if(nSourceIdx == USHRT_MAX) // keine Verzeichnisse verschieben + if(nSourceIdx == USHRT_MAX) // No directory moved return FALSE ; const BOOL bOk = pTemplates->Move(nTargetRegion, nTargetIdx, nSourceRegion, nSourceIdx); @@ -471,24 +461,21 @@ BOOL SfxOrganizeMgr::Move(USHORT nTargetRegion, BOOL SfxOrganizeMgr::Delete(SfxOrganizeListBox_Impl *pCaller, USHORT nRegion, USHORT nIdx) -/* [Beschreibung] +/* [Description] - "oschen einer Dokumentvorlage + Delete a Document Template [Parameter] - SfxOrganizeListBox *pCaller rufende ListBox; da dieses - Event durch das Men"u oder - durch das Keyboard angetriggert wird, - mu"s das Model der ListBox anschlie"send - aktualisiert werden. - USHORT nRegion Index des Bereiches - USHORT nIdx Index der Dokumentvorlage - - [R"uckgabewert] Erfolg (TRUE) oder Mi"serfolg (FALSE) + SfxOrganizeListBox *pCaller calling ListBox, since this event + is triggered by the menu or the + keyboard, the ListBox must be updated. + USHORT nRegion Index for Region + USHORT nIdx Index of Document template + [Return value] Success (TRUE) or Failure (FALSE) - [Querverweise] + [Cross-reference] <SfxDocumentTemplates::Delete(USHORT nRegion, USHORT nIdx)> @@ -541,7 +528,7 @@ BOOL SfxOrganizeMgr::Delete(SfxOrganizeListBox_Impl *pCaller, if(bOk) { bModified = 1; - // zu loeschender Eintrag + // Entry to be deleted. SvLBoxEntry *pEntryToDelete = pCaller->SvLBox::GetEntry(pCaller->SvLBox::GetEntry(nRegion), nIdx); pCaller->GetModel()->Remove(pEntryToDelete); @@ -555,26 +542,20 @@ BOOL SfxOrganizeMgr::Delete(SfxOrganizeListBox_Impl *pCaller, BOOL SfxOrganizeMgr::InsertDir ( - SfxOrganizeListBox_Impl* pCaller,/* rufende ListBox; da dieses Event - durch das Men"u oder durch das - Keyboard angetriggert wird, - mu\s das Model der ListBox - anschlie\send aktualisiert werden */ - const String& rText, // logischer Name des Bereiches - USHORT nRegion // Index des Bereiches + SfxOrganizeListBox_Impl* pCaller, /* calling ListBox, since this event + is triggered by the menu or the + keyboard, the ListBox must be updated. */ + const String& rText, // logical Name of Region + USHORT nRegion // Index of Region ) -/* [Beschreibung] +/* [Description] - Einf"ugen eines Bereiches + Insert Region. + [Return value] Success (TRUE) or Failure (FALSE) - [R"uckgabewert] - - Erfolg (TRUE) oder Mi\serfolg (FALSE) - - - [Querverweise] + [Cross-reference] <SfxDocumentTemplates::InsertDir(const String &, USHORT nRegion)> */ @@ -599,23 +580,21 @@ BOOL SfxOrganizeMgr::InsertDir BOOL SfxOrganizeMgr::SetName(const String &rName, USHORT nRegion, USHORT nIdx) -/* [Beschreibung] +/* [Description] - "Andern eines (logischen) Namens + Set (logical) Name [Parameter] - const String &rName der neue Name - USHORT nRegion Index des Bereiches - USHORT nIdx Index der Dokumentvorlage + const String &rName The new Name + USHORT nRegion Index of Region + USHORT nIdx Index of Document template - [R"uckgabewert] Erfolg (TRUE) oder Mi"serfolg (FALSE) + [Return value] Success (TRUE) or Failure (FALSE) - - [Querverweise] + [Cross-reference] <SfxDocumentTemplates::SetName(const String &, USHORT nRegion, USHORT nIdx)> - */ { @@ -629,23 +608,21 @@ BOOL SfxOrganizeMgr::SetName(const String &rName, BOOL SfxOrganizeMgr::CopyTo(USHORT nRegion, USHORT nIdx, const String &rName) const -/* [Beschreibung] +/* [Description] - Export einer Vorlage + Export of a Template [Parameter] - USHORT nRegion Index des Bereiches - USHORT nIdx Index der Dokumentvorlage - const String &rName Dateiname + USHORT nRegion Index of Region + USHORT nIdx Index of Document Template + const String &rName File name - [R"uckgabewert] Erfolg (TRUE) oder Mi"serfolg (FALSE) + [Return value] Success (TRUE) or Failure (FALSE) - - [Querverweise] + [Cross-reference] <SfxDocumentTemplates::CopyTo( USHORT nRegion, USHORT nIdx, const String &)> - */ { @@ -657,27 +634,25 @@ BOOL SfxOrganizeMgr::CopyTo(USHORT nRegion, USHORT nIdx, const String &rName) co BOOL SfxOrganizeMgr::CopyFrom(SfxOrganizeListBox_Impl *pCaller, USHORT nRegion, USHORT nIdx, String &rName) -/* [Beschreibung] +/* [Description] - Import einer Vorlage + Import of Document Template [Parameter] - SfxOrganizeListBox *pCaller rufende ListBox; da dieses - Event durch das Men"u angetriggert wird, - mu"s das Model der ListBox anschlie"send - aktualisiert werden. - USHORT nRegion Index des Bereiches - USHORT nIdx Index der Dokumentvorlage - String &rName Dateiname + SfxOrganizeListBox *pCaller calling ListBox, since this event + is triggered by the menu or the + keyboard, the ListBox must be updated. - [R"uckgabewert] Erfolg (TRUE) oder Mi"serfolg (FALSE) + USHORT nRegion Index of Region + USHORT nIdx Index of Document Template + String &rName File name + [Return value] Success (TRUE) or Failure (FALSE) - [Querverweise] + [Cross-reference] <SfxDocumentTemplates::CopyFrom( USHORT nRegion, USHORT nIdx, const String &)> - */ { @@ -686,7 +661,7 @@ BOOL SfxOrganizeMgr::CopyFrom(SfxOrganizeListBox_Impl *pCaller, pParent = pCaller->GetParent(pParent); if( pTemplates->CopyFrom( nRegion, nIdx, rName ) ) { - // pCaller aktualisieren + // Update pCaller if( nIdx == USHRT_MAX ) nIdx = 0; else nIdx++; @@ -710,20 +685,19 @@ BOOL SfxOrganizeMgr::CopyFrom(SfxOrganizeListBox_Impl *pCaller, BOOL SfxOrganizeMgr::InsertFile( SfxOrganizeListBox_Impl* pCaller, const String& rFileName ) -/* [Beschreibung] +/* [Description] - Eine Datei in der Dateiansicht hinzuf"ugen + Insert a file in the file view. [Parameter] - SfxOrganizeListBox *pCaller rufende ListBox; da dieses - Event durch das Men"u angetriggert wird, - mu"s das Model der ListBox anschlie"send - aktualisiert werden. - const String &rFileName Name der hinzuf"ugenden Datei + SfxOrganizeListBox *pCaller calling ListBox, since this event + is triggered by the menu or the + keyboard, the ListBox must be updated. - [R"uckgabewert] Erfolg (TRUE) oder Mi"serfolg (FALSE) + const String &rFileName Name of inserted File. + [Return value] Success (TRUE) or Failure (FALSE) */ { @@ -744,16 +718,16 @@ BOOL SfxOrganizeMgr::InsertFile( SfxOrganizeListBox_Impl* pCaller, const String& BOOL SfxOrganizeMgr::Rescan() -/* [Beschreibung] +/* [Description] - Aktualisieren der Datenbasis + Updating the database. - [R"uckgabewert] + [Return value] - TRUE es bestanden Unterschiede - FALSE keine "Anderung + TRUE Changes were made + FALSE No changes - [Querverweise] + [Cross-reference] <SfxDocumentTemplates::Rescan()> */ @@ -771,14 +745,13 @@ BOOL SfxOrganizeMgr::Rescan() void SfxOrganizeMgr::SaveAll(Window *pParent) -/* [Beschreibung] +/* [Description] - Schreiben aller ge"anderten Dokumente + Save all Documents that have been modified [Parameter] - Window *pParent Parent der Boxen f"ur Fehlermeldungen - + Window *pParent Parent of the Error message Box */ { diff --git a/sfx2/source/view/printer.cxx b/sfx2/source/view/printer.cxx index 5f49da08789a..34e988de604d 100644 --- a/sfx2/source/view/printer.cxx +++ b/sfx2/source/view/printer.cxx @@ -46,7 +46,7 @@ #include "view.hrc" #ifdef MSC -// der ist buggy +// this one is buggy #define NEW_OBJECTS(Class, nCount) ((Class*) new char[ sizeof(Class) * (nCount) ]) #else #define NEW_OBJECTS(Class, nCount) (new Class[nCount]) @@ -121,7 +121,7 @@ SfxFontSizeInfo::SfxFontSizeInfo( const SfxFont &rFont, aFont.SetPitch(rFont.GetPitch()); aFont.SetCharSet(rFont.GetCharSet()); - // verfuegbare Groessen in die Liste eintragen, Groesse in 10tel Punkt + // Add available sizes to the list, size in tenths of a point int nSizeCount = rDev.GetDevFontSizeCount(aFont); pSizes = NEW_OBJECTS(Size, nSizeCount); const MapMode aOldMapMode = rDev.GetMapMode(); @@ -132,8 +132,8 @@ SfxFontSizeInfo::SfxFontSizeInfo( const SfxFont &rFont, aMap.SetScaleY(aTen); rDev.SetMapMode(aMap); - // Es gibt Fonts mit Bitmaps und skalierbaren Groessen - // In diesem Fall wird der Fonts als skalierbar behandelt. + // There are fonts with bitmaps and scalable sizes + // In this case the fonts arehandled as scalable BOOL bFoundScalable = FALSE; for ( int i = 0; i < nSizeCount; ++i ) { @@ -147,7 +147,7 @@ SfxFontSizeInfo::SfxFontSizeInfo( const SfxFont &rFont, bScalable = FALSE; else { - // statische Font-Sizes verwenden + // Static Font-Sizes are used delete [] pSizes; nSizes = 0; } @@ -197,23 +197,23 @@ SfxFont::SfxFont( const FontFamily eFontFamily, const String& aFontName, SfxPrinter* SfxPrinter::Create( SvStream& rStream, SfxItemSet* pOptions ) -/* [Beschreibung] +/* [Description] - Erzeugt einen <SfxPrinter> aus dem Stream. Geladen wird genaugenommen - nur ein JobSetup. Falls ein solcher Drucker auf dem System nicht - verf"augbar ist, wird das Original als Orig-JobSetup gemerkt und - ein "anhlicher exisitierender Drucker genommen. + Creates a <SfxPrinter> from the stream. Loading is really only a jobsetup. + If such a printer is not available on the system, then the original is + marked as the original Job-setup and a comparable printer is selected from + existing ones. - Die 'pOptions' werden in den erzeugten SfxPrinter "ubernommen, - der Returnwert geh"ort dem Caller. + The 'pOptions' are taken over in the generated SfxPrinter, the return + value belongs to the caller. */ { - // JobSetup laden + // Load JobSetup JobSetup aFileJobSetup; rStream >> aFileJobSetup; - // Drucker erzeugen + // Get printers SfxPrinter *pPrinter = new SfxPrinter( pOptions, aFileJobSetup ); return pPrinter; } @@ -222,9 +222,9 @@ SfxPrinter* SfxPrinter::Create( SvStream& rStream, SfxItemSet* pOptions ) SvStream& SfxPrinter::Store( SvStream& rStream ) const -/* [Beschreibung] +/* [Description] - Speichert das verwendete JobSetup des <SfxPrinter>s. + Saves the used JobSetup of <SfxPrinter>s. */ { @@ -235,9 +235,9 @@ SvStream& SfxPrinter::Store( SvStream& rStream ) const SfxPrinter::SfxPrinter( SfxItemSet* pTheOptions ) : -/* [Beschreibung] +/* [Description] - Dieser Ctor erzeugt einen Standard-Drucker. + This constructor creates a default printer. */ pOptions( pTheOptions ), @@ -408,8 +408,8 @@ void SfxPrinter::UpdateFonts_Impl() VirtualDevice *pVirDev = 0; const OutputDevice *pOut = this; - // falls kein Drucker gefunden werden konnte, ein - // temp. Device erzeugen fuer das Erfragen der Fonts + // If no printer was found, a temporay device is created + // for queries about fonts if( !IsValid() ) pOut = pVirDev = new VirtualDevice; @@ -430,7 +430,7 @@ void SfxPrinter::UpdateFonts_Impl() else if ( FONTS()->Count() == 0 || (*FONTS())[FONTS()->Count()-1]->GetName() != aFont.GetName() ) { - DBG_ASSERT(0 == SfxFindFont_Impl(*FONTS(), aFont.GetName()), "Doppelte Fonts vom SV-Device!"); + DBG_ASSERT(0 == SfxFindFont_Impl(*FONTS(), aFont.GetName()), "Double Fonts from SV-Device!"); SfxFont* pTmp = new SfxFont( aFont.GetFamily(), aFont.GetName(), aFont.GetPitch(), aFont.GetCharSet() ); FONTS()->C40_INSERT(SfxFont, pTmp, FONTS()->Count()); @@ -465,7 +465,7 @@ USHORT SfxPrinter::GetFontCount() const SfxFont* SfxPrinter::GetFont( USHORT nNo ) const { - DBG_ASSERT( FONTS(), "bitte erst GetFontCount() abfragen!" ); + DBG_ASSERT( FONTS(), "First, please check GetFontCount()!" ); return (*FONTS())[ nNo ]; } @@ -538,7 +538,7 @@ SfxPrintOptionsDialog::SfxPrintOptionsDialog( Window *pParent, { SetText( SfxResId( STR_PRINT_OPTIONS_TITLE ) ); - // TabPage einh"angen + // Insert TabPage pPage = pViewSh->CreatePrintOptionsPage( this, *pOptions ); DBG_ASSERT( pPage, "CreatePrintOptions != SFX_VIEW_HAS_PRINTOPTIONS" ); if( pPage ) @@ -548,7 +548,7 @@ SfxPrintOptionsDialog::SfxPrintOptionsDialog( Window *pParent, pPage->Show(); } - // Dialoggr"o\se bestimmen + // Set dialog size Size a6Sz = LogicToPixel( Size( 6, 6 ), MAP_APPFONT ); Size aBtnSz = LogicToPixel( Size( 50, 14 ), MAP_APPFONT ); Size aOutSz( pPage ? pPage->GetSizePixel() : Size() ); @@ -557,7 +557,7 @@ SfxPrintOptionsDialog::SfxPrintOptionsDialog( Window *pParent, nWidth += a6Sz.Width(); aOutSz.Width() += nWidth; if ( aOutSz.Height() < 90 ) - // mindestens die H"ohe der 3 Buttons + // at least the height of the 3 buttons aOutSz.Height() = 90; SetOutputSizePixel( aOutSz ); diff --git a/sfx2/source/view/prnmon.cxx b/sfx2/source/view/prnmon.cxx index 200e74475fe1..bb6d69ff83d4 100644 --- a/sfx2/source/view/prnmon.cxx +++ b/sfx2/source/view/prnmon.cxx @@ -213,7 +213,7 @@ SfxPrintProgress_Impl::~SfxPrintProgress_Impl() BOOL SfxPrintProgress_Impl::SetPage( USHORT nPage, const String &rPage ) { - // wurde der Druckauftrag abgebrochen? + // Was the print job canceled? if ( bCancel || !pMonitor ) return FALSE; @@ -291,10 +291,10 @@ SfxPrintProgress::SfxPrintProgress( SfxViewShell* pViewSh, bool bShow ) SfxPrintProgress::~SfxPrintProgress() { - // k"onnte auch schon weg sein (in EndPrintNotify) + // Can already have been deleted (in EndPrintNotify) DELETEZ(pImp->pMonitor); - // ggf. Callbacks entfermen + // If possible remove Callbacks if ( pImp->bCallbacks ) { // pImp->pPrinter->SetEndPrintHdl( Link() ); @@ -302,11 +302,11 @@ SfxPrintProgress::~SfxPrintProgress() pImp->bCallbacks = FALSE; } - // ggf. vorherigen Drucker wieder einsetzen + // If possible use the previously used printer if ( pImp->pOldPrinter ) pImp->pViewShell->SetPrinter( pImp->pOldPrinter, SFX_PRINTER_PRINTER ); else - // ggf. vorherigen Print-To-File-Status zuruecksetzen + // If possible reset Print-To-File-Status pImp->pViewShell->GetPrinter()->EnablePrintFile( pImp->bOldEnablePrintFile ); // EndPrint-Notification an Frame @@ -395,29 +395,16 @@ IMPL_LINK( SfxPrintProgress, EndPrintNotify, void *, EMPTYARG ) pViewShell->Invalidate( SID_PRINTDOCDIRECT ); pViewShell->Invalidate( SID_SETUPPRINTER ); - // . . . falls der Printer im System umgestellt wurde, hier Aenderung - // nachziehen. - //! if( pMDI->IsPrinterChanged() ) pMDI->Changed( 0L ); - - // Callbacks rausnehmen - // pImp->pPrinter->SetEndPrintHdl( Link() ); + // Check out Callbacks pImp->pPrinter->SetErrorHdl( Link() ); pImp->bCallbacks = FALSE; - // ggf. alten Printer wieder einsetzen + // If possible insert the old Printer again. if ( pImp->pOldPrinter ) { - // Fix #59613#: niemals den aktuellen Printer synchron abschiessen ! - // Da sowieso immer bDeleteOnEndPrint gesetzt wird, wird der der Drucker im - // dtor vom Printprogress ( dann aber asynchron !! ) zur"uckgesetzt. -/* - pImp->pViewShell->SetPrinter( pImp->pOldPrinter, SFX_PRINTER_PRINTER ); - pImp->pOldPrinter = 0; - pImp->pPrinter = 0; - */ } else - // ggf. vorherigen Print-To-File-Status zuruecksetzen + // If possible reset previous Print-To-File-Status. pViewShell->GetPrinter()->EnablePrintFile( pImp->bOldEnablePrintFile ); // it is possible that after printing the document or view is deleted (because the VieShell got the ownership) @@ -444,11 +431,11 @@ IMPL_LINK( SfxPrintProgress, EndPrintNotify, void *, EMPTYARG ) void SfxPrintProgress::DeleteOnEndPrint() { - UnLock(); // jetzt schon, wg. Drucken im Thread + UnLock(); // Already now because printer in Thread. #ifndef WNT - // da das Drucken im 'Thread' unter Windows zu undefiniert ist bleibt der - // Print-Monitor dort stehen, auf den anderen Plattformen kann man dann - // weiterarbeiten, also kommt das Teil weg + // As the print in the 'Thread' is undefined on Windows, the Print-Monitor + // will get stuck here, on the other platforms the work can continue, + // thus this part is removed. DELETEZ( pImp->pMonitor ); #endif diff --git a/sfx2/source/view/sfxbasecontroller.cxx b/sfx2/source/view/sfxbasecontroller.cxx index 3e6823672baf..074c5b0ad6c8 100644 --- a/sfx2/source/view/sfxbasecontroller.cxx +++ b/sfx2/source/view/sfxbasecontroller.cxx @@ -692,7 +692,7 @@ sal_Bool SAL_CALL SfxBaseController::suspend( sal_Bool bSuspend ) throw( ::com:: getFrame()->removeFrameActionListener( m_pData->m_xListener ) ; SfxViewFrame* pActFrame = m_pData->m_pViewShell->GetFrame() ; - // weitere View auf dasselbe Doc? + // More Views on the same document? SfxObjectShell* pDocShell = m_pData->m_pViewShell->GetObjectShell() ; sal_Bool bOther = sal_False ; @@ -1209,7 +1209,7 @@ throw (::com::sun::star::uno::RuntimeException) SfxSlotPool* pSlotPool = pPool ? pPool : &SFX_SLOTPOOL(); const ULONG nMode( SFX_SLOT_TOOLBOXCONFIG|SFX_SLOT_ACCELCONFIG|SFX_SLOT_MENUCONFIG ); - // Gruppe anw"ahlen ( Gruppe 0 ist intern ) + // Select Group ( Group 0 is internal ) for ( USHORT i=0; i<pSlotPool->GetGroupCount(); i++ ) { String aName = pSlotPool->SeekGroup( i ); @@ -1400,7 +1400,7 @@ void SfxBaseController::ConnectSfxFrame_Impl( const ConnectSfxFrame i_eConnect ) rFrame.GetWindow().Show(); } - // Jetzt UpdateTitle, hidden TopFrames haben sonst keinen Namen! + // UpdateTitle now, hidden TopFrames have otherwise no Name! pViewFrame->UpdateTitle(); if ( !rFrame.IsInPlace() ) diff --git a/sfx2/source/view/viewfrm.cxx b/sfx2/source/view/viewfrm.cxx index 16db55fac1f2..11de6cbe6031 100644 --- a/sfx2/source/view/viewfrm.cxx +++ b/sfx2/source/view/viewfrm.cxx @@ -109,7 +109,7 @@ using ::com::sun::star::document::XViewDataSupplier; using ::com::sun::star::container::XIndexContainer; namespace css = ::com::sun::star; -// wg. ViewFrame::Current +// Due to ViewFrame::Current #include "appdata.hxx" #include <sfx2/taskpane.hxx> #include <sfx2/app.hxx> @@ -305,7 +305,7 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) SfxFrame *pParent = GetFrame().GetParentFrame(); if ( rReq.GetSlot() == SID_RELOAD ) { - // Bei CTRL-Reload den aktiven Frame reloaden + // When CTRL-Reload, reload the active Frame SfxViewFrame* pActFrame = this; while ( pActFrame ) pActFrame = pActFrame->GetActiveChildFrame_Impl(); @@ -320,8 +320,8 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) } } - // Wenn nur ein Reload der Graphiken eines oder mehrerer ChildFrames - // gemacht werden soll + // If only a reload of the graphics for one or more child frames + // should be made SfxFrame& rFrame = GetFrame(); if ( pParent == &rFrame && rFrame.GetChildFrameCount() ) { @@ -340,14 +340,14 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) pChild = pNext; } - // Der TopLevel-Frame selbst het keine Graphiken! + // The top level frame itself has no graphics! if ( bReloadAvailable ) return; } } else { - // Bei CTRL-Edit den TopFrame bearbeiten + // When CTRL-Edit, edit the TopFrame. sal_uInt16 nModifier = rReq.GetModifier(); if ( ( nModifier & KEY_MOD1 ) && pParent ) @@ -366,9 +366,9 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) if ( GetFrame().HasComponent() ) break; - // Wg. Doppeltbelegung in Toolboxen (mit/ohne Ctrl) ist es auch - // m"oglich, da\s der Slot zwar enabled ist, aber Ctrl-Click - // trotzdem nicht geht! + // Due to Double occupancy in toolboxes (with or without Ctrl), + // it is also possible that the slot is enabled, but Ctrl-click + // despite this is not! if( !pSh || !pSh->HasName() || !(pSh->Get_Impl()->nLoadedFlags & SFX_LOADED_MAINDOCUMENT )) break; @@ -405,7 +405,7 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) sal_Bool bNeedsReload = sal_False; if ( !pSh->IsReadOnly() ) { - // Speichern und Readonly Reloaden + // Save and reload Readonly if( pSh->IsModified() ) { if ( pSh->PrepareClose() ) @@ -448,11 +448,11 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) return; } - // Parameter auswerten + // Evaluate Parameter // sal_Bool bReload = sal_True; if ( rReq.IsAPI() ) { - // per API steuern ob r/w oder r/o + // Control through API if r/w or r/o SFX_REQUEST_ARG(rReq, pEditItem, SfxBoolItem, SID_EDITDOC, sal_False); if ( pEditItem ) nOpenMode = pEditItem->GetValue() ? SFX_STREAM_READWRITE : SFX_STREAM_READONLY; @@ -516,12 +516,12 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) pSh->DoSaveCompleted( pMed ); } - // r/o-Doc kann nicht in Editmode geschaltet werden? + // Readonly document can not be switched to edit mode? rReq.Done( sal_False ); if ( nOpenMode == SFX_STREAM_READWRITE && !rReq.IsAPI() ) { - // dem ::com::sun::star::sdbcx::User anbieten, als Vorlage zu oeffnen + // ::com::sun::star::sdbcx::User offering to open it as a template QueryBox aBox( &GetWindow(), SfxResId(MSG_QUERY_OPENASTEMPLATE) ); if ( RET_YES == aBox.Execute() ) { @@ -574,9 +574,9 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) case SID_RELOAD: { - // Wg. Doppeltbelegung in Toolboxen (mit/ohne Ctrl) ist es auch - // m"oglich, da\s der Slot zwar enabled ist, aber Ctrl-Click - // trotzdem nicht geht! + // Due to Double occupancy in toolboxes (with or without Ctrl), + // it is also possible that the slot is enabled, but Ctrl-click + // despite this is not! if ( !pSh || !pSh->CanReload_Impl() ) break; SfxApplication* pApp = SFX_APP(); @@ -588,7 +588,7 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) if( pImp->bReloading || pSh->IsInModalMode() ) return; - // AutoLoad ist ggf. verboten + // AutoLoad is prohibited if possible SFX_REQUEST_ARG(rReq, pAutoLoadItem, SfxBoolItem, SID_AUTOLOAD, sal_False); if ( pAutoLoadItem && pAutoLoadItem->GetValue() && GetFrame().IsAutoLoadLocked_Impl() ) @@ -598,12 +598,12 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) pImp->bReloading = sal_True; SFX_REQUEST_ARG(rReq, pURLItem, SfxStringItem, SID_FILE_NAME, sal_False); - // editierbar "offnen? + // Open as editable? sal_Bool bForEdit = !pSh->IsReadOnly(); if ( rReq.GetSlot() == SID_EDITDOC ) bForEdit = !bForEdit; - // ggf. beim User nachfragen + // If possible ask the User sal_Bool bDo = ( GetViewShell()->PrepareClose() != FALSE ); SFX_REQUEST_ARG(rReq, pSilentItem, SfxBoolItem, SID_SILENT, sal_False); if ( bDo && GetFrame().DocIsModified_Impl() && @@ -617,15 +617,15 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) { SfxMedium *pMedium = xOldObj->GetMedium(); - // Frameset abziehen, bevor FramesetView evtl. verschwindet + // Remove Frameset before the FramesetView may disappear String aURL = pURLItem ? pURLItem->GetValue() : pMedium->GetName(); sal_Bool bHandsOff = ( pMedium->GetURLObject().GetProtocol() == INET_PROT_FILE && !xOldObj->IsDocShared() ); - // bestehende SfxMDIFrames f"ur dieses Doc leeren - // eigenes Format oder R/O jetzt editierbar "offnen? + // Emty existing SfxMDIFrames for this Document + // in native format or R/O, open it now for editing? SfxObjectShellLock xNewObj; // collect the views of the document @@ -678,9 +678,8 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) pNewSet->ClearItem( SID_DOC_READONLY ); } - // Falls eine salvagede Datei vorliegt, nicht nochmals die - // OrigURL mitschicken, denn die Tempdate ist nach Reload - // ungueltig + // If a salvaged file is present, do not enclose the OrigURL + // again, since the Tempdate is invalid after reload. SFX_ITEMSET_ARG( pNewSet, pSalvageItem, SfxStringItem, SID_DOC_SALVAGE, sal_False); if( pSalvageItem ) { @@ -689,7 +688,7 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) } // TODO/LATER: Temporary solution, the SfxMedium must know the original URL as aLogicName - // SfxMedium::Transfer_Impl() will be vorbidden then. + // SfxMedium::Transfer_Impl() will be forbidden then. if ( xOldObj->IsDocShared() ) pNewSet->Put( SfxStringItem( SID_FILE_NAME, xOldObj->GetSharedFileURL() ) ); @@ -702,7 +701,7 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) xOldObj->CancelTransfers(); - // eigentliches Reload + // Real Reload //pNewSet->Put( SfxFrameItem ( SID_DOCFRAME, GetFrame() ) ); if ( pSilentItem && pSilentItem->GetValue() ) @@ -725,8 +724,8 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) pNewSet->Put( SfxUInt16Item(SID_UPDATEDOCMODE,::com::sun::star::document::UpdateDocMode::ACCORDING_TO_CONFIG) ); xOldObj->SetModified( sal_False ); - // Altes Dok nicht cachen! Gilt nicht, wenn anderes - // Doc geladen wird. + // Do not chache the old Document! Is invalid when loading + // another document. SFX_ITEMSET_ARG( pMedium->GetItemSet(), pSavedOptions, SfxStringItem, SID_FILE_FILTEROPTIONS, sal_False); SFX_ITEMSET_ARG( pMedium->GetItemSet(), pSavedReferer, SfxStringItem, SID_REFERER, sal_False); @@ -855,14 +854,14 @@ void SfxViewFrame::ExecReload_Impl( SfxRequest& rReq ) SFX_APP()->NotifyEvent( SfxEventHint( SFX_EVENT_CLOSEDOC, GlobalEventConfig::GetEventName( STR_EVENT_CLOSEDOC ), xOldObj ) ); } - // als erledigt recorden + // Record as done rReq.Done( sal_True ); rReq.SetReturnValue(SfxBoolItem(rReq.GetSlot(), sal_True)); return; } else { - // als nicht erledigt recorden + // Record as not done rReq.Done(); rReq.SetReturnValue(SfxBoolItem(rReq.GetSlot(), sal_False)); pImp->bReloading = sal_False; @@ -877,7 +876,7 @@ void SfxViewFrame::StateReload_Impl( SfxItemSet& rSet ) { SfxObjectShell* pSh = GetObjectShell(); if ( !pSh ) - // Ich bin gerade am Reloaden und Yielde so vor mich hin ... + // I'm just on reload and am yielding myself ... return; GetFrame().GetParentFrame(); @@ -886,8 +885,8 @@ void SfxViewFrame::StateReload_Impl( SfxItemSet& rSet ) { if ( GetFrame().HasComponent() ) { - // Wenn die Komponente es nicht selbst dispatched, dann - // macht es auch keinen Sinn! + // If the component is not self-dispatched, then + // it makes no sense! rSet.DisableItem( nWhich ); continue; } @@ -918,8 +917,8 @@ void SfxViewFrame::StateReload_Impl( SfxItemSet& rSet ) rSet.DisableItem(nWhich); else { - // Wenn irgendein ChildFrame reloadable ist, wird der Slot - // enabled, damit man CTRL-Reload machen kann + // If any ChildFrame is reloadable, the slot is enabled, + // so you can perfom CTRL-Reload sal_Bool bReloadAvailable = sal_False; SfxFrameIterator aFrameIter( *pFrame, sal_True ); for( SfxFrame* pNextFrame = aFrameIter.FirstFrame(); @@ -949,7 +948,7 @@ void SfxViewFrame::StateReload_Impl( SfxItemSet& rSet ) //-------------------------------------------------------------------- void SfxViewFrame::ExecHistory_Impl( SfxRequest &rReq ) { - // gibt es an der obersten Shell einen Undo-Manager? + // Is there an Undo-Manager on the top Shell? SfxShell *pSh = GetDispatcher()->GetShell(0); SfxUndoManager* pShUndoMgr = pSh->GetUndoManager(); sal_Bool bOK = sal_False; @@ -983,7 +982,7 @@ void SfxViewFrame::ExecHistory_Impl( SfxRequest &rReq ) } else if ( GetViewShell() ) { - // der SW hat eigenes Undo an der View + // The SW has its own undo in the View const SfxPoolItem *pRet = GetViewShell()->ExecuteSlot( rReq ); if ( pRet ) bOK = ((SfxBoolItem*)pRet)->GetValue(); @@ -996,16 +995,16 @@ void SfxViewFrame::ExecHistory_Impl( SfxRequest &rReq ) //-------------------------------------------------------------------- void SfxViewFrame::StateHistory_Impl( SfxItemSet &rSet ) { - // Undo-Manager suchen + // Search for Undo-Manager SfxShell *pSh = GetDispatcher()->GetShell(0); if ( !pSh ) - // Ich bin gerade am Reloaden und Yielde so vor mich hin ... + // I'm just on reload and am yielding myself ... return; SfxUndoManager *pShUndoMgr = pSh->GetUndoManager(); if ( !pShUndoMgr ) { - // der SW hat eigenes Undo an der View + // The SW has its own undo in the View SfxWhichIter aIter( rSet ); SfxViewShell *pViewSh = GetViewShell(); if( !pViewSh ) return; @@ -1074,20 +1073,19 @@ void SfxViewFrame::PopShellAndSubShells_Impl( SfxViewShell& i_rViewShell ) //-------------------------------------------------------------------- void SfxViewFrame::ReleaseObjectShell_Impl() -/* [Beschreibung] +/* [Description] - Diese Methode entleert den SfxViewFrame, d.h. nimmt die <SfxObjectShell> - vom Dispatcher und beendet seine <SfxListener>-Beziehung zu dieser - SfxObjectShell (wodurch sie sich ggf. selbst zerst"ort). + This method empties the SfxViewFrame, i.e. takes the <SfxObjectShell> + from the dispatcher and ends its <SfxListener> Relationship to this + SfxObjectShell (by which they may even destroy themselves). - Somit kann durch Aufruf von ReleaseObjectShell() und SetObjectShell() - die SfxObjectShell ausgetauscht werden. + Thus, by invoking ReleaseObjectShell() and SetObjectShell() the + SfxObjectShell can be replaced. - Zwischen RealeaseObjectShell() und SetObjectShell() darf die Kontrolle - nicht an das System abgegeben werden. + Between RealeaseObjectShell() and SetObjectShell() can the control not + be handed over to the system. - - [Querverweise] + [Cross-reference] <SfxViewFrame::SetObjectShell(SfxObjectShell&)> */ @@ -1112,7 +1110,7 @@ void SfxViewFrame::ReleaseObjectShell_Impl() } #ifdef DBG_UTIL else - OSL_FAIL("Keine Shell"); + OSL_FAIL("No Shell"); #endif if ( xObjSh.Is() ) @@ -1151,8 +1149,8 @@ sal_Bool SfxViewFrame::Close() DBG_ASSERT( GetFrame().IsClosing_Impl() || !GetFrame().GetFrameInterface().is(), "ViewFrame closed too early!" ); - // Wenn bis jetzt noch nicht gespeichert wurde, sollen eingebettete Objekte - // auch nicht mehr automatisch gespeichert werden! + // If no saving have been made up until now, then embedded Objects should + // not be saved automatically anymore. if ( GetViewShell() ) GetViewShell()->DiscardClients_Impl(); Broadcast( SfxSimpleHint( SFX_HINT_DYING ) ); @@ -1160,8 +1158,8 @@ sal_Bool SfxViewFrame::Close() if (SfxViewFrame::Current() == this) SfxViewFrame::SetViewFrame( NULL ); - // Da der Dispatcher leer ger"aumt wird, kann man ihn auch nicht mehr - // vern"unftig verwenden - also besser still legen + // Since the Dispatcher is emptied, it can not be used in any reasnable + // manner, thus it is better to let the dispatcher be. GetDispatcher()->Lock(sal_True); delete this; @@ -1181,8 +1179,8 @@ void SfxViewFrame::DoActivate( sal_Bool bUI, SfxViewFrame* pOldFrame ) pDispatcher->DoActivate_Impl( bUI, pOldFrame ); - // Wenn ich einen parent habe und dieser ist kein parent des alten - // ViewFrames, erh"alt er ein ParentActivate + // If this ViewFrame has got a parent and this is not a parent of the + // old ViewFrames, it gets a ParentActivate. if ( bUI ) { SfxViewFrame *pFrame = GetParentViewFrame(); @@ -1202,8 +1200,8 @@ void SfxViewFrame::DoDeactivate(sal_Bool bUI, SfxViewFrame* pNewFrame ) SFX_APP(); pDispatcher->DoDeactivate_Impl( bUI, pNewFrame ); - // Wenn ich einen parent habe und dieser ist kein parent des neuen - // ViewFrames, erh"alt er ein ParentDeactivate + // If this ViewFrame has got a parent and this is not a parent of the + // new ViewFrames, it gets a ParentDeactivate. if ( bUI ) { SfxViewFrame *pFrame = GetParentViewFrame(); @@ -1310,7 +1308,7 @@ void SfxViewFrame::Notify( SfxBroadcaster& /*rBC*/, const SfxHint& rHint ) if ( !xObjSh.Is() ) break; - // r/o Umschaltung? + // Switch r/o? SfxBindings& rBind = GetBindings(); rBind.Invalidate( SID_RELOAD ); SfxDispatcher *pDispat = GetDispatcher(); @@ -1318,7 +1316,7 @@ void SfxViewFrame::Notify( SfxBroadcaster& /*rBC*/, const SfxHint& rHint ) sal_Bool bIsReadOnly = xObjSh->IsReadOnly(); if ( !bWasReadOnly != !bIsReadOnly ) { - // Dann auch TITLE_CHANGED + // Then also TITLE_CHANGED UpdateTitle(); rBind.Invalidate( SID_FILE_NAME ); rBind.Invalidate( SID_DOCINFO_TITLE ); @@ -1327,11 +1325,12 @@ void SfxViewFrame::Notify( SfxBroadcaster& /*rBC*/, const SfxHint& rHint ) pDispat->GetBindings()->InvalidateAll(sal_True); pDispat->SetReadOnly_Impl( bIsReadOnly ); - // Dispatcher-Update nur erzwingen, wenn es nicht sowieso - // demn"achst kommt, anderenfalls ist Zappelei oder gar - // GPF m"oglich, da Writer z.B. gerne mal im Resize irgendwelche - // Aktionen t"atigt, die ein SetReadOnlyUI am Dispatcher zur - // Folge haben! + // Only force and Dispatcher-Update, if it is done next + // anyway, otherwise flickering or GPF is possibel since + // the Writer for example prefers in Resize preform some + // actions which has a SetReadOnlyUI in Dispatcher as a + // result! + if ( pDispat->IsUpdated_Impl() ) pDispat->Update_Impl(sal_True); } @@ -1366,9 +1365,9 @@ void SfxViewFrame::Notify( SfxBroadcaster& /*rBC*/, const SfxHint& rHint ) } else if ( rHint.IsA(TYPE(SfxEventHint)) ) { - // Wenn das Document asynchron geladen wurde, wurde der Dispatcher - // auf ReadOnly gesetzt, was zur"?ckgenommen werden mu\s, wenn - // das Document selbst nicht ReadOnly ist und das Laden fertig ist. + // When the Document is loaded asynchronously, was the Dispatcher + // set as ReadOnly, to what must be returned when the document itself + // is not read only, and the loading is finished. switch ( ((SfxEventHint&)rHint).GetEventId() ) { case SFX_EVENT_MODIFYCHANGED: @@ -1392,8 +1391,8 @@ void SfxViewFrame::Notify( SfxBroadcaster& /*rBC*/, const SfxHint& rHint ) rBind.Invalidate( SID_EDITDOC ); if ( !xObjSh->IsReadOnly() ) { - // Im Gegensatz zu oben (TITLE_CHANGED) mu\s das UI nicht - // upgedated werden, da es nicht gehidet war! + // In contrast to above (TITLE_CHANGED) does the UI not + // have to be updated because it was not obstructed // #i21560# InvalidateAll() causes the assertion // 'SfxBindings::Invalidate while in update" when @@ -1466,7 +1465,7 @@ void SfxViewFrame::Construct_Impl( SfxObjectShell *pObjSh ) pDispatcher->Flush(); } - SfxViewFrame *pThis = this; // wegen der kranken Array-Syntax + SfxViewFrame *pThis = this; // this due to the sick Array syntax SfxViewFrameArr_Impl &rViewArr = SFX_APP()->GetViewFrames_Impl(); rViewArr.C40_INSERT(SfxViewFrame, pThis, rViewArr.Count() ); } @@ -1477,11 +1476,11 @@ SfxViewFrame::SfxViewFrame SfxObjectShell* pObjShell ) -/* [Beschreibung] +/* [Description] - Ctor des SfxViewFrame f"ur eine <SfxObjectShell> aus der Ressource. - Die 'nViewId' der zu erzeugenden <SfxViewShell> kann angegeben werden - (default ist die zuerst registrierte SfxViewShell-Subklasse). + Constructor of SfxViewFrame for a <SfxObjectShell> from the Resource. + The 'nViewId' to the created <SfxViewShell> can be returned. + (default is the SfxViewShell-Subclass that was registered first). */ : pImp( new SfxViewFrame_Impl( rFrame ) ) @@ -1514,7 +1513,7 @@ SfxViewFrame::~SfxViewFrame() ReleaseObjectShell_Impl(); if ( GetFrame().OwnsBindings_Impl() ) - // Die Bindings l"oscht der Frame! + // The Bindings delete the Frame! KillDispatcher_Impl(); delete pImp->pWindow; @@ -1522,13 +1521,13 @@ SfxViewFrame::~SfxViewFrame() if ( GetFrame().GetCurrentViewFrame() == this ) GetFrame().SetCurrentViewFrame_Impl( NULL ); - // von Frame-Liste abmelden + // Unregister from the Frame List. SfxApplication *pSfxApp = SFX_APP(); SfxViewFrameArr_Impl &rFrames = pSfxApp->GetViewFrames_Impl(); const SfxViewFrame *pThis = this; rFrames.Remove( rFrames.GetPos(pThis) ); - // Member l"oschen + // Delete Member KillDispatcher_Impl(); delete pImp; @@ -1537,7 +1536,7 @@ SfxViewFrame::~SfxViewFrame() //------------------------------------------------------------------------ void SfxViewFrame::KillDispatcher_Impl() -// Dispatcher abr"aumen und l"oschen +// Remove and delete the Dispatcher. { DBG_CHKTHIS(SfxViewFrame, 0); @@ -1564,9 +1563,9 @@ SfxViewFrame* SfxViewFrame::Current() //-------------------------------------------------------------------- sal_uInt16 SfxViewFrame::Count() -/* [Beschreibung] +/* [Description] - Liefert die Anzahl der sichtbaren <SfxViewFrame>-Instanzen. + Returns the number of visable <SfxViewFrame> instances. */ { @@ -1677,7 +1676,7 @@ SfxIniManager* SfxViewFrame::GetIniManager() const #endif //-------------------------------------------------------------------- -void SfxViewFrame::DoAdjustPosSizePixel //! teilen in Inner.../Outer... +void SfxViewFrame::DoAdjustPosSizePixel //! divide on Inner.../Outer... ( SfxViewShell* pSh, const Point& rPos, @@ -1686,7 +1685,7 @@ void SfxViewFrame::DoAdjustPosSizePixel //! teilen in Inner.../Outer... { DBG_CHKTHIS(SfxViewFrame, 0); - // Components benutzen diese Methode nicht! + // Components do not use this Method! if( pSh && pSh->GetWindow() && !nAdjustPosPixelLock ) { nAdjustPosPixelLock++; @@ -1720,10 +1719,10 @@ SfxPoolItem* SfxViewFrameItem::Clone( SfxItemPool *) const //-------------------------------------------------------------------- void SfxViewFrame::SetViewShell_Impl( SfxViewShell *pVSh ) -/* [Beschreibung] +/* [Description] - Interne Methode zum setzen der jeweils aktuellen <SfxViewShell>-Instanz, - die in diesem SfxViewFrame aktiv ist. + Internal Method to set the current <SfxViewShell> Instance, + that is active int this SfxViewFrame at the moment. */ { @@ -1735,9 +1734,9 @@ void SfxViewFrame::SetViewShell_Impl( SfxViewShell *pVSh ) } //-------------------------------------------------------------------- -/* - Beschreibung: - Der ParentViewFrame ist der ViewFrame des Containers bei internem InPlace +/* [Description] + + The ParentViewFrame of the Containers ViewFrame in the internal InPlace */ //TODO/LATER: is it still necessary? is there a replacement for GetParentViewFrame_Impl? @@ -1780,7 +1779,7 @@ void SfxViewFrame::DoAdjustPosSize( SfxViewShell *pSh, //-------------------------------------------------------------------- void SfxViewFrame::GetDocNumber_Impl() { - DBG_ASSERT( GetObjectShell(), "Kein Dokument!" ); + DBG_ASSERT( GetObjectShell(), "No Document!" ); GetObjectShell()->SetNamedVisibility_Impl(); pImp->nDocViewNo = GetObjectShell()->GetNoSet_Impl().GetFreeIndex()+1; } @@ -1828,22 +1827,23 @@ void SfxViewFrame::Enable( sal_Bool bEnable ) //-------------------------------------------------------------------- void SfxViewFrame::Show() -/* [Beschreibung] +/* [Description] - Diese Methode macht das Frame-Window sichtbar und ermittelt vorher - den Fenstername. Au\serdem wird das Dokument festgehalten. Man darf - i.d.R. nie das Window direkt showen! + This method makes the Frame-Window visible and before transmitts the + window name. In addition, the document is held. In general one can never + show the window directly! */ { - // zuerst locken damit in UpdateTitle() gilt: IsVisible() == sal_True (:#) + // First lock the objectShell so that UpdateTitle() is valid: + // IsVisible() == sal_True (:#) if ( xObjSh.Is() ) { xObjSh->GetMedium()->GetItemSet()->ClearItem( SID_HIDDEN ); if ( !pImp->bObjLocked ) LockObjectShell_Impl( sal_True ); - // Doc-Shell Titel-Nummer anpassen, get unique view-no + // Adjust Doc-Shell titel nummer, get unique view-no if ( 0 == pImp->nDocViewNo ) { GetDocNumber_Impl(); @@ -1853,8 +1853,8 @@ void SfxViewFrame::Show() else UpdateTitle(); - // Frame-Window anzeigen, aber nur wenn der ViewFrame kein eigenes Window - // hat oder wenn er keine Component enth"alt + // Display Frame-window, but only if the ViewFrame has no window of its + // own or if it does not contain a Component if ( &GetWindow() == &GetFrame().GetWindow() || !GetFrame().HasComponent() ) GetWindow().Show(); GetFrame().GetWindow().Show(); @@ -1883,9 +1883,9 @@ void SfxViewFrame::Hide() //-------------------------------------------------------------------- void SfxViewFrame::LockObjectShell_Impl( sal_Bool bLock ) { - DBG_ASSERT( pImp->bObjLocked != bLock, "Falscher Locked-Status!" ); + DBG_ASSERT( pImp->bObjLocked != bLock, "Wrong Locked status!" ); - DBG_ASSERT( GetObjectShell(), "Kein Dokument!" ); + DBG_ASSERT( GetObjectShell(), "No Document!" ); GetObjectShell()->OwnerLock(bLock); pImp->bObjLocked = bLock; } @@ -1975,7 +1975,7 @@ void SfxViewFrame::SetActiveChildFrame_Impl( SfxViewFrame *pViewFrame ) if ( pViewFrame ) xActive = pViewFrame->GetFrame().GetFrameInterface(); - if ( xFrame.is() ) // PB: #74432# xFrame cann be NULL + if ( xFrame.is() ) // PB: #74432# xFrame can be NULL xFrame->setActiveFrame( xActive ); } } @@ -2236,38 +2236,35 @@ void SfxViewFrame::SaveCurrentViewData_Impl( const USHORT i_nNewViewId ) sal_Bool SfxViewFrame::SwitchToViewShell_Impl ( sal_uInt16 nViewIdOrNo, /* > 0 - Registrierungs-Id der View, auf die umge- - schaltet werden soll, bzw. die erstmalig - erzeugt werden soll. + Registration-Id of the View, to which the + the method should switch, for example the one + that will be created. == 0 - Es soll die Default-View verwendet werden. */ + First use the Default view. */ sal_Bool bIsIndex /* sal_True - 'nViewIdOrNo' ist keine Registrations-Id sondern - ein Index in die f"ur die in diesem - <SfxViewFrame> dargestellte <SfxObjectShell>. + 'nViewIdOrNo' is no Registration-Id instead + an Index of <SfxViewFrame> in <SfxObjectShell>. */ ) -/* [Beschreibung] +/* [Description] - Interne Methode zum Umschalten auf eine andere <SfxViewShell>-Subklasse, - die in diesem SfxMDIFrame erzeugt werden soll. Existiert noch - keine SfxViewShell in diesem SfxMDIFrame, so wird erstmalig eine - erzeugt. + Internal Method for switching to another <SfxViewShell> subclass, + which should be created in this SfxMDIFrame. If no SfxViewShell exist + in this SfxMDIFrame, then one will first be created. - [R"uckgabewert] + [Return Value] sal_Bool sal_True - die angeforderte SfxViewShell wurde erzeugt - und eine ggf. bestehende gel"oscht + requested SfxViewShell was created and a + possibly existing one deleted sal_False - die angeforderte SfxViewShell konnte nicht - erzeugt werden, die bestehende SfxViewShell - existiert daher weiterhin + SfxViewShell requested could not be created, + the existing SfxViewShell thus continue to exist */ { @@ -2343,19 +2340,19 @@ sal_uInt16 SfxViewFrame::GetCurViewId() const //------------------------------------------------------------------------- void SfxViewFrame::ExecView_Impl ( - SfxRequest& rReq // der auszuf"uhrende <SfxRequest> + SfxRequest& rReq // The executable <SfxRequest> ) -/* [Beschreibung] +/* [Description] - Interne Methode zum Ausf"uhren der f"ur die <SfxShell> Subklasse - SfxViewFrame in der <SVIDL> beschriebenen Slots. + Internal method to run the slot for the <SfxShell> Subclass in the + SfxViewFrame <SVIDL> described slots. */ { DBG_CHKTHIS(SfxViewFrame, 0); - // Wenn gerade die Shells ausgetauscht werden... + // If the Shells are just being replaced... if ( !GetObjectShell() || !GetViewShell() ) return; @@ -2397,14 +2394,14 @@ void SfxViewFrame::ExecView_Impl case SID_NEWWINDOW: { - // Hack. demnaechst virtuelle Funktion + // Hack. at the moment a virtual Function if ( !GetViewShell()->NewWindowAllowed() ) { OSL_ENSURE( false, "You should have disabled the 'Window/New Window' slot!" ); return; } - // ViewData bei FrameSets rekursiv holen + // Get ViewData of FrameSets recursivly. GetFrame().GetViewData_Impl(); SfxMedium* pMed = GetObjectShell()->GetMedium(); @@ -2495,8 +2492,9 @@ sal_Bool impl_maxOpenDocCountReached() ++nOpenDocs; } catch(const css::uno::Exception&) - // A IndexOutOfBoundException can happen in multithreaded environments, - // where any other thread can change this container ! + // A IndexOutOfBoundException can happen in multithreaded + // environments, where any other thread can change this + // container ! { continue; } } @@ -2514,22 +2512,20 @@ sal_Bool impl_maxOpenDocCountReached() //------------------------------------------------------------------------- void SfxViewFrame::StateView_Impl ( - SfxItemSet& rSet /* leeres <SfxItemSet> mit <Which-Ranges>, - welche die Ids der zu erfragenden - Slots beschreiben. */ + SfxItemSet& rSet /* empty <SfxItemSet> with <Which-Ranges>, + which describes the Slot Ids */ ) -/* [Beschreibung] +/* [Description] - Diese interne Methode liefert in 'rSet' die Status der f"ur die - <SfxShell> Subklasse SfxViewFrame in der <SVIDL> beschriebenen <Slots>. + This internal methode returns in 'rSet' the Status for the <SfxShell> + Subclass SfxViewFrame in the <SVIDL> described <Slots>. - In 'rSet' sind dabei genau die vom SFx als ung"ultig erkannten - Slot-Ids als Which-ranges enthalten. Falls der an dieser Shell gesetzte - <SfxItemPool> f"ur einzelne Slot-Ids ein Mapping hat, werden die - entsprechenden Which-Ids verwendet, so da\s Items ggf. direkt mit - einer mit Which-Ids arbeitenden Core-::com::sun::star::script::Engine ausgetauscht werden - k"onnen. + Thus exactly those Slots-IDs that are recognized as beeing invalid by Sfx + are included as Which-ranges in 'rSet'. If there exists a mapping for + single slot-IDs of the <SfxItemPool> set in the shell, then the respective + Which-IDs are used so that items can be replaced directly with a working + Core::sun::com::star::script::Engine of the Which-IDs if possible. . */ { @@ -2538,11 +2534,11 @@ void SfxViewFrame::StateView_Impl SfxObjectShell *pDocSh = GetObjectShell(); if ( !pDocSh ) - // Ich bin gerade am Reloaden und Yielde so vor mich hin ... + // I'm just on reload and am yielding myself ... return; const sal_uInt16 *pRanges = rSet.GetRanges(); - DBG_ASSERT(pRanges, "Set ohne Bereich"); + DBG_ASSERT(pRanges, "Set with no Range"); while ( *pRanges ) { for ( sal_uInt16 nWhich = *pRanges++; nWhich <= *pRanges; ++nWhich ) @@ -2605,9 +2601,9 @@ void SfxViewFrame::ToTop() //------------------------------------------------------------------------- SfxViewFrame* SfxViewFrame::GetParentViewFrame() const -/* - Beschreibung: - Der ParentViewFrame ist der ViewFrame des ParentFrames +/* [Description] + + The ParentViewFrame is the ViewFrame of the ParentFrames. */ { SfxFrame *pFrame = GetFrame().GetParentFrame(); @@ -2616,9 +2612,9 @@ SfxViewFrame* SfxViewFrame::GetParentViewFrame() const //------------------------------------------------------------------------- SfxFrame& SfxViewFrame::GetFrame() const -/* - Beschreibung: - GetFrame liefert den Frame, in dem sich der ViewFrame befindet +/* [Description] + + GetFrame returns the Frame, in which the ViewFrame is located. */ { return pImp->rFrame; @@ -2697,11 +2693,11 @@ void CutLines( ::rtl::OUString& rStr, sal_Int32 nStartLine, sal_Int32 nLines, BO nStartPos = rStr.indexOf( LINE_SEP, nStartPos ); if( nStartPos == -1 ) break; - nStartPos++; // nicht das \n. + nStartPos++; // not the \n. nLine++; } - DBG_ASSERTWARNING( nStartPos != STRING_NOTFOUND, "CutLines: Startzeile nicht gefunden!" ); + DBG_ASSERTWARNING( nStartPos != STRING_NOTFOUND, "CutLines: Start row not found!" ); if ( nStartPos != -1 ) { @@ -2709,7 +2705,7 @@ void CutLines( ::rtl::OUString& rStr, sal_Int32 nStartLine, sal_Int32 nLines, BO for ( sal_Int32 i = 0; i < nLines; i++ ) nEndPos = rStr.indexOf( LINE_SEP, nEndPos+1 ); - if ( nEndPos == -1 ) // kann bei letzter Zeile passieren + if ( nEndPos == -1 ) // Can happen at the last row. nEndPos = rStr.getLength(); else nEndPos++; @@ -2735,9 +2731,9 @@ void CutLines( ::rtl::OUString& rStr, sal_Int32 nStartLine, sal_Int32 nLines, BO } /* - add new recorded dispatch macro script into the application global basic lib container - It generates a new unique id for it and insert the macro by using this number as name for - the modul + add new recorded dispatch macro script into the application global basic + lib container. It generates a new unique id for it and insert the macro + by using this number as name for the modul */ void SfxViewFrame::AddDispatchMacroToBasic_Impl( const ::rtl::OUString& sMacro ) { @@ -3023,7 +3019,7 @@ void SfxViewFrame::MiscExec_Impl( SfxRequest& rReq ) if ( xLayoutManager.is() ) { rtl::OUString aStatusbarResString( RTL_CONSTASCII_USTRINGPARAM( "private:resource/statusbar/statusbar" )); - // Parameter auswerten + // Evaluate parameter. SFX_REQUEST_ARG(rReq, pShowItem, SfxBoolItem, rReq.GetSlot(), FALSE); BOOL bShow( TRUE ); if ( !pShowItem ) @@ -3118,7 +3114,7 @@ void SfxViewFrame::MiscState_Impl(SfxItemSet &rSet) DBG_MEMTEST(); const USHORT *pRanges = rSet.GetRanges(); - DBG_ASSERT(pRanges && *pRanges, "Set ohne Bereich"); + DBG_ASSERT(pRanges && *pRanges, "Set without range"); while ( *pRanges ) { for(USHORT nWhich = *pRanges++; nWhich <= *pRanges; ++nWhich) @@ -3127,7 +3123,7 @@ void SfxViewFrame::MiscState_Impl(SfxItemSet &rSet) { case SID_CURRENT_URL: { - // Bei internem InPlace den ContainerFrame nehmen + // Get the ContainerFrame, when internal InPlace. SfxViewFrame *pFrame = this; if ( pFrame->GetParentViewFrame_Impl() ) pFrame = pFrame->GetParentViewFrame_Impl(); @@ -3228,7 +3224,6 @@ void SfxViewFrame::MiscState_Impl(SfxItemSet &rSet) } default: - //! DBG_ASSERT(FALSE, "Falscher Server fuer GetState"); break; } } @@ -3239,17 +3234,16 @@ void SfxViewFrame::MiscState_Impl(SfxItemSet &rSet) void SfxViewFrame::ChildWindowExecute( SfxRequest &rReq ) -/* [Beschreibung] +/* [Description] - Diese Methode kann in der Execute-Methode f"ur das ein- und ausschalten - von Child-Windows eingesetzt werden, um dieses inkl. API-Anbindung zu - implementieren. + This method can be included in the Execute method for the on- and off- + switching of ChildWindows, to implement this and API-bindings. - Einfach in der IDL als 'ExecuteMethod' eintragen. + Simply include as 'ExecuteMethod' in the IDL. */ { - // Parameter auswerten + // Evaluate Parameter USHORT nSID = rReq.GetSlot(); SFX_REQUEST_ARG(rReq, pShowItem, SfxBoolItem, nSID, FALSE); @@ -3303,14 +3297,14 @@ void SfxViewFrame::ChildWindowExecute( SfxRequest &rReq ) BOOL bHasChild = HasChildWindow(nSID); bShow = pShowItem ? pShowItem->GetValue() : !bHasChild; - // ausf"uhren + // Perform action. if ( !pShowItem || bShow != bHasChild ) ToggleChildWindow( nSID ); GetBindings().Invalidate( nSID ); GetDispatcher()->Update_Impl( TRUE ); - // ggf. recorden + // Record if possible. if ( nSID == SID_HYPERLINK_DIALOG || nSID == SID_SEARCH_DLG ) { rReq.Ignore(); @@ -3326,12 +3320,12 @@ void SfxViewFrame::ChildWindowExecute( SfxRequest &rReq ) void SfxViewFrame::ChildWindowState( SfxItemSet& rState ) -/* [Beschreibung] +/* [Description] - Diese Methode kann in der Status-Methode f"ur das Ein- und Ausschalt- - Zustand von Child-Windows eingesetzt werden, um dieses zu implementieren. + This method can be used in the state method for the on and off-state + of child-windows, in order to implement this. - Einfach in der IDL als 'StateMethod' eintragen. + Just register the IDL as 'StateMethod'. */ { diff --git a/sfx2/source/view/viewfrm2.cxx b/sfx2/source/view/viewfrm2.cxx index 9bc48b5ef64f..86d634cfd531 100644 --- a/sfx2/source/view/viewfrm2.cxx +++ b/sfx2/source/view/viewfrm2.cxx @@ -146,21 +146,20 @@ static String _getTabString() //-------------------------------------------------------------------- String SfxViewFrame::UpdateTitle() -/* [Beschreibung] +/* [Description] - Mit dieser Methode kann der SfxViewFrame gezwungen werden, sich sofort - den neuen Titel vom der <SfxObjectShell> zu besorgen. + With this method, can the SfxViewFrame be forced to immediately provide + the new title from the <SfxObjectShell>. - [Anmerkung] + [Note] - Dies ist z.B. dann notwendig, wenn man der SfxObjectShell als SfxListener - zuh"ort und dort auf den <SfxSimpleHint> SFX_HINT_TITLECHANGED reagieren - m"ochte, um dann die Titel seiner Views abzufragen. Diese Views (SfxTopViewFrames) - jedoch sind ebenfalls SfxListener und da die Reihenfolge der Benachrichtigung - nicht feststeht, mu\s deren Titel-Update vorab erzwungen werden. + This is for example necessary if one listens to the SfxObjectShell as + SfxListener and then react on the <SfxSimpleHint> SFX_HINT_TITLECHANGED, + then query the title of his views. However these views (SfxTopViewFrames) + are also SfxListener and because the order of notifications might not be + fixed, the title update will be enforced in advance. - - [Beispiel] + [Example] void SwDocShell::Notify( SfxBroadcaster& rBC, const SfxHint& rHint ) { @@ -194,7 +193,7 @@ String SfxViewFrame::UpdateTitle() return String(); // if ( pObjSh->GetCreateMode() == SFX_CREATE_MODE_EMBEDDED ) -// // kein UpdateTitle mit Embedded-ObjectShell +// // No UpdateTitle with Embedded-ObjectShell // return String(); const SfxMedium *pMedium = pObjSh->GetMedium(); @@ -207,10 +206,10 @@ String SfxViewFrame::UpdateTitle() } if ( aURL != pImp->aActualURL ) - // URL hat sich ge"andert + // URL has changed pImp->aActualURL = aURL; - // gibt es noch eine weitere View? + // Is there another view? sal_uInt16 nViews=0; for ( SfxViewFrame *pView= GetFirst(pObjSh); pView && nViews<2; @@ -219,15 +218,15 @@ String SfxViewFrame::UpdateTitle() !IsDowning_Impl()) nViews++; - // Titel des Fensters + // Window Title String aTitle; if ( nViews == 2 || pImp->nDocViewNo > 1 ) - // dann die Nummer dranh"angen + // Then attach the number aTitle = pObjSh->UpdateTitle( NULL, pImp->nDocViewNo ); else aTitle = pObjSh->UpdateTitle(); - // Name des SbxObjects + // SbxObjects name String aSbxName = pObjSh->SfxShell::GetName(); if ( IsVisible() ) { @@ -271,7 +270,7 @@ String SfxViewFrame::UpdateTitle() void SfxViewFrame::Exec_Impl(SfxRequest &rReq ) { - // Wenn gerade die Shells ausgetauscht werden... + // If presently the shells are replaced... if ( !GetObjectShell() || !GetViewShell() ) return; @@ -284,20 +283,19 @@ void SfxViewFrame::Exec_Impl(SfxRequest &rReq ) SFX_REQUEST_ARG(rReq, pIdItem, SfxUInt16Item, SID_CONFIGITEMID, FALSE); USHORT nId = pIdItem ? pIdItem->GetValue() : 0; - // ausfuehren SfxWorkWindow *pWorkWin = GetFrame().GetWorkWindow_Impl(); if ( bShow ) { - // Zuerst die Floats auch anzeigbar machen + // First, make the floats viewable pWorkWin->MakeChildsVisible_Impl( bShow ); GetDispatcher()->Update_Impl( TRUE ); - // Dann anzeigen + // Then view it GetBindings().HidePopups( !bShow ); } else { - // Alles hiden + // Hide all SfxBindings *pBind = &GetBindings(); while ( pBind ) { @@ -357,7 +355,7 @@ void SfxViewFrame::Exec_Impl(SfxRequest &rReq ) if ( GetViewShell()->PrepareClose() ) { - // weitere Views auf dasselbe Doc? + // More Views on the same Document? SfxObjectShell *pDocSh = GetObjectShell(); int bOther = sal_False; for ( const SfxViewFrame* pFrame = SfxViewFrame::GetFirst( pDocSh ); @@ -365,14 +363,14 @@ void SfxViewFrame::Exec_Impl(SfxRequest &rReq ) pFrame = SfxViewFrame::GetNext( *pFrame, pDocSh ) ) bOther = (pFrame != this); - // Doc braucht nur gefragt zu werden, wenn keine weitere View + // Document only needs to be queried, if no other View present. sal_Bool bClosed = sal_False; sal_Bool bUI = TRUE; if ( ( bOther || pDocSh->PrepareClose( bUI ) ) ) { if ( !bOther ) pDocSh->SetModified( FALSE ); - rReq.Done(); // unbedingt vor Close() rufen! + rReq.Done(); // Must call this before Close()! bClosed = sal_False; try { @@ -402,7 +400,7 @@ void SfxViewFrame::GetState_Impl( SfxItemSet &rSet ) return; const sal_uInt16 *pRanges = rSet.GetRanges(); - DBG_ASSERT(pRanges, "Set ohne Bereich"); + DBG_ASSERT(pRanges, "Set without Range"); while ( *pRanges ) { for ( sal_uInt16 nWhich = *pRanges++; nWhich <= *pRanges; ++nWhich ) @@ -494,7 +492,7 @@ void SfxViewFrame::INetState_Impl( SfxItemSet &rItemSet ) rItemSet.DisableItem( SID_BROWSE_FORWARD ); rItemSet.DisableItem( SID_BROWSE_BACKWARD ); - // Add/SaveToBookmark bei BASIC-IDE, QUERY-EDITOR etc. disablen + // Add/SaveToBookmark at BASIC-IDE, QUERY-EDITOR etc. disable SfxObjectShell *pDocSh = GetObjectShell(); sal_Bool bPseudo = pDocSh && !( pDocSh->GetFactory().GetFlags() & SFXOBJECTSHELL_HASOPENDOC ); sal_Bool bEmbedded = pDocSh && pDocSh->GetCreateMode() == SFX_CREATE_MODE_EMBEDDED; @@ -509,18 +507,18 @@ void SfxViewFrame::SetZoomFactor( const Fraction &rZoomX, const Fraction &rZoomY void SfxViewFrame::Activate( sal_Bool bMDI ) { - DBG_ASSERT(GetViewShell(), "Keine Shell"); + DBG_ASSERT(GetViewShell(), "No Shell"); if ( bMDI ) pImp->bActive = sal_True; -//(mba): hier evtl. wie in Beanframe NotifyEvent ?! +//(mba): here maybe as in Beanframe NotifyEvent ?! } void SfxViewFrame::Deactivate( sal_Bool bMDI ) { - DBG_ASSERT(GetViewShell(), "Keine Shell"); + DBG_ASSERT(GetViewShell(), "No Shell"); if ( bMDI ) pImp->bActive = sal_False; -//(mba): hier evtl. wie in Beanframe NotifyEvent ?! +//(mba): here maybe as in Beanframe NotifyEvent ?! } /* vim:set shiftwidth=4 softtabstop=4 expandtab: */ diff --git a/sfx2/source/view/viewprn.cxx b/sfx2/source/view/viewprn.cxx index b6ff13214bb4..001a0019de7e 100644 --- a/sfx2/source/view/viewprn.cxx +++ b/sfx2/source/view/viewprn.cxx @@ -357,10 +357,10 @@ void SfxPrinterController::jobFinished( com::sun::star::view::PrintableState nSt void DisableRanges( PrintDialog& rDlg, SfxPrinter* pPrinter ) -/* [Beschreibung] +/* [Description] - Mit dieser Funktion werden die nicht verf"ugbaren Ranges - vom Printer zum PrintDialog geforwarded. + This function forwards the non-available ranges from the printer + to the print dialog. */ { @@ -381,13 +381,12 @@ void DisableRanges( PrintDialog& rDlg, SfxPrinter* pPrinter ) class SfxDialogExecutor_Impl -/* [Beschreibung] +/* [Description] - Eine Instanz dieser Klasse wird f"ur die Laufzeit des Printer-Dialogs - erzeugt, um im dessen Click-Handler f"ur die Zus"atze den per - virtueller Methode von der abgeleiteten SfxViewShell erzeugten - Print-Options-Dialog zu erzeugen und die dort eingestellten Optionen - als SfxItemSet zu zwischenzuspeichern. + An instance of this class is created for the life span of the + printer dialogue, to create in its click handler for the additions by the + virtual method of the derived SfxViewShell generated print options dialogue + and to cache the options set there as SfxItemSet. */ { @@ -441,7 +440,7 @@ SfxDialogExecutor_Impl::SfxDialogExecutor_Impl( SfxViewShell* pViewSh, PrinterSe IMPL_LINK( SfxDialogExecutor_Impl, Execute, void *, EMPTYARG ) { - // Options lokal merken + // Options noted locally if ( !_pOptions ) { DBG_ASSERT( _pPrintParent || _pSetupParent, "no dialog parent" ); @@ -462,7 +461,7 @@ IMPL_LINK( SfxDialogExecutor_Impl, Execute, void *, EMPTYARG ) } } - // Dialog ausf"uhren + // Create Dialog SfxPrintOptionsDialog* pDlg = new SfxPrintOptionsDialog( _pPrintParent ? static_cast<Window*>(_pPrintParent) : static_cast<Window*>(_pSetupParent), _pViewSh, _pOptions ); @@ -492,15 +491,16 @@ IMPL_LINK( SfxDialogExecutor_Impl, Execute, void *, EMPTYARG ) SfxPrinter* SfxViewShell::SetPrinter_Impl( SfxPrinter *pNewPrinter ) -/* Interne Methode zum Setzen der Unterschiede von 'pNewPrinter' zum - aktuellen Printer. pNewPrinter wird entweder "ubernommen oder gel"oscht. + +/* Internal method for setting the differences between 'pNewPrinter' to the + current printer. pNewPrinter is either taken over or deleted. */ { - // aktuellen Printer holen + // get current Printer SfxPrinter *pDocPrinter = GetPrinter(); - // Printer-Options auswerten + // Evaluate Printer Options bool bOriToDoc = false; bool bSizeToDoc = false; if ( &pDocPrinter->GetOptions() ) @@ -512,15 +512,15 @@ SfxPrinter* SfxViewShell::SetPrinter_Impl( SfxPrinter *pNewPrinter ) bSizeToDoc = pFlagItem ? (pFlagItem->GetValue() & SFX_PRINTER_CHG_SIZE) : FALSE; } - // vorheriges Format und Size feststellen + // Determine the previous format and size Orientation eOldOri = pDocPrinter->GetOrientation(); Size aOldPgSz = pDocPrinter->GetPaperSizePixel(); - // neues Format und Size feststellen + // Determine the new format and size Orientation eNewOri = pNewPrinter->GetOrientation(); Size aNewPgSz = pNewPrinter->GetPaperSizePixel(); - // "Anderungen am Seitenformat feststellen + // Determine the changes in page format BOOL bOriChg = (eOldOri != eNewOri) && bOriToDoc; BOOL bPgSzChg = ( aOldPgSz.Height() != ( bOriChg ? aNewPgSz.Width() : aNewPgSz.Height() ) || @@ -528,7 +528,7 @@ SfxPrinter* SfxViewShell::SetPrinter_Impl( SfxPrinter *pNewPrinter ) ( bOriChg ? aNewPgSz.Height() : aNewPgSz.Width() ) ) && bSizeToDoc; - // Message und Flags f"ur Seitenformat-"Anderung zusammenstellen + // Message and Flags for page format, summaries changes String aMsg; USHORT nNewOpt=0; if( bOriChg && bPgSzChg ) @@ -547,49 +547,49 @@ SfxPrinter* SfxViewShell::SetPrinter_Impl( SfxPrinter *pNewPrinter ) nNewOpt = SFX_PRINTER_CHG_SIZE; } - // in dieser Variable sammeln, was sich so ge"aendert hat + // Summaries in this variable what has been changed. USHORT nChangedFlags = 0; - // ggf. Nachfrage, ob Seitenformat vom Drucker "ubernommen werden soll + // Ask if possible, if page format should be taken over from printer. if ( ( bOriChg || bPgSzChg ) && RET_YES == QueryBox(0, WB_YES_NO | WB_DEF_OK, aMsg).Execute() ) - // Flags mit "Anderungen f"ur <SetPrinter(SfxPrinter*)> mitpflegen + // Flags wich changes for <SetPrinter(SfxPrinter*)> are maintained nChangedFlags |= nNewOpt; - // fuer den MAC sein "temporary of class String" im naechsten if() + // For the MAC to have its "temporary of class String" in next if() String aTempPrtName = pNewPrinter->GetName(); String aDocPrtName = pDocPrinter->GetName(); - // Wurde der Drucker gewechselt oder von Default auf Specific - // oder umgekehrt geaendert? + // Was the printer selection changed from Default to Specific + // or the other way around? if ( (aTempPrtName != aDocPrtName) || (pDocPrinter->IsDefPrinter() != pNewPrinter->IsDefPrinter()) ) { - // neuen Printer "ubernehmen + // Get the new printer // pNewPrinter->SetOrigJobSetup( pNewPrinter->GetJobSetup() ); nChangedFlags |= SFX_PRINTER_PRINTER|SFX_PRINTER_JOBSETUP; pDocPrinter = pNewPrinter; } else { - // Extra-Optionen vergleichen + // Compare extra options if ( ! (pNewPrinter->GetOptions() == pDocPrinter->GetOptions()) ) { - // Options haben sich geaendert + // Option have changed pDocPrinter->SetOptions( pNewPrinter->GetOptions() ); nChangedFlags |= SFX_PRINTER_OPTIONS; } - // JobSetups vergleichen + // Compare JobSetups JobSetup aNewJobSetup = pNewPrinter->GetJobSetup(); JobSetup aOldJobSetup = pDocPrinter->GetJobSetup(); if ( aNewJobSetup != aOldJobSetup ) { - // JobSetup hat sich geaendert (=> App mu\s neu formatieren) + // JobSetup has chaged => App must be formatted again) // pDocPrinter->SetOrigJobSetup( aNewJobSetup ); nChangedFlags |= SFX_PRINTER_JOBSETUP; } - // alten, ver"anderten Printer behalten + // Keep old changed Printer. pDocPrinter->SetPrinterProps( pNewPrinter ); delete pNewPrinter; } @@ -601,10 +601,9 @@ SfxPrinter* SfxViewShell::SetPrinter_Impl( SfxPrinter *pNewPrinter ) } //------------------------------------------------------------------------- -// Unter WIN32 tritt leider das Problem auf, dass nichts gedruckt -// wird, wenn SID_PRINTDOCDIRECT auflaueft; bisher bekannte, -// einzige Abhilfe ist in diesem Fall das Abschalten der Optimierungen -// (KA 17.12.95) +// Sadly enough the problem arises with WIN32 that nothing is printed when +// SID_PRINTDOCDIRECT auflaueft. At the moment the only known solution in this +// case is to turn off the optimazation. #ifdef _MSC_VER #pragma optimize ( "", off ) #endif @@ -673,7 +672,8 @@ void SfxViewShell::ExecPrint_Impl( SfxRequest &rReq ) //FIXME: how to transport "bPrintOnHelp"? // no help button in dialogs if called from the help window - // (pressing help button would exchange the current page inside the help document that is going to be printed!) + // (pressing help button would exchange the current page inside the help + // document that is going to be printed!) String aHelpFilterName( DEFINE_CONST_UNICODE("writer_web_HTML_help") ); SfxMedium* pMedium = GetViewFrame()->GetObjectShell()->GetMedium(); const SfxFilter* pFilter = pMedium ? pMedium->GetFilter() : NULL; @@ -890,7 +890,7 @@ void SfxViewShell::ExecPrint_Impl( SfxRequest &rReq ) } } -// Optimierungen wieder einschalten +// Turn on optimazation again. #ifdef _MSC_VER #pragma optimize ( "", on ) #endif @@ -899,11 +899,11 @@ void SfxViewShell::ExecPrint_Impl( SfxRequest &rReq ) PrintDialog* SfxViewShell::CreatePrintDialog( Window* /*pParent*/ ) -/* [Beschreibung] +/* [Description] - Diese Methode kann "uberladen werden, um einen speziellen PrintDialog - zu erzeugen. Dies ist z.B. notwendig wenn spezielle <StarView> Features - wie drucken von Seitenbereichen. + This Method can be overloaded to create a tailored PrintDialog. + This is for example necessary when using special <StarView> Features + as printing of page breaks. */ { diff --git a/sfx2/source/view/viewsh.cxx b/sfx2/source/view/viewsh.cxx index 8dad33533f3e..7a9376b7daf5 100644 --- a/sfx2/source/view/viewsh.cxx +++ b/sfx2/source/view/viewsh.cxx @@ -692,15 +692,15 @@ void SfxViewShell::ExecMisc_Impl( SfxRequest &rReq ) { SFX_REQUEST_ARG(rReq, pShowItem, SfxBoolItem, nId, FALSE); BOOL bActive = pShowItem ? pShowItem->GetValue() : !pImp->bPlugInsActive; - // ggf. recorden + // Record if possible if ( !rReq.IsAPI() ) rReq.AppendItem( SfxBoolItem( nId, bActive ) ); - // Jetzt schon DONE aufrufen, da die Argumente evtl. einen Pool - // benutzen, der demn"achst weg ist + // Call DONE here already since there might be arguments that + // are using Pool, which can be gone. rReq.Done(TRUE); - // ausfuehren + // Execute if ( !pShowItem || bActive != pImp->bPlugInsActive ) { SfxFrame* pTopFrame = &GetFrame()->GetTopFrame(); @@ -769,7 +769,7 @@ void SfxViewShell::GetState_Impl( SfxItemSet &rSet ) break; } - // Printer-Funktionen + // Printer functions case SID_PRINTDOC: case SID_PRINTDOCDIRECT: case SID_SETUPPRINTER: @@ -815,7 +815,7 @@ void SfxViewShell::GetState_Impl( SfxItemSet &rSet ) break; } - // Mail-Funktionen + // Mail functions case SID_MAIL_SENDDOCASPDF: case SID_MAIL_SENDDOC: case SID_MAIL_SENDDOCASFORMAT: @@ -871,12 +871,11 @@ void SfxViewShell::SetZoomFactor( const Fraction &rZoomX, //-------------------------------------------------------------------- ErrCode SfxViewShell::DoVerb(long /*nVerb*/) -/* [Beschreibung] - - Virtuelle Methode, um am selektierten Objekt ein Verb auszuf"uhren. - Da dieses Objekt nur den abgeleiteten Klassen bekannt ist, muss DoVerb - dort "uberschrieben werden. +/* [Description] + Virtual Method used to perform a Verb on a selected Object. + Since this Object is just known by the derived classes, DoVerb + must be overloaded. */ { @@ -1026,8 +1025,8 @@ void SfxViewShell::Deactivate(BOOL /*bMDI*/) void SfxViewShell::AdjustPosSizePixel ( - const Point& /*rToolOffset*/,// linke obere Ecke der Tools im Frame-Window - const Size& /*rSize*/ // gesamte zur Verf"ugung stehende Gr"o\se + const Point& /*rToolOffset*/,// Upper left corner Tools in Frame-Window + const Size& /*rSize*/ // All available sizes. ) { @@ -1038,20 +1037,19 @@ void SfxViewShell::AdjustPosSizePixel void SfxViewShell::Move() -/* [Beschreibung] - - Diese virtuelle Methode wird gerufen, wenn das Fenster, in dem die - SfxViewShell dargestellt wird eine StarView-Move() Nachricht erh"alt. +/* [Description] - Die Basisimplementierung braucht nicht gerufen zu werden. + This virtual Method is called when the window displayed in the + SfxViewShell gets a StarView-Move() notification. + This base implementation does not have to be called. . - [Anmerkung] + [Note] - Diese Methode kann dazu verwendet werden, eine Selektion abzubrechen, - um durch das Moven des Fensters erzeugte Maus-Bewegungen anzufangen. + This Method can be used to cancel a selection, in order to catch the + mouse movement which is due to moving a window. - Zur Zeit funktioniert die Benachrichtigung nicht In-Place. + For now the notification does not work In-Place. */ { @@ -1061,48 +1059,45 @@ void SfxViewShell::Move() void SfxViewShell::OuterResizePixel ( - const Point& /*rToolOffset*/,// linke obere Ecke der Tools im Frame-Window - const Size& /*rSize*/ // gesamte zur Verf"ugung stehende Gr"o\se + const Point& /*rToolOffset*/,// Upper left corner Tools in Frame-Window + const Size& /*rSize*/ // All available sizes. ) -/* [Beschreibung] - - Diese Methode muss ueberladen werden, um auf "Anderungen der Groesse - der View zu reagieren. Dabei definieren wir die View als das Edit-Window - zuz"uglich der um das Edit-Window angeordnenten Tools (z.B. Lineale). +/* [Description] - Das Edit-Window darf weder in Gr"o\se noch Position ver"andert werden. + This Method has to be overloaded to be able to react to the size-change of + the View. Thus the View is defined as the Edit window and also the + attached Tools are defined (for example the ruler). - Die Vis-Area der SfxObjectShell, dessen Skalierung und Position - d"urfen hier ver"andert werden. Der Hauptanwendungsfall ist dabei, - das Ver"andern der Gr"o\se der Vis-Area. + The Edit window must not be changed either in size or position. - "Andert sich durch die neue Berechnung der Border, so mu\s dieser - mit <SfxViewShell::SetBorderPixel(const SvBorder&)> gesetzt werden. - Erst nach Aufruf von 'SetBorderPixel' ist das Positionieren von - Tools erlaubt. + The Vis-Area of SfxObjectShell, its scale and position can be changed + here. The mainuse is to change the size of the Vis-Area. + If the Border is changed due to the new calculation then this has to be set + by <SfxViewShell::SetBorderPixel(const SvBorder&)>. The Postioning of Tools + is only allowed after the calling of 'SetBorderPixel'. - [Beispiel] + [Example] void AppViewSh::OuterViewResizePixel( const Point &rOfs, const Size &rSz ) - { - // Tool-Positionen und Gr"o\sen von au\sen berechnen, NICHT setzen! - // (wegen folgender Border-Berechnung) + +{ + // Calculate Tool position and size externally, do not set! + // (due to the following Border calculation) Point aHLinPos...; Size aHLinSz...; ... - // Border f"ur Tools passend zu rSize berechnen und setzen + // Calculate and Set a Border of Tools which matches rSize. SvBorder aBorder... - SetBorderPixel( aBorder ); // ab jetzt sind Positionierungen erlaubt + SetBorderPixel( aBorder ); // Allow Positioning from here on. - // Tools anordnen + // Arrange Tools pHLin->SetPosSizePixel( aHLinPos, aHLinSz ); ... } - - [Querverweise] + [Cross-reference] <SfxViewShell::InnerResizePixel(const Point&,const Size& rSize)> */ @@ -1116,45 +1111,44 @@ void SfxViewShell::OuterResizePixel void SfxViewShell::InnerResizePixel ( - const Point& /*rToolOffset*/,// linke obere Ecke der Tools im Frame-Window - const Size& /*rSize*/ // dem Edit-Win zur Verf"ugung stehende Gr"o\se + const Point& /*rToolOffset*/,// Upper left corner Tools in Frame-Window + const Size& /*rSize*/ // All available sizes. ) -/* [Beschreibung] +/* [Description] - Diese Methode muss ueberladen werden, um auf "Anderungen der Groesse - des Edit-Windows zu reagieren. + This Method has to be overloaded to be able to react to the size-change of + the Edit window. - Das Edit-Window darf weder in Gr"o\se noch Position ver"andert werden. - Weder die Vis-Area der SfxObjectShell noch dessen Skalierung oder - Position d"urfen ver"andert werden. + The Edit window must not be changed either in size or position. + Neither the Vis-Area of SfxObjectShell nor its scale or position are + allowed to be changed - "Andert sich durch die neue Berechnung der Border, so mu\s dieser - mit <SfxViewShell::SetBorderPixel(const SvBorder&)> gesetzt werden. - Erst nach Aufruf von 'SetBorderPixel' ist das Positionieren von - Tools erlaubt. + If the Border is changed due to the new calculation then is has to be set + by <SfxViewShell::SetBorderPixel(const SvBorder&)>. + The Postioning of Tools is only allowed after the calling of + 'SetBorderPixel'. - [Beispiel] + [Note] void AppViewSh::InnerViewResizePixel( const Point &rOfs, const Size &rSz ) { - // Tool-Positionen und Gr"o\sen von innen berechnen, NICHT setzen! - // (wegen folgender Border-Berechnung) + // Calculate Tool position and size internally, do not set! + // (due to the following Border calculation) Point aHLinPos...; Size aHLinSz...; ... - // Border f"ur Tools passend zu rSz berechnen und setzen + // Calculate and Set a Border of Tools which matches rSize. SvBorder aBorder... - SetBorderPixel( aBorder ); // ab jetzt sind Positionierungen erlaubt + SetBorderPixel( aBorder ); // Allow Positioning from here on. - // Tools anordnen + // Arrange Tools pHLin->SetPosSizePixel( aHLinPos, aHLinSz ); ... } - - [Querverweise] + [Cross-reference] <SfxViewShell::OuterResizePixel(const Point&,const Size& rSize)> */ @@ -1207,29 +1201,28 @@ const SvBorder& SfxViewShell::GetBorderPixel() const void SfxViewShell::SetWindow ( - Window* pViewPort // Pointer auf das Datenfenster bzw. 0 im Destruktor + Window* pViewPort // For example Null pointer in the Destructor. ) -/* [Beschreibung] +/* [Description] - Mit dieser Methode wird der SfxViewShell das Datenfenster mitgeteilt. - Dieses wird f"ur den In-Place-Container und f"ur das korrekte - Wiederherstellen des Focus ben"otigt. + With this method the SfxViewShell is set in the data window. This is + needed for the in-place container and for restoring the proper focus. - Selbst In-Place-aktiv ist das Umsetzen des ViewPort-Windows verboten. + Even in-place-active the conversion of the ViewPort Windows is forbidden. */ { if( pWindow == pViewPort ) return; - // ggf. vorhandene IP-Clients disconnecten + // Disconnect existing IP-Clients if possible DisconnectAllClients(); //TODO: should we have a "ReconnectAllClients" method? DiscardClients_Impl(); - // View-Port austauschen + // Switch View-Port BOOL bHadFocus = pWindow ? pWindow->HasChildPathFocus( TRUE ) : FALSE; pWindow = pViewPort; @@ -1242,7 +1235,7 @@ void SfxViewShell::SetWindow if ( bHadFocus && pWindow ) pWindow->GrabFocus(); //TODO/CLEANUP - //brauchen wir die Methode doch noch?! + //Do we still need this Method?! //SFX_APP()->GrabFocus( pWindow ); } @@ -1258,9 +1251,9 @@ Size SfxViewShell::GetOptimalSizePixel() const SfxViewShell::SfxViewShell ( - SfxViewFrame* pViewFrame, /* <SfxViewFrame>, in dem diese View - dargestellt wird */ - USHORT nFlags /* siehe <SfxViewShell-Flags> */ + SfxViewFrame* pViewFrame, /* <SfxViewFrame>, which will be + displayed in this View */ + USHORT nFlags /* See <SfxViewShell-Flags> */ ) : SfxShell(this) @@ -1295,8 +1288,8 @@ SfxViewShell::SfxViewShell SetPool( &pViewFrame->GetObjectShell()->GetPool() ); StartListening(*pViewFrame->GetObjectShell()); - // in Liste eintragen - const SfxViewShell *pThis = this; // wegen der kranken Array-Syntax + // Insert into list + const SfxViewShell *pThis = this; // due to the sick Array syntax SfxViewShellArr_Impl &rViewArr = SFX_APP()->GetViewShells_Impl(); rViewArr.Insert(pThis, rViewArr.Count() ); } @@ -1307,7 +1300,7 @@ SfxViewShell::~SfxViewShell() { DBG_DTOR(SfxViewShell, 0); - // aus Liste austragen + // Remove from list const SfxViewShell *pThis = this; SfxViewShellArr_Impl &rViewArr = SFX_APP()->GetViewShells_Impl(); rViewArr.Remove( rViewArr.GetPos(pThis) ); @@ -1339,7 +1332,7 @@ SfxViewShell::~SfxViewShell() USHORT SfxViewShell::PrepareClose ( - BOOL bUI, // TRUE: Dialoge etc. erlaubt, FALSE: silent-mode + BOOL bUI, // TRUE: Allow Dialog and so on, FALSE: silent-mode BOOL /*bForBrowsing*/ ) { @@ -1394,12 +1387,12 @@ SfxViewShell* SfxViewShell::Get( const Reference< XController>& i_rController ) SdrView* SfxViewShell::GetDrawView() const -/* [Beschreibung] +/* [Description] - Diese virtuelle Methode mu\s von den Subklassen "uberladen werden, wenn - der Property-Editor zur Verf"ugung stehen soll. + This virtual Method has to be overloded by the sub classes, to be able + make the Property-Editor available. - Die Default-Implementierung liefert immer 0. + The default implementation does always return zero. */ { @@ -1411,26 +1404,25 @@ SdrView* SfxViewShell::GetDrawView() const String SfxViewShell::GetSelectionText ( BOOL /*bCompleteWords*/ /* FALSE (default) - Nur der tats"achlich selektierte Text wird - zur"uckgegeben. + Only the actual selected text is returned. TRUE - Der selektierte Text wird soweit erweitert, - da\s nur ganze W"orter zur"uckgegeben werden. - Als Worttrenner gelten White-Spaces und die - Satzzeichen ".,;" sowie einfache und doppelte - Anf"uhrungszeichen. + The selected text is expanded so that only + whole words are returned. As word separators + these are used: white spaces and punctuation + ".,;" and single and double quotes. */ ) -/* [Beschreibung] +/* [Description] - Diese Methode kann von Anwendungsprogrammierer "uberladen werden, - um einen Text zur"uckzuliefern, der in der aktuellen Selektion - steht. Dieser wird z.B. beim Versenden (email) verwendet. + This Method can be overloaded by the programmers to return a text that + is included in the current selection. This is for example used when + sending emails. - Mit "CompleteWords == TRUE" ger"ufen, reicht z.B. auch der Cursor, - der in einer URL steht, um die gesamte URL zu liefern. + When called with "CompleteWords == TRUE", it is for example sufficent + with having the Cursor positioned somewhere within an URL in-order + to have the entire URL returned. */ { @@ -1441,11 +1433,11 @@ String SfxViewShell::GetSelectionText BOOL SfxViewShell::HasSelection( BOOL ) const -/* [Beschreibung] +/* [Description] - Mit dieser virtuellen Methode kann z.B. ein Dialog abfragen, ob in der - aktuellen View etwas selektiert ist. Wenn der Parameter <BOOL> TRUE ist, - wird abgefragt, ob Text selektiert ist. + With this virtual Method can a for example a Dialog be queried, to + check if something is selected in the current view. If the Parameter + is <BOOL> TRUE then it is checked wether some text is selected. */ { @@ -1456,26 +1448,25 @@ BOOL SfxViewShell::HasSelection( BOOL ) const void SfxViewShell::SetSubShell( SfxShell *pShell ) -/* [Beschreibung] +/* [Description] - Mit dieser Methode kann eine Selektions- oder Cursor-Shell angemeldet - werden, die automatisch unmittelbar nach der SfxViewShell auf den - SfxDispatcher gepusht wird, und automatisch umittelbar vor ihr - gepoppt wird. + With this method a selection or cursor Shell can be registered, which are + automatically pushed to SfxDispatcher immediately after SfxViewShell, and + and automatically popped immediately before SfxViewShell. - Ist die SfxViewShell-Instanz bereits gepusht, dann wird pShell - sofort ebenfalls gepusht. Wird mit SetSubShell eine andere SfxShell - Instanz angemeldet, als vorher angemeldet war, wird die zuvor angemeldete - ggf. automatisch gepoppt. Mit pShell==0 kann daher die aktuelle - Sub-Shell abgemeldet werden. + If the SfxViewShell instance is already pushed, then pShell will be + immediately pushed as well. Is another SfxShell instance registered by + using SetSubShell, which was previously registered, the previously + registered shell is popped automatically if possible. With pShell==0 + the current sub-shell be can thus be unregistered. */ { - // ist diese ViewShell "uberhaupt aktiv? + // Is this ViewShell even active? SfxDispatcher *pDisp = pFrame->GetDispatcher(); if ( pDisp->IsActive(*this) ) { - // Dispatcher updaten + // Update Dispatcher if ( pSubShell ) pDisp->Pop(*pSubShell); if ( pShell ) @@ -1709,25 +1700,24 @@ BOOL SfxViewShell::ExecKey_Impl(const KeyEvent& aKey) bool SfxViewShell::KeyInput( const KeyEvent &rKeyEvent ) -/* [Beschreibung] +/* [Description] - Diese Methode f"uhrt das KeyEvent 'rKeyEvent' "uber die an dieser - SfxViewShell direkt oder indirekt (z.B. via Applikation) konfigurierten - Tasten (Accelerator) aus. + This Method executes the KeyEvent 'rKeyEvent' of the Keys (Accelerator) + configured either direct or indirect (for example by the Application) + in the SfxViewShell. - - [R"uckgabewert] + [Return value] bool TRUE - die Taste ist konfiguriert, der betreffende - Handler wurde gerufen + The Key (Accelerator) is configured and the + the associated Handler was called FALSE - die Taste ist nicht konfiguriert, es konnte - also kein Handler gerufen werden + The Key (Accelerator) is not configured and + subsequently no Handler was called + [Cross-reference] - [Querverweise] <SfxApplication::KeyInput(const KeyEvent&)> */ { @@ -1743,11 +1733,11 @@ bool SfxViewShell::GlobalKeyInput_Impl( const KeyEvent &rKeyEvent ) void SfxViewShell::ShowCursor( bool /*bOn*/ ) -/* [Beschreibung] +/* [Description] - Diese Methode mu\s von Subklassen "uberladen werden, damit vom SFx - aus der Cursor ein- und ausgeschaltet werden kann. Dies geschieht - z.B. bei laufendem <SfxProgress>. + This Method has to be overloaded by the subclasses so that SFx from + the Cursor can be switched on and off. This happes for example with + with the running <SfxProgress>. */ { @@ -1757,17 +1747,16 @@ void SfxViewShell::ShowCursor( bool /*bOn*/ ) void SfxViewShell::GotFocus() const -/* [Beschreibung] - - Diese Methode mu\s vom Applikationsentwickler gerufen werden, wenn - das Edit-Window den Focus erhalten hat. Der SFx hat so z.B. die - M"oglichkeit, den Accelerator einzuschalten. +/* [Description] + This Method has to be called by the programmer, when the + Edit window has received the focus. This gives for example the SFx + the power to turn on the accelerator. - [Anmerkung] + [Note] - <StarView> liefert leider keine M"oglichkeit, solche Events - 'von der Seite' einzuh"angen. + <StarView> does sadly enough not provide the possibillity to attach + such "side-way" events. */ { @@ -1812,7 +1801,7 @@ void SfxViewShell::QueryObjAreaPixel( Rectangle& ) const void SfxViewShell::AdjustVisArea(const Rectangle& rRect) { - DBG_ASSERT (pFrame, "Kein Frame?"); + DBG_ASSERT (pFrame, "No Frame?"); GetObjectShell()->SetVisArea( rRect ); } @@ -1881,11 +1870,10 @@ BOOL SfxViewShell::PlugInsActive() const //-------------------------------------------------------------------- void SfxViewShell::DiscardClients_Impl() -/* [Beschreibung] +/* [Description] - Diese Methode dient dazu, vor dem Schlie\sen eines Dokuments das - Speichern der Objekte zu verhindern, wenn der Benutzer Schlie\en ohne - Speichern gew"ahlt hatte. + The purpose of this Method is to prevent the saving of Objects when closing + the Document, if the user has chosen to close without saving. */ { @@ -1951,7 +1939,7 @@ const Size& SfxViewShell::GetMargin() const void SfxViewShell::SetMargin( const Size& rSize ) { - // Der default-Margin wurde "geeicht" mit www.apple.com !! + // the default margin was verified using www.apple.com !! Size aMargin = rSize; if ( aMargin.Width() == -1 ) aMargin.Width() = DEFAULT_MARGIN_WIDTH; |