Bugzilla – Attachment 42396 Details for
Bug 33424
[PATCH] Translation of German comments in sfx2/
Home
|
New
|
Browse
|
Search
|
[?]
|
Reports
|
Help
|
New Account
|
Log In
[x]
|
Forgot Password
Login:
[x]
[patch]
part 1
sfx2-german-comments-part1.diff (text/plain), 482.48 KB, created by
Albert Thuswaldner
on 2011-01-24 12:33:47 UTC
(
hide
)
Description:
part 1
Filename:
MIME Type:
Creator:
Albert Thuswaldner
Created:
2011-01-24 12:33:47 UTC
Size:
482.48 KB
patch
obsolete
>diff --git a/sfx2/inc/QuerySaveDocument.hxx b/sfx2/inc/QuerySaveDocument.hxx >index bc4dbfc..6452e57 100644 >--- a/sfx2/inc/QuerySaveDocument.hxx >+++ b/sfx2/inc/QuerySaveDocument.hxx >@@ -33,7 +33,7 @@ > > class Window; > class String; >-/** opens the generell query save document dialog. >+/** Opens the general query save document dialog. > @param _pParent > The parent window. > @_rTitle >diff --git a/sfx2/inc/bitset.hxx b/sfx2/inc/bitset.hxx >index ecf64eb..ceafd6e 100644 >--- a/sfx2/inc/bitset.hxx >+++ b/sfx2/inc/bitset.hxx >@@ -197,7 +197,7 @@ inline BOOL BitSet::IsRealSubSet( const BitSet& ) const > } > //-------------------------------------------------------------------- > >-// detsermines if the other bitset is a superset or equal >+// determines if the other bitset is a superset or equal > > inline BOOL BitSet::IsSubSet( const BitSet& ) const > { >diff --git a/sfx2/inc/macro.hxx b/sfx2/inc/macro.hxx >index 2e92ae7..25196a2 100644 >--- a/sfx2/inc/macro.hxx >+++ b/sfx2/inc/macro.hxx >@@ -17,11 +17,11 @@ class SfxMacro; > > class SfxMacroStatement > { >- USHORT nSlotId; // ausgef"uhrte Slot-Id oder 0, wenn manuell >- ::com::sun::star::uno::Sequence < ::com::sun::star::beans::PropertyValue > aArgs; // aktuelle Parameter, falls nSlotId != 0 >+ USHORT nSlotId; // performed Slot-Id or 0, if manually >+ ::com::sun::star::uno::Sequence < ::com::sun::star::beans::PropertyValue > aArgs; // current Parameter, in case nSlotId != 0 > String aStatement; // Statement in BASIC-Syntax (ggf. mit CR/LF) >- BOOL bDone; // auskommentieren wenn kein Done() gerufen >- void* pDummy; // f"ur alle F"alle zum kompatibel bleiben >+ BOOL bDone; // comment out if no Done () is called >+ void* pDummy; // for all cases to remain compatible > > #ifdef _SFXMACRO_HXX > private: >@@ -59,11 +59,10 @@ public: > > inline USHORT SfxMacroStatement::GetSlotId() const > >-/* [Beschreibung] >+/* [Description] > >- Liefert die Slot-Id die das Statement beim Abspielen wieder ausf"uhren >- soll oder 0, falls das Statement manuell (<SFX_SLOT_RECORDMANUAL>) >- aufgezeichnet wurde. >+ Returns the Slot-Id which the Statement should redo when called or 0 >+ if the Statement (<SFX_SLOT_RECORDMANUAL>) was recorded manually. > */ > > { >@@ -74,14 +73,13 @@ inline USHORT SfxMacroStatement::GetSlotId() const > > inline const ::com::sun::star::uno::Sequence < ::com::sun::star::beans::PropertyValue >& SfxMacroStatement::GetArgs() const > >-/* [Beschreibung] >+/* [Description] > >- Liefert die Parameter mit denen Statement ausgef"uhrt wurde oder 0, >- falls das Statement manuell (<SFX_SLOT_RECORDMANUAL>) aufgezeichnet >- wurde. >+ Returns the Parameter which was used in the call of the Statement or 0 >+ if the Statement (<SFX_SLOT_RECORDMANUAL>) was recorded manually > >- Der R"uckgabewert geh"ort dem SfxMacroStatement und ist nur im >- unmittelbar aufrufenden Stackframe g"ultig. >+ The returned value belongs to the SfxMacroStatement and is only valid >+ to the Stackframe. > */ > > { >@@ -92,11 +90,11 @@ inline const ::com::sun::star::uno::Sequence < ::com::sun::star::beans::Property > > inline BOOL SfxMacroStatement::IsDone() const > >-/* [Beschreibung] >+/* [Description] > >- Liefert TRUE, wenn das Statement wirklich ausgef"uhrt wurde, >- also z.B. nicht vom Benutzer abgebrochen wurde. Wurde es nicht >- wirklich ausgef"uhrt, dann wird es im BASIC-Source auskommentiert. >+ Returns TRUE only if the Statement really was excecuted, so for instance >+ not if it was canceled by the user. If it was not excecuted the >+ BASIC-Source would be commented out. > */ > > { >@@ -105,18 +103,18 @@ inline BOOL SfxMacroStatement::IsDone() const > > //-------------------------------------------------------------------- > >-/* [Beschreibung] >+/* [Description] > >- Liefert das Statement in BASIC-Syntax. Wurde das Makro manuell erzeugt, >- wird genau der im Konstruktor angegebene String zur"uckgegeben, sonst >- der generierte Source-Code. >+ Returns the Statement in BASIC-Syntax. If the Macro was created manually, >+ the string will be returned exactly as given in the constructor, else the >+ generated Source-Code is returned. > >- Bei beiden Arten ist es m"oglich, da\s mehrere BASIC-Statements, jeweils >- mit CR/LF getrennt in dem String enthalten sind, da ein SFx-Statement >- ggf. in mehrere BASIC-Statements "ubersetzt wird. >+ It is possible in both of the above cases that several BASIC-Statements, >+ each contains CR / LF separators in the string, since a SFx statement >+ is translated if necessary into several BASIC statements. > >- Statements f"ur die nicht <SfxRequest::Done()> gerufen wurde, werden >- mit einem vorangestellten 'rem' gekennzeichnet. >+ Statements for which <SfxRequest::Done()> was not called are marked >+ with a preceding 'rem'. > */ > > inline const String& SfxMacroStatement::GetStatement() const >@@ -128,41 +126,38 @@ inline const String& SfxMacroStatement::GetStatement() const > > enum SfxMacroMode > >-/* [Beschreibung] >+/* [Description] > >- Mit diesem enum wird bestimmt, ob eine <SfxMacro>-Instanz zum >- absoluten oder relativen Recorden erzeugt wurde, oder um ein >- existierendendes Makro zu Referenzieren. >+ By using this enum it is determined, if a <SfxMacro>-Instance was created >+ by absolute or relative recording, or to create a reference to a existing >+ macro. > */ > > { >- SFX_MACRO_EXISTING, /* es handelt sich um ein bereits >- exitistierendes Makro, welches lediglich >- referenziert wird */ >- >- SFX_MACRO_RECORDINGABSOLUTE,/* dieses Makro soll aufgezeichnet werden, >- wobei die betroffenen Objekte m"oglichst >- direkt angesprochen werden sollen >- (Beispiel: "[doc.sdc]") */ >- >- SFX_MACRO_RECORDINGRELATIVE/* dieses Makro soll aufgezeichnet werden, >- wobei die betroffenen Objekte so >- angesprochen werden sollen, da\s sich das >- Abspielen auf die dann g"ultige Selektion >- bezieht (Beispiel: "ActiveDocument()") */ >+ SFX_MACRO_EXISTING, /* Indicates that it is a existing >+ macro, which will only referenced */ >+ >+ SFX_MACRO_RECORDINGABSOLUTE, /* This macro shall be recorded so that the >+ affected objects are to be addressed as >+ directly as possible (example: "[doc.sdc]") */ >+ >+ SFX_MACRO_RECORDINGRELATIVE /* This macro is recorded and the affected >+ objects are addressed in such a way so >+ that when running the macro it refers to >+ a vaild selection >+ (example:" active document () ") */ > }; > > //==================================================================== > > class SfxMacro > >-/* [Beschreibung] >+/* [Description] > >- "Uber diese Klasse (bzw. genaugenommen ihre Subklassen) wird zum >- einen die Lokation einer BASIC-Funktion (also in welcher Library, >- in welchem Modul sowie der Funktions-Name) beschrieben, als auch >- ein aufzuzeichnendes Makro w"ahrend der Aufzeichnung zwischen- >- gespeichert. >+ Through using this class (and in fact its subclasses) the location of a >+ BASIC function will be discribed (also in which Library, in which module >+ and the Function name) as well as temporary storing a macro during the >+ recording. > */ > > { >diff --git a/sfx2/inc/sfx2/app.hxx b/sfx2/inc/sfx2/app.hxx >index b6cfd0e..6f3f4de 100644 >--- a/sfx2/inc/sfx2/app.hxx >+++ b/sfx2/inc/sfx2/app.hxx >@@ -123,7 +123,7 @@ public: > }; > > //TODO/CLEANUP >-//wird anscheinend nur in SfxPickList/SfxFrameLoader benutzt >+//is apparently used only in SfxPickList/SfxFrameLoader > DECL_OBJHINT( SfxStringHint, String ); > > /* >diff --git a/sfx2/inc/sfx2/bindings.hxx b/sfx2/inc/sfx2/bindings.hxx >index 8a60557..917e89b 100644 >--- a/sfx2/inc/sfx2/bindings.hxx >+++ b/sfx2/inc/sfx2/bindings.hxx >@@ -70,12 +70,12 @@ SV_DECL_PTRARR( SfxUnoControllerArr_Impl, SfxUnoControllerItemPtr, 20, 20 ) > // defines > //________________________________________________________________________________________________________________ > >-#define SFX_CALLMODE_SLOT 0x00 // sync/async vom Slot >-#define SFX_CALLMODE_SYNCHRON 0x01 // synchron im selben Stackframe >-#define SFX_CALLMODE_ASYNCHRON 0x02 // asynchron per AppEvent >-#define SFX_CALLMODE_RECORD 0x04 // beim Recorden ber"ucksichtigen >-#define SFX_CALLMODE_API 0x08 // Call von der API (silent) >-#define SFX_CALLMODE_MODAL 0x10 // trotz ModalMode >+#define SFX_CALLMODE_SLOT 0x00 // sync/async from Slot >+#define SFX_CALLMODE_SYNCHRON 0x01 // synchronously in the same Stackframe >+#define SFX_CALLMODE_ASYNCHRON 0x02 // asynchronously via AppEvent >+#define SFX_CALLMODE_RECORD 0x04 // take into accont while recording >+#define SFX_CALLMODE_API 0x08 // API call (silent) >+#define SFX_CALLMODE_MODAL 0x10 // despite ModalMode > > #define SFX_CALLMODE_STANDARD SFX_CALLMODE_RECORD > typedef sal_uInt16 SfxCallMode; >@@ -90,23 +90,22 @@ enum SfxPopupAction > //==================================================================== > class SFX2_DLLPUBLIC SfxBindings: public SfxBroadcaster > >-/* [Beschreibung] >- >- In jeder SFx-Applikation existiert "uber die Laufzeit von vor >- <SfxApplication::Init()> bis nach <SfxApplication::Exit()> eine Instanz >- der Klasse SfxBindings. Sie wird von der SfxApplication automatisch >- angelegt und zerst"ort. Instanzen werden aber i.d.R. "uber das >- Makro <SFX_BINDINGS> oder den zugeh"origen <SfxViewFrame> besorgt >- werden. >- >- Die SfxBindings verwalten alle in den an ihr angemeldeten Controllern >- gebundenen Slot-Ids und cachen die jeweiligen <Slot-Server> >- (so nenne wir die Kombination aus SfxShell-Instanz und SfxSlot). >- In den SfxBindings ist gespeichert, ob und welche Controller dirty >- sind sowie welche Slot-Server-Caches jeweils dirty sind. Sie fa"st >- Status-Anfragen (Aufrufe der in der IDL genannten Status-Methoden) >- zusammen, die von derselben Status-Methode bedient werden, und sorgt >- f"ur die Simulation der <Pseudo-Slots>. >+/* [Description] >+ >+ In each SFx application one instance of the SfxBindings-Class will >+ exists from <SfxApplication::Init()> until <SfxApplication::Exit()>. >+ This instance is automatically created and destroyed by SfxApplication. >+ However these instances will be handled by the Macro <SFX_BINDINGS> >+ or the associated <SfxViewFrame>. >+ >+ The SfxBindings manages all of its Slot-Ids bound by the registerd >+ controllers and keeps a cache of the <Slot-Server> respectively. >+ (it is what we call the combination of SfxShell instance and SfxSlot). >+ In the SfxBindings it is stored, if and in this case which controllers >+ that are dirty and which Slot-Server-Caches are dirty respectively. >+ It summarizes status queries (calls to the status methods specified >+ in the IDL) that are served by the same state methods, and handles >+ the simulation of <Pseudo-Slots>. > */ > > { >@@ -114,15 +113,15 @@ friend class SfxApplication; > friend class SfxShell; > friend class SfxBindings_Impl; > >- SfxBindings_Impl*pImp; // Daten der Bindings-Instanz >- SfxDispatcher* pDispatcher; // zu verwendender Dispatcher >- sal_uInt16 nRegLevel; // Lock-Level waehrend Reconfig >+ SfxBindings_Impl*pImp; // Data of the Bindings instance >+ SfxDispatcher* pDispatcher; // Dispatcher, to be used >+ sal_uInt16 nRegLevel; // Lock-Level while Reconfig > > private: > SAL_DLLPRIVATE const SfxPoolItem* Execute_Impl( sal_uInt16 nSlot, const SfxPoolItem **pArgs, sal_uInt16 nModi, > SfxCallMode nCall, const SfxPoolItem **pInternalArgs, BOOL bGlobalOnly=FALSE); > SAL_DLLPRIVATE void SetSubBindings_Impl( SfxBindings* ); >- SAL_DLLPRIVATE void UpdateSlotServer_Impl(); // SlotServer aktualisieren >+ SAL_DLLPRIVATE void UpdateSlotServer_Impl(); // Update SlotServer > SAL_DLLPRIVATE SfxItemSet* CreateSet_Impl( SfxStateCache* &pCache, > const SfxSlot* &pRealSlot, > const SfxSlotServer**, >@@ -145,7 +144,7 @@ public: > > void SetDispatcher(SfxDispatcher *pDisp); > >- void Update( sal_uInt16 nId ); // z.B. aus Menu::Activate >+ void Update( sal_uInt16 nId ); // For example, from Menu::Activate > void Update(); > SAL_DLLPRIVATE void StartUpdate_Impl(sal_Bool bComplete=sal_False); > void Invalidate( sal_uInt16 nId ); >@@ -232,21 +231,21 @@ public: > > inline int SfxBindings::IsInRegistrations() const > >-/* [Beschreibung] >+/* [Description] > >- Stellt fest, ob an der SfxBindings Instanz gerade <SfxContollerItems> >- an- oder abgemeldet werden, also noch <SfxBindings::EnterRegistrations()> >- Aufrufe nicht mit <SfxBindings::EnterRegistrations()> geschlo"sen wurden. >+ Determines whether the <SfxContollerItems> SfxBindings instance is >+ registerd or unregisted, i.e. <SfxBindings::EnterRegistrations()> >+ calls that have not been closed by <SfxBindings::LeaveRegistrations()>. > >- [R"uckgabewert] >+ [Return value] > > int sal_True >- Die SfxBindings Instanz ist gerade im Registrierungs- >- Modus. Es erfolgen also keine Status-Updates. >+ The SfxBindings instance is currently in >+ Registration-Mode. No status updates . > >- sal_False >- Die SfxBindings Instanz ist gerade im normalen >- Modus. Es k"oennen also Status-Updates erfolgen. >+ int sal_False >+ The SfxBindings instance is the normal mode. >+ Status updates can be done. > */ > > { >diff --git a/sfx2/inc/sfx2/chalign.hxx b/sfx2/inc/sfx2/chalign.hxx >index 279a192..73bfccf 100644 >--- a/sfx2/inc/sfx2/chalign.hxx >+++ b/sfx2/inc/sfx2/chalign.hxx >@@ -30,32 +30,32 @@ > > #include <tools/solar.h> > >-// Neue Reihenfolge: zuerst Navigationsleiste, dann senkrecht angedockte >-// ChildWindows (Explorer!), dann horizontal angedockte ChildWindows (Browser!), >-// dann die Formatleiste, die Statuszeile, am Ende die Werkzeugleiste. >+// New order: first, navigation bar, then vertically docked child windows >+// (Explorer!), then horizontally docked child windows (Browser!), >+// then the format bar, status bar, and at the end of the toolbar. > > enum SfxChildAlignment > { >- SFX_ALIGN_HIGHESTTOP, // z.B. Navigationsleiste >+ SFX_ALIGN_HIGHESTTOP, // for example Navigation bar > SFX_ALIGN_LOWESTBOTTOM, > SFX_ALIGN_FIRSTLEFT, > SFX_ALIGN_LASTRIGHT, >- SFX_ALIGN_LEFT, // z.B. SplitWindow >+ SFX_ALIGN_LEFT, // for example SplitWindow > SFX_ALIGN_RIGHT, > SFX_ALIGN_LASTLEFT, > SFX_ALIGN_FIRSTRIGHT, >- SFX_ALIGN_TOP, // z.B. Hyperlink-Builder, SplitWindow >- SFX_ALIGN_BOTTOM, // z.B. SplitWindow >- SFX_ALIGN_TOOLBOXTOP, // z.B. Objektleiste >+ SFX_ALIGN_TOP, // for example Hyperlink-Builder, SplitWindow >+ SFX_ALIGN_BOTTOM, // for example SplitWindow >+ SFX_ALIGN_TOOLBOXTOP, // for example Objekt bar > SFX_ALIGN_TOOLBOXBOTTOM, >- SFX_ALIGN_LOWESTTOP, // z.B. Calc-Rechenleiste >- SFX_ALIGN_HIGHESTBOTTOM, // z.B. Statusleiste >- SFX_ALIGN_TOOLBOXLEFT, // z.B. Werkzeugleiste >+ SFX_ALIGN_LOWESTTOP, // for example Calc bar >+ SFX_ALIGN_HIGHESTBOTTOM, // for example Status bar >+ SFX_ALIGN_TOOLBOXLEFT, // for example Tool bar > SFX_ALIGN_TOOLBOXRIGHT, >- SFX_ALIGN_NOALIGNMENT // alle FloatingWindows >+ SFX_ALIGN_NOALIGNMENT // all FloatingWindows > }; > >-// "Uberpr"uft, ob ein g"ultiges Alignment verwendet wird >+// Verifies that a valid alignment is used > inline BOOL SfxChildAlignValid( SfxChildAlignment eAlign ) > { > return ( eAlign >= SFX_ALIGN_HIGHESTTOP && eAlign <= SFX_ALIGN_NOALIGNMENT ); >diff --git a/sfx2/inc/sfx2/childwin.hxx b/sfx2/inc/sfx2/childwin.hxx >index 5de9fba..3456c06 100644 >--- a/sfx2/inc/sfx2/childwin.hxx >+++ b/sfx2/inc/sfx2/childwin.hxx >@@ -53,17 +53,18 @@ class SfxChildWinContextArr_Impl; > //ASDBG USR_DECLIMPL_REF( ::com::sun::star::frame::XFrame, ::com::sun::star::uno::XInterface ); > //ASDBG #endif > >-#define SFX_CHILDWIN_ZOOMIN 0x01 // ganz eingeklapptes Float >-#define SFX_CHILDWIN_SMALL 0x02 // halb eingeklapptes Float >-#define SFX_CHILDWIN_FORCEDOCK 0x04 // Float verboten >-#define SFX_CHILDWIN_AUTOHIDE 0x08 // DockingWindow im AutoHide-Modus >-#define SFX_CHILDWIN_TASK 0x10 // ChildWindow innerhalb der Task >-#define SFX_CHILDWIN_CANTGETFOCUS 0x20 // ChildWindow kann keinen Focus bekommen >+#define SFX_CHILDWIN_ZOOMIN 0x01 // Fully retracted Float >+#define SFX_CHILDWIN_SMALL 0x02 // Half retracted Float >+#define SFX_CHILDWIN_FORCEDOCK 0x04 // Float forbidden >+#define SFX_CHILDWIN_AUTOHIDE 0x08 // DockingWindow in AutoHide mode >+#define SFX_CHILDWIN_TASK 0x10 // ChildWindow inside the Task >+#define SFX_CHILDWIN_CANTGETFOCUS 0x20 // ChildWindow can not get focus > #define SFX_CHILDWIN_ALWAYSAVAILABLE 0x40 // ChildWindow is never disabled >-#define SFX_CHILDWIN_NEVERHIDE 0x80 // ChildWindow is can always made visible/is visible >+#define SFX_CHILDWIN_NEVERHIDE 0x80 // ChildWindow is can always made >+ // visible/is visible > #define CHILDWIN_NOPOS USHRT_MAX > >-// Konfiguration eines ChildWindows >+// ChildWindow Configuration > struct SfxChildWinInfo > { > sal_Bool bVisible; >@@ -85,21 +86,21 @@ struct SfxChildWinInfo > sal_uInt16 *pPos = 0 ) const; > }; > >-// Factory-Methode eines ChildWindows >+// ChildWindow factory methods > typedef SfxChildWindow* (*SfxChildWinCtor)( ::Window *pParentWindow, > sal_uInt16 nId, > SfxBindings *pBindings, > SfxChildWinInfo *pInfo); > >-// Factory-Methode eines ChildWindowsContexts >+// ChildWindowsContexts factory methods > typedef SfxChildWindowContext* (*SfxChildWinContextCtor)( ::Window *pParentWindow, > SfxBindings *pBindings, > SfxChildWinInfo *pInfo); > struct SfxChildWinContextFactory > { >- SfxChildWinContextCtor pCtor; // Factory-Methode >- sal_uInt16 nContextId; // Identifier f"ur das SfxInterface >- SfxChildWinInfo aInfo; // Konfiguration >+ SfxChildWinContextCtor pCtor; // Factory method >+ sal_uInt16 nContextId; // Idenifier for SfxInterface >+ SfxChildWinInfo aInfo; // Configuration > > SfxChildWinContextFactory( SfxChildWinContextCtor pTheCtor, sal_uInt16 nID ) > : pCtor(pTheCtor) >@@ -111,11 +112,11 @@ SV_DECL_PTRARR_DEL( SfxChildWinContextArr_Impl, SfxChildWinContextFactory*, 2, 2 > > struct SfxChildWinFactory > { >- SfxChildWinCtor pCtor; // Factory-Methode >+ SfxChildWinCtor pCtor; // Factory method > sal_uInt16 nId; // ChildWindow-Id ( SlotId ) >- SfxChildWinInfo aInfo; // Konfiguration >- sal_uInt16 nPos; // ggf. Position im UI >- SfxChildWinContextArr_Impl *pArr; // Array f"ur Contexte >+ SfxChildWinInfo aInfo; // Configuration >+ sal_uInt16 nPos; // Position in UI >+ SfxChildWinContextArr_Impl *pArr; // Array for Contexts > > SfxChildWinFactory( SfxChildWinCtor pTheCtor, sal_uInt16 nID, > sal_uInt16 n ) >@@ -167,13 +168,13 @@ class SFX2_DLLPUBLIC SfxChildWindow > sal_uInt16 nType; // ChildWindow-Id > > protected: >- SfxChildAlignment eChildAlignment;// aktuelles ::com::sun::star::drawing::Alignment >- ::Window* pWindow; // eigentlicher Inhalt >- SfxChildWindow_Impl* pImp; // Imp-Daten >+ SfxChildAlignment eChildAlignment; // Current ::com::sun::star::drawing::Alignment >+ ::Window* pWindow; // actual contents >+ SfxChildWindow_Impl* pImp; // Implementation data > > private: >- SfxChildWindowContext* pContext; // bei kontextsensitiven ChildWindows: >- // weiteres window in pWindow >+ SfxChildWindowContext* pContext; // With context-sensitive ChildWindows: >+ // Annother window in pWindow > SAL_DLLPRIVATE SfxChildWindowContext* > GetContext() const > { return pContext; } >@@ -248,19 +249,19 @@ public: > }; > > //------------------------------------------------------------------ >-//! demn"achst hinf"allig ! >+//! soon obsolete ! > #define SFX_DECL_CHILDWINDOW_CONTEXT(Class) \ > static SfxChildWindowContext* CreateImpl(::Window *pParent, \ > SfxBindings *pBindings, SfxChildWinInfo* pInfo ); \ > static void RegisterChildWindowContext(SfxModule *pMod=0); \ > >-//! Das Macro der Zukunft ... >+//! The Macro of the future ... > #define SFX_DECL_CHILDWINDOWCONTEXT(Class) \ > static SfxChildWindowContext* CreateImpl(::Window *pParent, \ > SfxBindings *pBindings, SfxChildWinInfo* pInfo ); \ > static void RegisterChildWindowContext(sal_uInt16, SfxModule *pMod=0); \ > >-//! demn"achst hinf"allig ! >+//! soon obsolete ! > #define SFX_IMPL_CHILDWINDOW_CONTEXT(Class, MyID, ShellClass) \ > SfxChildWindowContext* Class::CreateImpl( ::Window *pParent, \ > SfxBindings *pBindings, SfxChildWinInfo* pInfo ) \ >@@ -278,9 +279,10 @@ public: > SfxChildWindowContext::RegisterChildWindowContext(pMod, MyID, pFact); \ > } > >-//! Das Macro der Zukunft ... >-// CreateImpl mu\s noch als Parameter die Factory mitbekommen wg. ContextId >-// Solange wird diese Id auf 0 gesetzt und in SfxChildWindow::CreateContext gepatched >+//! The Macro of the future ... >+// As a parameter and because of ContextId, CreateImpl must be handed the >+// factory. As long as Id is set to 0 and patched in >+// SfxChildWindow::CreateContext > #define SFX_IMPL_CHILDWINDOWCONTEXT(Class, MyID) \ > SfxChildWindowContext* Class::CreateImpl( ::Window *pParent, \ > SfxBindings *pBindings, SfxChildWinInfo* pInfo ) \ >diff --git a/sfx2/inc/sfx2/cntids.hrc b/sfx2/inc/sfx2/cntids.hrc >index 80e0265..5308a47 100644 >--- a/sfx2/inc/sfx2/cntids.hrc >+++ b/sfx2/inc/sfx2/cntids.hrc >@@ -39,9 +39,9 @@ > // Slot-ID's ----------------------------------------------------------------- > > #ifndef SID_SFX_START >-// HACK() - SID's duerfen nicht o.w. ihren numerischen Wert aendern, >-// sfxsids.hrc darf aber nicht included werden!!! Loesung: sfxsids.hrc >-// "tiefer legen" - z.B. svtools??? >+// HACK() - SID's may not change its numerical value just like that, >+// sfxsids.hrc may not be included!!! Solution: sfxsids.hrc >+// include it on a lower level - for example svtools??? > #define SID_SFX_START 5000 > #endif > #define SID_TITLE (SID_SFX_START + 307) >@@ -349,24 +349,24 @@ > > // Tabpage-Ids --------------------------------------------------------------- > >-#define CNT_TABPAGE_GENERAL 1 // "Allgemein" >-#define CNT_TABPAGE_SERVER_SETTINGS 2 // "Server" >-#define CNT_TABPAGE_RULES 3 // "Regeln" >-#define CNT_TABPAGE_VIEW_PROPERTIES 4 // "Ansicht" >-#define CNT_TABPAGE_CONTENT_PROPERTIES 5 // "Inhalte" >-#define CNT_TABPAGE_SUBSCRIBE 6 // "Abonniert" >-#define CNT_TABPAGE_RECIPIENT_STATE 7 // "Status" (Outtray-Msgs) >-#define CNT_TABPAGE_RECV_POP3 8 // "Empfangen" fuer POP3 >-#define CNT_TABPAGE_RECV_NNTP 9 // - " - fuer NNTP-Accounts >-#define CNT_TABPAGE_RECV_IMAP 10 // - " - fuer IMAP-Accounts >-#define CNT_TABPAGE_RECV_VIM 11 // - " - fuer VIM-Accounts >-#define CNT_TABPAGE_SEND_SMTP 12 // "SMTP" >-#define CNT_TABPAGE_SEND_NNTP 13 // "NNTP" >-#define CNT_TABPAGE_SEND_VIM 14 // "VIM" >-#define CNT_TABPAGE_MAIL_NEWS_SEND 15 // "Versenden" >+#define CNT_TABPAGE_GENERAL 1 >+#define CNT_TABPAGE_SERVER_SETTINGS 2 >+#define CNT_TABPAGE_RULES 3 >+#define CNT_TABPAGE_VIEW_PROPERTIES 4 >+#define CNT_TABPAGE_CONTENT_PROPERTIES 5 >+#define CNT_TABPAGE_SUBSCRIBE 6 >+#define CNT_TABPAGE_RECIPIENT_STATE 7 >+#define CNT_TABPAGE_RECV_POP3 8 >+#define CNT_TABPAGE_RECV_NNTP 9 >+#define CNT_TABPAGE_RECV_IMAP 10 >+#define CNT_TABPAGE_RECV_VIM 11 >+#define CNT_TABPAGE_SEND_SMTP 12 >+#define CNT_TABPAGE_SEND_NNTP 13 >+#define CNT_TABPAGE_SEND_VIM 14 >+#define CNT_TABPAGE_MAIL_NEWS_SEND 15 > #define CNT_TABPAGE_SEARCH_CRITERIA 16 > #define CNT_TABPAGE_SEARCH_LOCATIONS 17 >-#define CNT_TABPAGE_PROJECT_DATAEXCHANGE 18 // "Datenaustausch" >+#define CNT_TABPAGE_PROJECT_DATAEXCHANGE 18 > #define CNT_TABPAGE_SBOX_LOCATION 19 > #define CNT_TABPAGE_SBOX_SUBSCRIBTION 20 > #define CNT_TABPAGE_SBOX_SCHEDULE 21 >@@ -377,12 +377,12 @@ > #define CNT_TABPAGE_SBOX_SDC_GENERAL 26 > #define CNT_TABPAGE_SBOX_CDF_SUBSCRIBTION 27 > #define CNT_TABPAGE_BACKGROUND 28 >-#define CNT_TABPAGE_HEADER 29 // "Kopfzeilen" - Header bei Mail/News etc. >-#define CNT_TABPAGE_DESCRIPTION 30 // "Beschreibung" - Header im Filesys >+#define CNT_TABPAGE_HEADER 29 >+#define CNT_TABPAGE_DESCRIPTION 30 > #define CNT_TABPAGE_FONT 31 >-#define CNT_TABPAGE_FOLDER_BMK 32 // Link auf Ordner >-#define CNT_TABPAGE_DOCUMENT_BMK 33 // Link auf Dokument >-#define CNT_TABPAGE_WEBVIEW 34 // Web-Ansicht >+#define CNT_TABPAGE_FOLDER_BMK 32 >+#define CNT_TABPAGE_DOCUMENT_BMK 33 >+#define CNT_TABPAGE_WEBVIEW 34 > > > #define DEF_WIDTH_FROM 150 >diff --git a/sfx2/inc/sfx2/ctrlitem.hxx b/sfx2/inc/sfx2/ctrlitem.hxx >index 8b29399..7ab0b2d 100644 >--- a/sfx2/inc/sfx2/ctrlitem.hxx >+++ b/sfx2/inc/sfx2/ctrlitem.hxx >@@ -41,7 +41,7 @@ class SFX2_DLLPUBLIC SfxControllerItem > { > private: > USHORT nId; >- SfxControllerItem* pNext; // zu benachrichtigendes weiteres ControllerItem >+ SfxControllerItem* pNext; // to notify next ControllerItem > SfxBindings* pBindings; > > protected: >@@ -52,19 +52,19 @@ protected: > > public: > SfxBindings & GetBindings() { >- DBG_ASSERT(pBindings, "keine Bindings"); >+ DBG_ASSERT(pBindings, "no Bindings"); > return *pBindings; > } > const SfxBindings & GetBindings() const { >- DBG_ASSERT(pBindings, "keine Bindings"); >+ DBG_ASSERT(pBindings, "no Bindings"); > return *pBindings; > } > >- SfxControllerItem(); // fuer arrays >+ SfxControllerItem(); // for arrays > SfxControllerItem( USHORT nId, SfxBindings & ); > virtual ~SfxControllerItem(); > >- void Bind( USHORT nNewId, SfxBindings * = 0); // in SfxBindings registrieren >+ void Bind( USHORT nNewId, SfxBindings * = 0); // Register in SfxBindings > void UnBind(); > void ReBind(); > BOOL IsBound() const; >diff --git a/sfx2/inc/sfx2/dispatch.hxx b/sfx2/inc/sfx2/dispatch.hxx >index 1578bf7..27a462f 100644 >--- a/sfx2/inc/sfx2/dispatch.hxx >+++ b/sfx2/inc/sfx2/dispatch.hxx >@@ -111,7 +111,7 @@ class SFX2_DLLPUBLIC SfxDispatcher > BOOL bFlushed; > > private: >- // auf temporaer ausgewerteten Todos suchen >+ // Search for temporary evaluated Todos > SAL_DLLPRIVATE BOOL CheckVirtualStack( const SfxShell& rShell, BOOL bDeep ); > > #ifndef _SFX_HXX >@@ -131,8 +131,8 @@ friend class SfxBindings; > friend class SfxStateCache; > friend class SfxPopupMenuManager; > friend class SfxHelp; >- // Fuer die Bindings: Finden einer Message; Level fuer >- // erneuten Zugriff >+ // For bindings: Finding the Message; >+ // level for re-access > SAL_DLLPRIVATE BOOL _TryIntercept_Impl( USHORT nId, SfxSlotServer &rServer, BOOL bModal ); > BOOL _FindServer( USHORT nId, SfxSlotServer &rServer, BOOL bModal ); > BOOL _FillState( const SfxSlotServer &rServer, >@@ -264,11 +264,10 @@ public: > > inline BOOL SfxDispatcher::IsFlushed() const > >-/* [Beschreibung] >+/* [Description] > >- Mit dieser Methode l"a"st sich erfragen, ob der Stack des >- SfxDispatchers geflusht ist, oder noch Push- oder Pop-Befehle >- ausstehen. >+ This method checks if the stack of the SfxDispatchers is flushed, or if >+ push- or pop- commands are pending. > */ > > { >@@ -279,13 +278,12 @@ inline BOOL SfxDispatcher::IsFlushed() const > > inline void SfxDispatcher::Flush() > >-/* [Beschreibung] >+/* [Description] > >- Diese Methode f"uhrt ausstehenden Push- und Pop-Befehle aus. >- F"ur <SfxShell>s, die dabei neu auf den Stack kommen, wird >- <SfxShell::Activate(BOOL)> mit bMDI == TRUE aufgerufen, f"ur >- SfxShells, die vom Stack entfernt werden, wird <SfxShell::Deactivate(BOOL)> >- mit bMDI == TRUE aufgerufen. >+ This method performs outstanding push- and pop- commands. For <SfxShell>s, >+ which are new on the stack, the <SfxShell::Activate(BOOL)> is invoked with >+ bMDI == TRUE, for SfxShells that are removed from the stack, the >+ <SfxShell::Deactivate(BOOL)> is invoked with bMDI == TRUE > */ > > { >@@ -296,14 +294,15 @@ inline void SfxDispatcher::Flush() > > inline void SfxDispatcher::Push( SfxShell& rShell ) > >-/* [Beschreibung] >+/* [Description] > >- Mit dieser Methode wird eine <SfxShell> auf den SfxDispatcher >- gepusht. Die SfxShell wird zun"achst zum pushen vermerkt und >- es wird ein Timer aufgesetzt. Erst bei Ablauf des Timers wird >- tats"achlich gepusht (<SfxDispatcher::Flush()>) und die <SfxBindings> >- werden invalidiert. W"ahrend der Timer l"auft gleichen sich >- entgegengesetzte Push und Pop Befehle mit derselben SfxShell aus. >+ With this method, a <SfxShell> pushed on to the SfxDispatcher. >+ The SfxShell is first marked for push and a timer is set up. >+ First when the timer has couted down to zero the push >+ ( <SfxDispatcher::Flush()> ) is actually performed and the >+ <SfxBindings> is invalidated. While the timer is counting down >+ the opposing push and pop commands on the same SfxShell are >+ leveled out. > */ > > { >@@ -314,21 +313,18 @@ inline void SfxDispatcher::Push( SfxShell& rShell ) > > inline BOOL SfxDispatcher::IsActive( const SfxShell& rShell ) > >-/* [Beschreibung] >+/* [Description] > >- Mit dieser Methode kann abgefragt werden, ob sich eine bestimmte >- <SfxShell>-Instanz auf dem SfxDispatcher befindet. >+ This method checks whether a particular <SfxShell> instance is >+ on the SfxDispatcher. > >- [R"uckgabewert] >+ [Return value] > > BOOL TRUE >- Die SfxShell-Instanz befindet sich auf dem >- SfxDispatcher. >+ The SfxShell instance is on the SfxDispatcher. > > FALSE >- Die SfxShell-Instanz befindet sich nicht auf dem >- SfxDispatcher. >- >+ The SfxShell instance is not on the SfxDispatcher. > */ > > { >@@ -338,21 +334,20 @@ inline BOOL SfxDispatcher::IsActive( const SfxShell& rShell ) > > inline BOOL SfxDispatcher::IsOnTop( const SfxShell& rShell ) > >-/* [Beschreibung] >+/* [Description] > >- Mit dieser Methode kann abgefragt werden, ob sich eine bestimmte >- <SfxShell>-Instanz zuoberst auf dem SfxDispatcher befindet. >+ This method checks whether a particular <SfxShell> instance is on >+ top of the SfxDispatcher. > >- [R"uckgabewert] >+ [Return value] > > BOOL TRUE >- Die SfxShell-Instanz befindet sich als oberste >- SfxShell auf dem SfxDispatcher. >+ The SfxShell instance is on the top of >+ the SfxDispatcher. > > FALSE >- Die SfxShell-Instanz befindet sich nicht als >- oberste SfxShell auf dem SfxDispatcher. >- >+ The SfxShell instance is not on the top of >+ the SfxDispatcher. > */ > > { >diff --git a/sfx2/inc/sfx2/docfac.hxx b/sfx2/inc/sfx2/docfac.hxx >index 17c29a7..77371f9 100644 >--- a/sfx2/inc/sfx2/docfac.hxx >+++ b/sfx2/inc/sfx2/docfac.hxx >@@ -54,25 +54,25 @@ class SfxBindings; > typedef void (*SfxVoidFunc)(); > > #define SDT_SDT_DOCFACTPRIO 10 // Explorer >-#define SDT_SW_DOCFACTPRIO 20 // Text-Dokument >-#define SDT_SWW_DOCFACTPRIO 21 // Web-Dokument >-#define SDT_SC_DOCFACTPRIO 30 // Tabellen-Dokument >-#define SDT_SI_DOCFACTPRIO 40 // Impress-Dokument >-#define SDT_SD_DOCFACTPRIO 41 // Draw-Dokument >-#define SDT_SCH_DOCFACTPRIO 50 // Chart-Dokument >-#define SDT_SMA_DOCFACTPRIO 60 // Math-Dokument >-#define SDT_SIM_DOCFACTPRIO 70 // Image-Dokument >-#define SDT_FRM_DOCFACTPRIO 100 // Rahmen-Dokument >-#define SDT_MSG_DOCFACTPRIO 110 // Nachrichten-Dokument >-#define SDT_SDB_DOCFACTPRIO 200 // Datenbank-Dokument >+#define SDT_SW_DOCFACTPRIO 20 // Text Document >+#define SDT_SWW_DOCFACTPRIO 21 // Web Document >+#define SDT_SC_DOCFACTPRIO 30 // Table Document >+#define SDT_SI_DOCFACTPRIO 40 // Impress Document >+#define SDT_SD_DOCFACTPRIO 41 // Draw Document >+#define SDT_SCH_DOCFACTPRIO 50 // Chart Document >+#define SDT_SMA_DOCFACTPRIO 60 // Math Document >+#define SDT_SIM_DOCFACTPRIO 70 // Image Document >+#define SDT_FRM_DOCFACTPRIO 100 // Frame Document >+#define SDT_MSG_DOCFACTPRIO 110 // Message Document >+#define SDT_SDB_DOCFACTPRIO 200 // Database Document > > //==================================================================== > > class SFX2_DLLPUBLIC SfxObjectFactory > { > private: >- const char* pShortName; // Objekt-Kurzname >- SfxObjectFactory_Impl* pImpl; // Zusatzdaten >+ const char* pShortName; >+ SfxObjectFactory_Impl* pImpl; // Additional Data > SfxObjectShellFlags nFlags; > SAL_DLLPRIVATE void Construct(); > >diff --git a/sfx2/inc/sfx2/docfilt.hxx b/sfx2/inc/sfx2/docfilt.hxx >index 44503a2..f540e79 100644 >--- a/sfx2/inc/sfx2/docfilt.hxx >+++ b/sfx2/inc/sfx2/docfilt.hxx >@@ -55,7 +55,7 @@ > #define SFX_FILTER_NOTINFILEDLG 0x00001000L > #define SFX_FILTER_NOTINCHOOSER 0x00002000L > #define SFX_FILTER_ASYNC 0x00004000L >-// Legt Objekt nur an, kein Laden >+// Sets object only, does not load > #define SFX_FILTER_CREATOR 0x00008000L > #define SFX_FILTER_OPENREADONLY 0x00010000L > #define SFX_FILTER_MUSTINSTALL 0x00020000L >diff --git a/sfx2/inc/sfx2/doctempl.hxx b/sfx2/inc/sfx2/doctempl.hxx >index 0f2ac25..09c5d1c 100644 >--- a/sfx2/inc/sfx2/doctempl.hxx >+++ b/sfx2/inc/sfx2/doctempl.hxx >@@ -70,7 +70,7 @@ public: > static BOOL SaveDir( /*SfxTemplateDir &rEntry */ ) ; > const SfxDocumentTemplates &operator=(const SfxDocumentTemplates &); > >- BOOL Rescan( ); // Aktualisieren >+ BOOL Rescan( ); > void ReInitFromComponent(); > > BOOL IsRegionLoaded( USHORT nIdx ) const; >@@ -87,16 +87,15 @@ public: > > String GetDefaultTemplatePath(const String &rLongName); > >- // Pfad zur Vorlage geben lassen; logischer Name muss angegeben >- // werden, damit beim Ueberschreiben einer Vorlage der >- // richtige Dateiname gefunden werden kann >+ // Path to the template; the logical name must be given in order to find >+ // the correct file name when overwriting a template > String GetTemplatePath(USHORT nRegion, const String &rLongName) const; > > // Allows to retrieve the target template URL from the UCB > ::rtl::OUString GetTemplateTargetURLFromComponent( const ::rtl::OUString& aGroupName, > const ::rtl::OUString& aTitle ); > >- // Speichern als Vorlage hat geklappt -> Aktualisieren >+ // Save as template worked -> update > void NewTemplate(USHORT nRegion, > const String &rLongName, > const String &rFileName); >diff --git a/sfx2/inc/sfx2/filedlghelper.hxx b/sfx2/inc/sfx2/filedlghelper.hxx >index d584106..556a953 100644 >--- a/sfx2/inc/sfx2/filedlghelper.hxx >+++ b/sfx2/inc/sfx2/filedlghelper.hxx >@@ -84,10 +84,10 @@ class Window; > #define SFXWB_READONLY WB_READONLY // ((WinBits)0x02000000) > #define SFXWB_PATHDIALOG WB_PATH // ((WinBits)0x00100000) > #define SFXWB_CLASSPATH ( 0x08000000L | SFXWB_PATHDIALOG ) >-#define SFXWB_SHOWALLFOLDER 0x10000000L // alle Ordner auch Mail/News/... >-#define SFXWB_MULTISELECTION 0x20000000L // Multiselection an >+#define SFXWB_SHOWALLFOLDER 0x10000000L // All folders also mail/news/... >+#define SFXWB_MULTISELECTION 0x20000000L > #define SFXWB_NOREMOTE 0x40000000L >-#define SFXWB_SHOWVERSIONS 0x80000000L // Versionsauswahl anzeigen >+#define SFXWB_SHOWVERSIONS 0x80000000L > > #define SFXWB_GRAPHIC 0x00800000L // FileOpen with link and preview box > #define SFXWB_SHOWSTYLES 0x01000000L // FileOpen with link and preview box and styles >diff --git a/sfx2/inc/sfx2/frame.hxx b/sfx2/inc/sfx2/frame.hxx >index 3ff0ab5..4e7f067 100644 >--- a/sfx2/inc/sfx2/frame.hxx >+++ b/sfx2/inc/sfx2/frame.hxx >@@ -100,16 +100,15 @@ typedef ::std::vector< String* > TargetList; > #define SFXFRAME_HASTITLE 0x0001 > > //========================================================================== >-// Ein SfxFrame ist eine Verwaltungsklasse f"ur Fenster und deren Inhalte. >-// Eine SfxApplication pr"asentiert sich als Hierarchie von SfxFrames, wobei >-// die konkreten Inhalte in den abgeleiteten Klassen festgelegt werden. >-// Die Basisklasse SfxFrame implementiert 2 Aspekte der Frames: Benennung und >-// Kontrolle der Lebensdauer. >-// Innerhalb einer Frames-Hierarchie kontrolliert immer der ParentFrame die >-// Lebensdauer seiner ChildFrames, auch wenn sie in der Regel gar nicht von >-// ihm selbst erzeugt wurden. Durch Aufruf vonn DoClose() an irgendeinem >-// Frame in der Hierarchie kann ein Teil des "Frameworks" entfernt werden, >-// wobei sich Frames an ihren ParentFrames selbst abmelden. >+// SfxFrame is a management class for windows and their content. >+// A SfxApplication represent a hierarchy of SfxFrames, with which the actual >+// content in the derived classes is defined. The base class SfxFrame >+// implements two aspects of frames: naming and control of its lifespan. >+// Inside a frame hierarchy the parent frame always controls the lifespan of >+// its child frames, even though they usually are not even produced by the >+// parent. By calling DoCloser() on any frame in the hierarchy, >+// a part of the "framework" can be removed, where frames unsubscribe >+// from their parent frames. > //========================================================================== > > class SfxFrameArr_Impl; >@@ -196,7 +195,7 @@ public: > SAL_DLLPRIVATE sal_Bool IsClosing_Impl() const; > SAL_DLLPRIVATE void SetIsClosing_Impl(); > >- // Methoden f"ur den Zugriff auf das aktuelle Set >+ // Methods for accessing the current set > SAL_DLLPRIVATE void SetDescriptor( SfxFrameDescriptor* ); > SAL_DLLPRIVATE SfxFrameDescriptor* GetDescriptor() const; > >diff --git a/sfx2/inc/sfx2/frmdescr.hxx b/sfx2/inc/sfx2/frmdescr.hxx >index ac9331e..35a391f 100644 >--- a/sfx2/inc/sfx2/frmdescr.hxx >+++ b/sfx2/inc/sfx2/frmdescr.hxx >@@ -47,16 +47,14 @@ typedef SfxFrameDescriptor* SfxFrameDescriptorPtr; > SV_DECL_PTRARR(SfxFramesArr, SfxFrameDescriptorPtr, 4, 2) > > //=========================================================================== >-// Die SfxFrame...descriptoren bauen eine rekursive Struktur auf, die >-// s"amtliche zur Anzeige des Frame-Dokuments erforderlichen Daten umfa\st. >-// "Uber einen SfxFrameSetDescriptor hat man Zugriff auf die gesamte darunter >-// liegende Struktur. >-// Aufgrund der besonderen Eigenschaften des SfxFrames-Dokuments ist ein >-// SfxFramesSetDescriptor nicht nur der Inhalt dieses Dokuments, sondern >-// beschreibt auch die View darauf. >-// Das FrameSet wird aus Zeilen aufgebaut, die wiederum die eigentlichen >-// Fenster enthalten. Eine Zeile kann horizontal oder vertikal ausgerichtet >-// sein, woraus sich auch das Alignment des FrameSets ergibt. >+// The SfxFrame descriptors build a recursive structure, that covers all the >+// required data in-order to display the frame document. >+// Through a SfxFrameSetDescriptor access is given to the whole underlying >+// structure. Due to the nature of the SfxFrames document, the >+// SfxFramesSetDescriptor is not only the content of this document, but also >+// describes the view on it. The FrameSet is made up of lines, which in turn, >+// contains the actual window . A line can be horizontally or vertically >+// aligned, from which also the alignment of the FrameSet is given. > //=========================================================================== > > enum ScrollingMode >@@ -105,7 +103,7 @@ public: > SfxFrameDescriptor(); > ~SfxFrameDescriptor(); > >- // Eigenschaften >+ // Properties > void TakeProperties( const SfxFrameProperties& rProp ); > > // FileName/URL >@@ -184,7 +182,7 @@ public: > void SetHasUI( BOOL bOn ) > { bHasUI = bOn; } > >- // Attribute f"ur das Splitwindow >+ // Attribute for Splitwindow > USHORT GetItemId() const > { return nItemId; } > void SetItemId( USHORT nId ) >@@ -193,11 +191,11 @@ public: > long GetSize() const; > USHORT GetItemPos() const; > >- // Kopie z.B. f"ur die Views >+ // Copy for example for Views > SfxFrameDescriptor* Clone( BOOL bWithIds = TRUE ) const; > }; > >-// Kein Bock, einen operator= zu implementieren... >+// No block to implement a =operator > struct SfxFrameProperties > { > String aURL; >diff --git a/sfx2/inc/sfx2/frmhtml.hxx b/sfx2/inc/sfx2/frmhtml.hxx >index ea00089..b0ce814 100644 >--- a/sfx2/inc/sfx2/frmhtml.hxx >+++ b/sfx2/inc/sfx2/frmhtml.hxx >@@ -51,7 +51,7 @@ protected: > SfxHTMLParser( rStream, bIsNewDoc, pMediumPtr ) {}; > > public: >- // Diese Methoden koennen auch von anderen Parsern benutzt werden >+ // These methods can also be used by other parsers. > static void ParseFrameOptions(SfxFrameDescriptor*, const HTMLOptions*, const String& ); > > }; >diff --git a/sfx2/inc/sfx2/hintpost.hxx b/sfx2/inc/sfx2/hintpost.hxx >index fb3c072..adb9422 100644 >--- a/sfx2/inc/sfx2/hintpost.hxx >+++ b/sfx2/inc/sfx2/hintpost.hxx >@@ -39,17 +39,16 @@ class SfxHint; > > class SfxHintPoster: public SvRefBase > >-/* [Beschreibung] >+/* [Description] > >- Mit Instanzen dieser Klasse k"onnen eindeutige Events per PostUserEvent >- "uber die StarView-Application verschickt werden. Wenn das User-Event >- ausgel"ost wird, wird der Handler <Event()> gerufen, dessen >- Basisimplementierung den mit <SetEventHdl()> angegbenen Link ruft. >+ With instances of this class unique events per PostUserEvent can be sent >+ using the StarView-application. If the User-Event is triggered often, >+ the handler <Event()> is called, the base implementation with the >+ <SetEventHdl()> line is making these link calls. > >- Die Instanz wird via Ref-Count mindestens solange gehalten, wie >- ein ggf. abgeschicktes Event noch nicht angekommen ist. Sollte das >- Ziel vorher sterben, ist die Verbindung zuvor mit 'SetEventHdl(GenLink())' >- zu kappen. >+ The instance are held via Ref-Count at least as long as a possible sent >+ event has not arrived yet. Should be killed before the goal, before the >+ connection is SetEventHdl (GenLink ()) . > */ > > { >diff --git a/sfx2/inc/sfx2/htmlmode.hxx b/sfx2/inc/sfx2/htmlmode.hxx >index e841ad9..be42cf8 100644 >--- a/sfx2/inc/sfx2/htmlmode.hxx >+++ b/sfx2/inc/sfx2/htmlmode.hxx >@@ -30,19 +30,19 @@ > > > #define HTMLMODE_ON 0x0001 >-#define HTMLMODE_PARA_BORDER 0x0002 /* Absatzumrandungen */ >-#define HTMLMODE_PARA_DISTANCE 0x0004 /* bestimmte Absatzabstaende */ >-#define HTMLMODE_SMALL_CAPS 0x0008 /* Kapitaelchen */ >-#define HTMLMODE_FRM_COLUMNS 0x0010 /* spaltige Rahmen */ >+#define HTMLMODE_PARA_BORDER 0x0002 >+#define HTMLMODE_PARA_DISTANCE 0x0004 >+#define HTMLMODE_SMALL_CAPS 0x0008 >+#define HTMLMODE_FRM_COLUMNS 0x0010 > #define HTMLMODE_SOME_STYLES 0x0020 /* mind. MS IE */ > #define HTMLMODE_FULL_STYLES 0x0040 /* == SW */ >-#define HTMLMODE_BLINK 0x0080 /* blinkende Zeichen*/ >-#define HTMLMODE_PARA_BLOCK 0x0100 /* Blocksatz */ >-#define HTMLMODE_DROPCAPS 0x0200 /* Initialen*/ >-#define HTMLMODE_FIRSTLINE 0x0400 /* Erstzeileneinzug mit Spacer == NS 3.0 */ >-#define HTMLMODE_GRAPH_POS 0x0800 /* Grafikpositionen Hintergrund */ >-#define HTMLMODE_FULL_ABS_POS 0x1000 /* abs. Rahmenpositionierung */ >-#define HTMLMODE_SOME_ABS_POS 0x2000 /* abs. Rahmenpositionierung vollst.*/ >+#define HTMLMODE_BLINK 0x0080 >+#define HTMLMODE_PARA_BLOCK 0x0100 >+#define HTMLMODE_DROPCAPS 0x0200 >+#define HTMLMODE_FIRSTLINE 0x0400 /* First-line intent with Spacer == NS 3.0 */ >+#define HTMLMODE_GRAPH_POS 0x0800 >+#define HTMLMODE_FULL_ABS_POS 0x1000 >+#define HTMLMODE_SOME_ABS_POS 0x2000 > #define HTMLMODE_RESERVED1 0x4000 > #define HTMLMODE_RESERVED0 0x8000 > >diff --git a/sfx2/inc/sfx2/linkmgr.hxx b/sfx2/inc/sfx2/linkmgr.hxx >index 651cfb3..e0913fb 100644 >--- a/sfx2/inc/sfx2/linkmgr.hxx >+++ b/sfx2/inc/sfx2/linkmgr.hxx >@@ -48,10 +48,10 @@ namespace com { namespace sun { namespace star { > > namespace sfx2 > { >- // Damit der Link ueber den Status der zu ladenen Grafik informierten werden >- // verschickt das FileObject ein SvData, mit der FormatId >- // "RegisterStatusInfoId" und ein einem String als Datentraeger. Dieser >- // enthaelt den folgenden enum. >+ // For the link to receive information about the status of graphics that >+ // will be loaded the FileObject sends a SvData, which contains the >+ // FormatID "RegisterStatusInfoId" and a string as the data container. >+ // This contains the following enum. > > class SvBaseLink; > class SvBaseLinkRef; >@@ -71,7 +71,7 @@ class SFX2_DLLPUBLIC LinkManager > SvBaseLinks aLinkTbl; > SvLinkSources aServerTbl; > >- SfxObjectShell *pPersist; // LinkMgr muss vor SfxObjectShell freigegeben werden >+ SfxObjectShell *pPersist; // LinkMgr must be release before SfxObjectShell > protected: > BOOL InsertLink( SvBaseLink* pLink, USHORT nObjType, USHORT nUpdateType, > const String* pName = 0 ); >@@ -104,23 +104,23 @@ public: > void Remove( USHORT nPos, USHORT nCnt = 1 ); > BOOL Insert( SvBaseLink* pLink ); > >- // den Link mit einem SvLinkSource verbinden und in die Liste eintragen >+ // the links connect to a SvLinkSource and adds to the list > BOOL InsertDDELink( SvBaseLink*, > const String& rServer, > const String& rTopic, > const String& rItem ); > >- // falls am Link schon alles eingestellt ist ! >+ // if everything is already set at the link! > BOOL InsertDDELink( SvBaseLink* ); > >- // den Link mit einem PseudoObject verbinden und in die Liste eintragen >+ // Connect the links to a pseudo-object and add to the list > BOOL InsertFileLink( sfx2::SvBaseLink&, > USHORT nFileType, > const String& rTxt, > const String* pFilterNm = 0, > const String* pRange = 0 ); > >- // falls am Link schon alles eingestellt ist ! >+ // if everything is already set for the link! > BOOL InsertFileLink( sfx2::SvBaseLink& ); > > void ReconnectDdeLink(SfxObjectShell& rServer); >@@ -134,7 +134,7 @@ public: > */ > void LinkServerShell(const ::rtl::OUString& rPath, SfxObjectShell& rServer, ::sfx2::SvBaseLink& rLink) const; > >- // erfrage die Strings fuer den Dialog >+ // Obtain the string for the dialog > BOOL GetDisplayNames( const SvBaseLink *, > String* pType, > String* pFile = 0, >@@ -148,28 +148,28 @@ public: > BOOL bUpdateGrfLinks = FALSE, > Window* pParentWin = 0 ); > >- // Liste aller Links erfragen (z.B. fuer Verknuepfungs-Dialog) >+ // Call for list of links (eg for link-dialog) > const SvBaseLinks& GetLinks() const { return aLinkTbl; } > >- // ----------------- Serverseitige Verwaltung -------------------- >+ // ----------------- Server-side management -------------------- > >- // Liste der zu serviereden Links erfragen >+ // Call with list of links to server > const SvLinkSources& GetServers() const { return aServerTbl; } >- // einen zu servierenden Link eintragen/loeschen >+ // Link register/delete > BOOL InsertServer( SvLinkSource* rObj ); > void RemoveServer( SvLinkSource* rObj ); > void RemoveServer( USHORT nPos, USHORT nCnt = 1 ) > { aServerTbl.Remove( nPos, nCnt ); } > >- // eine Uebertragung wird abgebrochen, also alle DownloadMedien canceln >- // (ist zur Zeit nur fuer die FileLinks interressant!) >+ // A transfer is aborted, so cancel all download media >+ // (for the time beeing this is only of interest for the FileLinks!) > void CancelTransfers(); > >- // um Status Informationen aus dem FileObject an den BaseLink zu >- // senden, gibt es eine eigene ClipBoardId. Das SvData-Object hat >- // dann die entsprechenden Informationen als String. >- // Wird zur Zeit fuer FileObject in Verbindung mit JavaScript benoetigt >- // - das braucht Informationen ueber Load/Abort/Error >+ // To send status information from the FileObject to the Baselink, >+ // for this there exist a separate ClipBoardId. The SvData-object has >+ // got the appropriate information as a string. >+ // Is now required for FileObject in conjunction with JavaScript >+ // this needs information about Load/Abort/Error > static ULONG RegisterStatusInfoId(); > > // if the mimetype says graphic/bitmap/gdimetafile then get the >@@ -183,15 +183,15 @@ private: > LinkManager& operator=( const LinkManager& ); > }; > >-// Trenner im LinkName fuer die DDE-/File-/Grafik- Links >-// (nur wer es braucht, um einen SvLinkName zusammenzubasteln) >+// Separator in the link name for the DDE-/File-/Graphics- links >+// (only those who need to construct a SvLinkName) > const sal_Unicode cTokenSeperator = 0xFFFF; > >-// erzeuge einen String fuer den SvLinkName. Fuer >-// - DDE die ersten 3 Strings, (Server, Topic, Item) >-// - File-/Grf-LinkNms die letzen 3 Strings (FileName, Bereich, Filter) >+// create a string for the SvLinkName. For: >+// - DDE the first 3 Strings, (Server, Topic, Item) >+// - File-/Graphics-LinkNames the last 3 Strings (FileName, Region, Filter) > SFX2_DLLPUBLIC void MakeLnkName( String& rName, >- const String* pType, // kann auch 0 sein !! >+ const String* pType, // Can also be null!! > const String& rFile, > const String& rLink, > const String* pFilter = 0 ); >diff --git a/sfx2/inc/sfx2/linksrc.hxx b/sfx2/inc/sfx2/linksrc.hxx >index 25aeded..672b355 100644 >--- a/sfx2/inc/sfx2/linksrc.hxx >+++ b/sfx2/inc/sfx2/linksrc.hxx >@@ -48,7 +48,7 @@ class Window; > class String; > > #ifndef ADVISEMODE_NODATA >-// Muessen die gleichen Werte wie Ole2 ADVF_* sein >+// Must be the same value as Ole2 ADVF_* > #define ADVISEMODE_NODATA 0x01 > //#define ADVISEMODE_PRIMEFIRST 0x02 > #define ADVISEMODE_ONLYONCE 0x04 >diff --git a/sfx2/inc/sfx2/lnkbase.hxx b/sfx2/inc/sfx2/lnkbase.hxx >index 5e84c33..9ec284b 100644 >--- a/sfx2/inc/sfx2/lnkbase.hxx >+++ b/sfx2/inc/sfx2/lnkbase.hxx >@@ -54,16 +54,16 @@ class FileDialogHelper; > #define OBJECT_DDE_EXTERN 0x02 > #endif > >-#define OBJECT_CLIENT_SO 0x80 // ein Link >+#define OBJECT_CLIENT_SO 0x80 // a Link > #define OBJECT_CLIENT_DDE 0x81 >-//#define OBJECT_CLIENT_OLE 0x82 // ein Ole-Link >-//#define OBJECT_CLIENT_OLE_CACHE 0x83 // ein Ole-Link mit SvEmbeddedObject >+//#define OBJECT_CLIENT_OLE 0x82 // a Ole-Link >+//#define OBJECT_CLIENT_OLE_CACHE 0x83 // a Ole-Link with SvEmbeddedObject > #define OBJECT_CLIENT_FILE 0x90 > #define OBJECT_CLIENT_GRF 0x91 > #define OBJECT_CLIENT_OLE 0x92 // embedded link > > enum sfxlink { >- // Ole2 compatibel und persistent >+ // Ole2 compatibel and persistent > LINKUPDATE_ALWAYS = 1, > LINKUPDATE_ONCALL = 3, > >@@ -84,7 +84,7 @@ private: > USHORT nObjType; > BOOL bVisible : 1; > BOOL bSynchron : 1; >- BOOL bUseCache : 1; // fuer GrafikLinks! >+ BOOL bUseCache : 1; // for Graphics Links! > BOOL bWasLastEditOK : 1; > > DECL_LINK( EndEditHdl, String* ); >@@ -94,9 +94,9 @@ private: > protected: > void SetObjType( USHORT ); > >- // setzen des LinkSourceName ohne aktion >+ // Set LinkSourceName without action > void SetName( const String & rLn ); >- // LinkSourceName der im SvLinkBase steht >+ // LinkSourceName which is in SvLinkBase > String GetName() const; > > ImplBaseLinkData* pImplData; >@@ -120,7 +120,7 @@ protected: > > public: > TYPEINFO(); >- // ask JP >+ > virtual void Closed(); > SvBaseLink( const String& rNm, USHORT nObjectType, > SvLinkSource* ); >@@ -151,10 +151,10 @@ public: > // Link impl: DECL_LINK( MyEndDialogHdl, SvBaseLink* ); <= param is this > virtual void Edit( Window*, const Link& rEndEditHdl ); > >- // soll der Link im Dialog angezeigt werden ? (Links im Link im ...) >+ // should the link appear in the dialog? (Links in the link in the...) > BOOL IsVisible() const { return bVisible; } > void SetVisible( BOOL bFlag ) { bVisible = bFlag; } >- // soll der Link synchron oder asynchron geladen werden? >+ // should the Link be loaded synchronous or asynchronous? > BOOL IsSynchron() const { return bSynchron; } > void SetSynchron( BOOL bFlag ) { bSynchron = bFlag; } > >diff --git a/sfx2/inc/sfx2/mgetempl.hxx b/sfx2/inc/sfx2/mgetempl.hxx >index e9d5ba7..5f93474 100644 >--- a/sfx2/inc/sfx2/mgetempl.hxx >+++ b/sfx2/inc/sfx2/mgetempl.hxx >@@ -36,9 +36,9 @@ > > #include <sfx2/tabdlg.hxx> > >-/* erwartet: >- SID_TEMPLATE_NAME : In: StringItem, Name der Vorlage >- SID_TEMPLATE_FAMILY : In: Familie der Vorlage >+/* expected: >+ SID_TEMPLATE_NAME : In: StringItem, Name of Template >+ SID_TEMPLATE_FAMILY : In: Family of Template > */ > > class SfxStyleFamilies; >@@ -74,7 +74,7 @@ class SfxManageStyleSheetPage : public SfxTabPage > String aBuf; > BOOL bModified; > >- // initiale Daten des Styles >+ // initial data for the style > String aName; > String aFollow; > String aParent; >diff --git a/sfx2/inc/sfx2/minarray.hxx b/sfx2/inc/sfx2/minarray.hxx >index b66be5e..5a6e520 100644 >--- a/sfx2/inc/sfx2/minarray.hxx >+++ b/sfx2/inc/sfx2/minarray.hxx >@@ -282,7 +282,7 @@ void ARR::Insert( USHORT nPos, const T& rElems, USHORT nLen ) \ > if ( nUnused == 0 ) \ > { \ > \ >- /* auf die naechste Grow-Grenze aufgerundet vergroeszern */ \ >+ /* increase (round up) ro the next Grow-limit */ \ > USHORT nNewSize; \ > for ( nNewSize = nUsed+nGrow; nNewSize < (nUsed + nLen); ++nNewSize ) \ > /* empty loop */; \ >diff --git a/sfx2/inc/sfx2/mnumgr.hxx b/sfx2/inc/sfx2/mnumgr.hxx >index 6617c7e..2e804ca 100644 >--- a/sfx2/inc/sfx2/mnumgr.hxx >+++ b/sfx2/inc/sfx2/mnumgr.hxx >@@ -57,9 +57,9 @@ class SfxMenuManager > { > friend class SfxPopupMenuManager; > >- SfxVirtualMenu* pMenu; // das eigentliche Menu >+ SfxVirtualMenu* pMenu; // the actual Menu > SfxVirtualMenu* pOldMenu; // only while reconfiguring >- BOOL bMenuBar; // Popup oder MenuBar >+ BOOL bMenuBar; // Popup or MenuBar > SfxBindings* pBindings; > ResMgr* pResMgr; > sal_uInt32 nType; >diff --git a/sfx2/inc/sfx2/module.hxx b/sfx2/inc/sfx2/module.hxx >index 8952812..128d499 100644 >--- a/sfx2/inc/sfx2/module.hxx >+++ b/sfx2/inc/sfx2/module.hxx >@@ -26,8 +26,8 @@ > * > ************************************************************************/ > #ifndef _SFXMODULE_HXX >-#define _SFXMODULE_HXX // intern >-#define _SFXMOD_HXX // extern >+#define _SFXMODULE_HXX // internal >+#define _SFXMOD_HXX // external > > #include "sal/config.h" > #include "sfx2/dllapi.h" >diff --git a/sfx2/inc/sfx2/msg.hxx b/sfx2/inc/sfx2/msg.hxx >index 997a033..4248643 100644 >--- a/sfx2/inc/sfx2/msg.hxx >+++ b/sfx2/inc/sfx2/msg.hxx >@@ -33,42 +33,51 @@ > > //-------------------------------------------------------------------- > >-#define SFX_SLOT_CACHABLE 0x0001L // exklusiv zu VOLATILE, default >-#define SFX_SLOT_VOLATILE 0x0002L // per Timer alle 2s neu geholt, exklusiv zu CACHABLE >-#define SFX_SLOT_TOGGLE 0x0004L // invertiert bei Execute alten Wert >-#define SFX_SLOT_AUTOUPDATE 0x0008L // invalidiert den Status nach Execute automatisch >- >-#define SFX_SLOT_SYNCHRON 0x0010L // exklusiv zu ASYNCHRON, default >-#define SFX_SLOT_ASYNCHRON 0x0020L // via Post-Message, exklusiv zu SYNCHRON >- >-#define SFX_SLOT_HASCOREID 0x0040L // Slot-ID/Which-ID Mappting durchf"uhren >-#define SFX_SLOT_HASDIALOG 0x0080L // Punkte fuer Dialog nach recofig >- >-#define SFX_SLOT_NORECORD 0x0100L // kein Recording >-#define SFX_SLOT_RECORDPERITEM 0x0200L // je Item ein Statement >-#define SFX_SLOT_RECORDPERSET 0x0400L // das ganze Set ist ein Statement, def. >-#define SFX_SLOT_RECORDMANUAL 0x0800L // Recording vom Applikationsentwickler iss-default >- >-#define SFX_SLOT_RECORDABSOLUTE 0x1000000L // Recording mit absolutem Target >+#define SFX_SLOT_CACHABLE 0x0001L // exclusiv to VOLATILE, default >+#define SFX_SLOT_VOLATILE 0x0002L // per Timer every 2s get new, >+ // exclusiv to CACHABLE >+#define SFX_SLOT_TOGGLE 0x0004L // inverted for Execute old value >+#define SFX_SLOT_AUTOUPDATE 0x0008L // invalidated the status automatically >+ // after execute >+ >+#define SFX_SLOT_SYNCHRON 0x0010L // exclusiv to ASYNCHRON, default >+#define SFX_SLOT_ASYNCHRON 0x0020L // via Post-Message, exclusiv >+ // to SYNCHRON >+ >+#define SFX_SLOT_HASCOREID 0x0040L // Slot-ID/Which-ID execute mapping >+#define SFX_SLOT_HASDIALOG 0x0080L // Coordinates for dialogue after recofig >+ >+#define SFX_SLOT_NORECORD 0x0100L // no recording >+#define SFX_SLOT_RECORDPERITEM 0x0200L // each item, one statement >+#define SFX_SLOT_RECORDPERSET 0x0400L // The whole Set is a Statement, default >+#define SFX_SLOT_RECORDMANUAL 0x0800L // Recording by the application >+ // developer is default >+ >+#define SFX_SLOT_RECORDABSOLUTE 0x1000000L // Recording with absolute Target > #define SFX_SLOT_STANDARD ( SFX_SLOT_CACHABLE | \ > SFX_SLOT_SYNCHRON | \ > SFX_SLOT_RECORDPERSET ) > >-#define SFX_SLOT_PROPGET 0x1000L // abfragbares Property >-#define SFX_SLOT_PROPSET 0x2000L // setzbares Property, exklusiv zu SFX_SLOT_METHOD >-#define SFX_SLOT_METHOD 0x4000L // Methode, exklusiv zu SFX_SLOT_PROPSET >+#define SFX_SLOT_PROPGET 0x1000L // get property >+#define SFX_SLOT_PROPSET 0x2000L // set property, exclusiv to >+ // SFX_SLOT_METHOD >+#define SFX_SLOT_METHOD 0x4000L // Method, exclusiv to SFX_SLOT_PROPSET > >-#define SFX_SLOT_FASTCALL 0x8000L // vor Execute keine Pr"ufung, ob disabled >+#define SFX_SLOT_FASTCALL 0x8000L // No test if disabled before Execute > >-#define SFX_SLOT_STATUSBARCONFIG 0x10000L // konfigurierbar in Statuszeile >-#define SFX_SLOT_MENUCONFIG 0x20000L // konfigurierbar im Men"u >-#define SFX_SLOT_TOOLBOXCONFIG 0x40000L // konfigurierbar in Toolboxen >-#define SFX_SLOT_ACCELCONFIG 0x80000L // konfigurierbar auf Tasten >+#define SFX_SLOT_STATUSBARCONFIG 0x10000L // configurable status row >+#define SFX_SLOT_MENUCONFIG 0x20000L // configurable Menu >+#define SFX_SLOT_TOOLBOXCONFIG 0x40000L // configurable Toolboxen >+#define SFX_SLOT_ACCELCONFIG 0x80000L // configurable keys > >-#define SFX_SLOT_CONTAINER 0x100000L // beim InPlace vom Container bedient >-#define SFX_SLOT_READONLYDOC 0x200000L // auch bei readonly-Docs verf"ugbar >-#define SFX_SLOT_IMAGEROTATION 0x400000L // bei Vertical/Bidi writing Image drehen >-#define SFX_SLOT_IMAGEREFLECTION 0x800000L // bei Vertical/Bidi writing Image spiegeln >+#define SFX_SLOT_CONTAINER 0x100000L // Operated by the container at >+ // InPlace >+#define SFX_SLOT_READONLYDOC 0x200000L // also available for >+ // read-only Documents >+#define SFX_SLOT_IMAGEROTATION 0x400000L // Rotate image on Vertical/ >+ // Bi-directional writing >+#define SFX_SLOT_IMAGEREFLECTION 0x800000L // Mirror image on Vertical/ >+ // Bi-directional writing > > //-------------------------------------------------------------------- > >@@ -236,9 +245,9 @@ class SfxPoolItem; > > struct SfxFormalArgument > { >- const SfxType* pType; // Typ des Parameters (SfxPoolItem Subklasse) >- const char* pName; // Name des Parameters >- USHORT nSlotId;// Slot-Id zur Identifikation des Parameters >+ const SfxType* pType; // Type of the parameter (SfxPoolItem subclass) >+ const char* pName; // Name of the sParameters >+ USHORT nSlotId; // Slot-Id for identification of the Parameters > > const TypeId& Type() const > { return pType->aTypeId; } >@@ -251,29 +260,30 @@ struct SfxFormalArgument > class SfxSlot > { > public: >- USHORT nSlotId; // in Shell eindeutige Slot-Id >- USHORT nGroupId; // f"ur Konfigurations-Bereich >- ULONG nHelpId; // i.d.R. == nSlotId >- ULONG nFlags; // artihm. veroderte Flags >- >- USHORT nMasterSlotId; // Enum-Slot bzw. Which-Id >- USHORT nValue; // Wert, falls Enum-Slot >- >- SfxExecFunc fnExec; // Funktion zum Ausf"uhren >- SfxStateFunc fnState; // Funktion f"ur Status >- >- const SfxType* pType; // SfxPoolItem-Typ (Status) >- const char* pName; // Name des Slots >- const char* pMethodName; // Name der Method falls anders >- >- const SfxSlot* pLinkedSlot; // Master-Slot f"ur Enum-Werte >- const SfxSlot* pNextSlot; // mit derselben Status-Methode >- >- const SfxFormalArgument* pFirstArgDef; // erste formale Argument-Definition >- USHORT nArgDefCount; // Anzahl der formalen Argumente >- long nDisableFlags; // DisableFlags, die vorhanden sein >- // m"ussen, damit der Slot enabled ist >- const char* pUnoName; // UnoName des Slots >+ USHORT nSlotId; // Unique slot-ID in Shell >+ USHORT nGroupId; // for configuration region >+ ULONG nHelpId; // Usually == nSlotId >+ ULONG nFlags; // artihmetic ordered Flags >+ >+ USHORT nMasterSlotId; // Enum-Slot for example Which-Id >+ USHORT nValue; // Value, in case of Enum-Slot >+ >+ SfxExecFunc fnExec; // Function to be excecuted >+ SfxStateFunc fnState; // Function for Status >+ >+ const SfxType* pType; // SfxPoolItem-Type (Status) >+ const char* pName; // Name of the Slots >+ const char* pMethodName; // Name of the Method if different >+ >+ const SfxSlot* pLinkedSlot; // Master-Slot for Enum value >+ const SfxSlot* pNextSlot; // with the same Status-Method >+ >+ const SfxFormalArgument* pFirstArgDef; // first formal Argument-Definition >+ USHORT nArgDefCount; // Number of formal Argumentents >+ long nDisableFlags; // DisableFlags that need to be >+ // present, so that the Slot >+ // can be enabled >+ const char* pUnoName; // UnoName for the Slots > > public: > >diff --git a/sfx2/inc/sfx2/new.hxx b/sfx2/inc/sfx2/new.hxx >index d9baf16..8d29868 100644 >--- a/sfx2/inc/sfx2/new.hxx >+++ b/sfx2/inc/sfx2/new.hxx >@@ -82,9 +82,8 @@ public: > SfxNewFileDialog(Window *pParent, USHORT nFlags = 0); > ~SfxNewFileDialog(); > >- // Liefert FALSE, wenn '- Keine -' als Vorlage eingestellt ist >- // Nur wenn IsTemplate() TRUE liefert, koennen Vorlagennamen >- // erfragt werden >+ // Returns FALSE, when '- No -' is set as Template >+ // Template names can only be obtained when IsTemplate() returns TRUE. > BOOL IsTemplate() const; > String GetTemplateRegion() const; > String GetTemplateName() const; >diff --git a/sfx2/inc/sfx2/objsh.hxx b/sfx2/inc/sfx2/objsh.hxx >index 71fd61f..f087ea9 100644 >--- a/sfx2/inc/sfx2/objsh.hxx >+++ b/sfx2/inc/sfx2/objsh.hxx >@@ -97,7 +97,7 @@ class Point; > > // From embobj.hxx > #define ASPECT_CONTENT 1 >-#define ASPECT_THUMBNAIL 2 /* 120 * 120, 6 Farben DIB in MetaFile */ >+#define ASPECT_THUMBNAIL 2 /* 120 * 120, 6 Colors DIB in MetaFile */ > #define ASPECT_ICON 4 > #define ASPECT_DOCPRINT 8 > #define ASPECT_ALL (ASPECT_CONTENT | ASPECT_THUMBNAIL | ASPECT_ICON | ASPECT_DOCPRINT) >@@ -152,7 +152,7 @@ typedef sal_uInt32 SfxObjectShellFlags; > #define SFX_TITLE_CAPTION 5 > #define SFX_TITLE_PICKLIST 6 > #define SFX_TITLE_HISTORY 7 >-#define SFX_TITLE_MAXLEN 10 // ab hier sind das L"angenbegrenzungen >+#define SFX_TITLE_MAXLEN 10 // this gives the limits on length > > #define SFX_LOADED_MAINDOCUMENT 1 > #define SFX_LOADED_IMAGES 2 >@@ -191,9 +191,9 @@ enum SfxObjectCreateMode > > /*==================================================================== > >-Die Klasse SfxObjectShell ist die Basisklasse f"ur SFx-Objekte, also >-f"ur Dokumente und Teile von Dokumenten, die als selbst"andige Objekte >-in fremde Objekte integriert werden k"onnen. >+The class SfxObjectShell is the base class for SFx-objects, ie documents >+and parts of documents that can be integrated as separate objects >+into foreign objects. > > ----------------------------------------------------------------------*/ > >@@ -213,13 +213,15 @@ class SFX2_DLLPUBLIC SfxObjectShell : > friend struct ModifyBlocker_Impl; > > private: >- struct SfxObjectShell_Impl* pImp; // interne Daten >+ struct SfxObjectShell_Impl* pImp; // internal data > >- SfxMedium * pMedium; // Beschreibung der Datei bzw. des Storage, in dem sich das Objekt befindet >+ SfxMedium * pMedium; // Description of the file for example >+ // storage that contains the object > SfxStyleSheetBasePool* pStyleSheetPool; // StyleSheets >- SfxObjectCreateMode eCreateMode; // Zweck des Objekts >- sal_Bool bHasName :1, // sal_True := bestehendes Objekt, sal_False := es ist ein neues Objekt >- bIsTmp :1; // temp. Storage >+ SfxObjectCreateMode eCreateMode; // Purpose of the object >+ sal_Bool bHasName :1, // sal_True := existing object, >+ // sal_False := new object >+ bIsTmp :1; // temporary Storage > > private: > SAL_DLLPRIVATE void UpdateTime_Impl(const ::com::sun::star::uno::Reference< >@@ -503,12 +505,10 @@ public: > SfxProgress* GetProgress() const; > void SetWaitCursor( BOOL bSet ) const; > >-//(mba) virtual SotObjectRef CreateAggObj( const SotFactory* pFact ); >- > // Naming Interface > void SetTitle( const String& rTitle ); > String GetTitle( sal_uInt16 nMaxLen = 0 ) const; >- void InvalidateName(); // Zuruecksetzen auf unbenannt >+ void InvalidateName(); // Re-set to unnamed > > // DDE-Interface > virtual long DdeExecute( const String& rCmd ); >@@ -525,10 +525,10 @@ public: > > // Contents > virtual SfxStyleSheetBasePool* GetStyleSheetPool(); >- void SetStyleSheetPool( SfxStyleSheetBasePool *pBasePool ) { >+ void SetStyleSheetPool(SfxStyleSheetBasePool *pBasePool ) { > pStyleSheetPool = pBasePool; } > >- //determine the position of the "Automatic" filter in the stylist >+ // Determine the position of the "Automatic" filter in the stylist > void SetAutoStyleFilterIndex(sal_uInt16 nSet); > sal_uInt16 GetAutoStyleFilterIndex(); > virtual sal_Bool HasBasic() const; >@@ -539,7 +539,7 @@ public: > GetDialogContainer(); > StarBASIC* GetBasic() const; > >- // Interface Dok-Inhalte, Organizer >+ // Interface Document content, Organizer > #define INDEX_IGNORE USHRT_MAX > > #define CONTENT_STYLE 0 >@@ -593,19 +593,18 @@ public: > void ReadNote( INote * ); > void UpdateNote( INote * ); > >- // F"ur Docs, die zum Formatieren die Viewgr"o\se >- // ben"otigen >+ // Documents, for which to format the view size >+ > virtual SfxObjectShell* GetObjectShell(); > > virtual SfxFrame* GetSmartSelf( SfxFrame* pSelf, SfxMedium& rMedium ); > > ::com::sun::star::uno::Reference< ::com::sun::star::frame::XModel > > GetModel() const; >- // Nur uebergangsweise fuer die Applikationen !!! >+ // Only temporarily for the applications! > void SetBaseModel( SfxBaseModel* pModel ); > ::com::sun::star::uno::Reference< ::com::sun::star::frame::XModel > GetBaseModel() const; >- // Nur uebergangsweise fuer die Applikationen !!! >- >+ // Only temporarily for the applications! > virtual SEQUENCE< OUSTRING > GetEventNames(); > > Window* GetDialogParent( SfxMedium* pMedium=0 ); >@@ -753,7 +752,7 @@ public: > SAL_DLLPRIVATE void ExecView_Impl(SfxRequest &); > SAL_DLLPRIVATE void StateView_Impl(SfxItemSet &); > >- // Laden-speichern public internals >+ // Load/Save public internals > SAL_DLLPRIVATE sal_Bool ImportFromGeneratedStream_Impl( > const ::com::sun::star::uno::Reference< ::com::sun::star::io::XStream >& xStream, > const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >& aMediaDescr ); >diff --git a/sfx2/inc/sfx2/prnmon.hxx b/sfx2/inc/sfx2/prnmon.hxx >index 8c0f3d5..4ca02b9 100644 >--- a/sfx2/inc/sfx2/prnmon.hxx >+++ b/sfx2/inc/sfx2/prnmon.hxx >@@ -42,7 +42,7 @@ struct SfxPrintProgress_Impl; > > // ------------------------------------------------------------------------ > >-#define PAGE_MAX 9999 //max. Anzahl der Seiten die gedruckt werden >+#define PAGE_MAX 9999 // max. Number of pages to be printed > > // ------------------------------------------------------------------------ > >diff --git a/sfx2/inc/sfx2/sfx.hrc b/sfx2/inc/sfx2/sfx.hrc >old mode 100755 >new mode 100644 >index a5f486a..8f16ca0 >--- a/sfx2/inc/sfx2/sfx.hrc >+++ b/sfx2/inc/sfx2/sfx.hrc >@@ -69,7 +69,7 @@ > #define EVENT_SGA_START EVENT_OBJ3_START > #define EVENT_SVX_START EVENT_OBJ4_START > >-// Achtung: die folgenden sind gleichzeitig SID_ON_... >+// Warning: the following are simultaneously SID_ON_ ... > #define SFX_EVENT_STARTAPP (EVENT_SFX_START) > #define SFX_EVENT_CLOSEAPP (EVENT_SFX_START + 1) > #define SFX_EVENT_CREATEDOC (EVENT_SFX_START + 2) >@@ -111,7 +111,7 @@ > #define SFX_EVENT_TITLECHANGED (EVENT_SFX_START + 30) > #define SFX_EVENT_MODECHANGED (EVENT_SFX_START + 31) > >-// Events f"ur Controls etc. >+// Events for Controls etc. > #define SFX_EVENT_MOUSEOVER_OBJECT ( EVENT_SFX_START + 100 ) > #define SFX_EVENT_MOUSECLICK_OBJECT ( EVENT_SFX_START + 101 ) > #define SFX_EVENT_MOUSEOUT_OBJECT ( EVENT_SFX_START + 102 ) >@@ -165,7 +165,7 @@ > #define SFX_OBJECTBAR_NAVIGATION 12 > #define SFX_OBJECTBAR_MAX 13 > >-// temp. wg. Kompatibilitaet >+// temporary due to compatibility > > #define SFX_OBJECTBAR_IDE 2 > #define SFX_OBJECTBAR_FRAME 3 >@@ -241,7 +241,7 @@ > #define STR_STYLE_FILTER_USED (RID_SFX_START+10) > #define STR_STYLE_FILTER_USERDEF (RID_SFX_START+11) > #define STR_STYLE_FILTER_ALL (RID_SFX_START+12) >-// +13 schon benutzt! >+// +13 already used! > #define STR_STYLE_FILTER_HIERARCHICAL (RID_SFX_START+1200) > > #define STR_NONAME (RID_SFX_START+100) >diff --git a/sfx2/inc/sfx2/sfxdefs.hxx b/sfx2/inc/sfx2/sfxdefs.hxx >index eafbef2..66e126f 100644 >--- a/sfx2/inc/sfx2/sfxdefs.hxx >+++ b/sfx2/inc/sfx2/sfxdefs.hxx >@@ -29,9 +29,9 @@ > #ifndef _SFXDEFS_HXX > #define _SFXDEFS_HXX > >-#define MESSAGEFILE_SDM_EXT "sdm" // Extension des neuen Formats >-#define MESSAGEFILE_EXT "smd" // Extension der Single-Mail/News-Files >-#define MESSAGETEMPFILE_EXT "sd~" // Extension f"ur Mail/News-TempFiles >+#define MESSAGEFILE_SDM_EXT "sdm" // Extension for the new Formats >+#define MESSAGEFILE_EXT "smd" // Extension for Single-Mail/News-Files >+#define MESSAGETEMPFILE_EXT "sd~" // Extension for Mail/News-TempFiles > > #define SfxFilterFlags ULONG > #define PRODUCT_VERSION "5.0" >diff --git a/sfx2/inc/sfx2/sfxhtml.hxx b/sfx2/inc/sfx2/sfxhtml.hxx >index 7d52f34..137d7c5 100644 >--- a/sfx2/inc/sfx2/sfxhtml.hxx >+++ b/sfx2/inc/sfx2/sfxhtml.hxx >@@ -48,9 +48,9 @@ class SFX2_DLLPUBLIC SfxHTMLParser : public HTMLParser > String aScriptType; > > SfxMedium* pMedium; >- SfxMedium *pDLMedium; // Medium fuer Download von Files >+ SfxMedium *pDLMedium; // Medium for Download Files > >- USHORT nMetaTags; // Anzahl der bisher gelesenen Meta-Tags >+ USHORT nMetaTags; // Number of previously read Meta-Tags > ScriptType eScriptType; > > SAL_DLLPRIVATE void GetScriptType_Impl( SvKeyValueIterator* ); >@@ -62,9 +62,9 @@ protected: > virtual ~SfxHTMLParser(); > > public: >- // Lesen der Optionen einer Image-Map >- // <MAP>: TRUE = Image-Map hat einen Namen >- // <AREA>: TRUE = Image-Map hat jetzt einen Bereich mehr >+ // Read the options of an image map >+ // <MAP>: TRUE = Image-Map has a name >+ // <AREA>: TRUE = Image-Map has now one Region more > static BOOL ParseMapOptions(ImageMap * pImageMap, > const HTMLOptions * pOptions ); > BOOL ParseMapOptions(ImageMap * pImageMap) >@@ -83,41 +83,35 @@ public: > const String& aNumStr, SvNumberFormatter& rFormatter ); > > protected: >- >- // Start eines File-Downloads. Dieser erfolgt synchron oder asynchron. >- // Im synchronen Fall befindet sich der Parser nach dem Aufruf im >- // Working-Zustand. Die gelesene Datei kann dann direkt mit >- // FinishFileDownload abgeholt werden. >- // Im asynchronen Fall befindet sich der Parser nach dem Aufruf im >- // Pending-Zustand. Der Parser muss dann ueber das Continue verlassen >- // werden (ohne Reschedule!). Wenn die Datei geladen ist, wird >- // ein Continue mit dem uebergebenen Token aufgerufen. Die Datei kann >- // dann wiederum mit FinishFileDownload abgeholt werden. >- // Zum Abbrechen des Dwonloads sollte eine Shell uebergeben werden. >- // Es kann nur ein einziger Download gleichzeitig existieren. Fuer jeden >- // gestarteten Download muss FinshFileDownload aufgerufen werden. >+ // Start a file download. This is done asynchronously or synchronously. >+ // In the synchronous case, the parser is in the the working state after >+ // it has been called. The read file can then be picked up directly with >+ // FinishFileDownload. In the asynchronous case, the parser is in the >+ // pending state after it hs been called. The parser then has to leave >+ // over the Continue (without Reschedule!). If the file is loaded, >+ // a Continue is called with passed on token. The file can then be picked >+ // up by FinishFileDownload. To cancel the download should a shell be >+ // left. It can only exist a single download at the same time, For every >+ // started download FinshFileDownload must be called. > void StartFileDownload( const String& rURL, int nToken, > SfxObjectShell *pSh=0 ); > >- // Ermittelnd des MIME-Types eines zuvor downloadeten Files. Kann nur >- // unmittelbar vor FinishFileDownload aufgerufen werden, nie aber >- // danach. >- >+ // Detecting the MIME Type of a previously downloaded files. Can be >+ // called immediately before FinishFileDownload, but never afterwards. > BOOL GetFileDownloadMIME( String& rMime ); > >- // Beenden eines asynchronen File-Downloads. Gibt TRUE zurueck, wenn >- // der Download geklappt hat. Das gelesene File befindet sich dann in >- // dem uebergeben String. >+ // End of an asynchronous file download. Returns TRUE if the download >+ // was successful. The read file is then passed into String. > BOOL FinishFileDownload( String& rStr ); > >- // Gibt TRUE zurueck, wenn ein File downloaded wurde und >- // FileDownloadFinished noch nicht gerufen wurde. >+ // Returns TRUE if a file was downloaded and if FileDownloadFinished >+ // has not yet been called > BOOL ShouldFinishFileDownload() const { return pDLMedium != 0; } > > SfxMedium *GetMedium() { return pMedium; } > const SfxMedium *GetMedium() const { return pMedium; } > >- // Default (auch ohne Iterator) ist JavaScript >+ // Default (without iterator) is JavaScript > ScriptType GetScriptType( SvKeyValueIterator* ) const; > const String& GetScriptTypeString( SvKeyValueIterator* ) const; > }; >diff --git a/sfx2/inc/sfx2/sfxsids.hrc b/sfx2/inc/sfx2/sfxsids.hrc >index c823aaa..a5efe13 100644 >--- a/sfx2/inc/sfx2/sfxsids.hrc >+++ b/sfx2/inc/sfx2/sfxsids.hrc >@@ -65,7 +65,7 @@ > #define SID_SETUPPRINTER (SID_SFX_START + 302) > #define SID_EXITANDRETURN (SID_SFX_START + 303) > >-// SID_TITLE steht unter diesem Wert in chaos/cntids.hrc!! >+// SID_TITLE, this value below is given in chaos/cntids.hrc!! > //#define SID_TITLE (SID_SFX_START + 307) > > #define SID_CONTEXT (SID_SFX_START + 310) >@@ -106,7 +106,7 @@ > #define SID_PROGFILENAME (SID_SFX_START + 342) > #define SID_SELECTION (SID_SFX_START + 346) > >-// 360-400 siehe SID_MAIL_... >+// 360-400 see SID_MAIL_... > > // default-ids for help > #define SID_HELPONHELP (SID_SFX_START + 400) >@@ -184,7 +184,7 @@ > #define SID_BROWSER (SID_SFX_START + 1318) > #define SID_MACROEXECMODE (SID_SFX_START + 1319) > >-// die Id steht mit diesem Wert in chaos/cntids.hrc!! >+// The Id value is given in chaos/cntids.hrc!! > //#define SID_INTERNET_ONLINE (SID_SFX_START + 1370) > > #define SID_FILTER_DATA (SID_SFX_START + 1375) >@@ -374,7 +374,7 @@ > #define SID_JSCALL (SID_SFX_START + 1382) > #define SID_AUTOPILOTMENU (SID_SFX_START + 1381) > >-// Floating Window Vorlagen >+// Floating Window Template > #define SID_STYLE_DESIGNER (SID_SFX_START + 539) > > // Organizer >@@ -495,7 +495,7 @@ > #define SID_COPY (SID_SFX_START + 711) > #define SID_PASTE (SID_SFX_START + 712) > >-// steht unter diesem Wert in chaos/cntids.hrc!!! >+// Value below given in chaos/cntids.hrc!!! > //#define SID_DELETE (SID_SFX_START + 713) > > #define SID_BACKSPACE (SID_SFX_START + 714) >@@ -590,7 +590,7 @@ > #define SID_AUTOHIDE (SID_SFX_START + 932) > #define SID_TOGGLENAVBAR (SID_SFX_START + 1603) > >-// Item-Id f"ur die Ereigniszuweisen-Tabpage >+// Item-Id for the assinged event Tabpage > #define SID_ATTR_MACROITEM (SID_SFX_START + 934) > > #define SID_SAVECONFIG (SID_SFX_START + 930) >@@ -839,7 +839,7 @@ > #define SID_SAVEREL_INET (SID_OPTIONS_START + 30) > #define SID_SAVEREL_FSYS (SID_OPTIONS_START + 31) > >-// Automatisches update von Styles - Verwalten-TabPage >+// Automatic update of Styles - manage TabPage > #define SID_ATTR_AUTO_STYLE_UPDATE (SID_OPTIONS_START + 65) > > #define SID_SECURE_URL (SID_OPTIONS_START + 66) >@@ -897,7 +897,7 @@ > #define FID_SVX_START (SID_LIB_START + 500) > #define FID_SEARCH_NOW (FID_SVX_START + 2) > >-// SlotIds f"ur Basic ------------------------------------------------------- >+// SlotIds for Basic ------------------------------------------------------- > #define SID_BASICIDE_TOGGLEBRKPNT ( SID_BASICIDE_START + 0 ) > #define SID_BASICIDE_ADDWATCH ( SID_BASICIDE_START + 1 ) > #define SID_BASICIDE_APPEAR ( SID_BASICIDE_START + 15 ) >@@ -948,7 +948,7 @@ > #define SID_BASICIDE_MANAGE_LANG ( SID_BASICIDE_START + 52 ) > #define SID_BASICIDE_CURRENT_LANG ( SID_BASICIDE_START + 53 ) > >-// SlotIds f"ur Apps -------------------------------------------------------- >+// SlotIds for Apps -------------------------------------------------------- > #define FN_PARAM (SID_SW_START + 1100) > #define FN_PARAM_1 (FN_PARAM+60) > #define FN_PARAM_2 (FN_PARAM+61) >@@ -958,7 +958,7 @@ > #define FN_PARAM_6 (FN_PARAM+65) > #define FN_PARAM_7 (FN_PARAM+66) > #define FN_PARAM_8 (FN_PARAM+67) >-#define FN_FAX (SID_SW_START + 28) /* Faxen */ >+#define FN_FAX (SID_SW_START + 28) /* Fax */ > > #define SID_KEYFUNC_START (SID_SC_START + 521) > #define SID_CURSORDOWN_SEL (SID_KEYFUNC_START + 0) >diff --git a/sfx2/inc/sfx2/shell.hxx b/sfx2/inc/sfx2/shell.hxx >index ab8afd5..91c209a 100644 >--- a/sfx2/inc/sfx2/shell.hxx >+++ b/sfx2/inc/sfx2/shell.hxx >@@ -76,11 +76,10 @@ class SfxBindings; > > enum SfxInterfaceId > >-/* [Beschreibung] >+/* [Description] > >- Id f"ur die <SfxInterface>s, damit wird "uber ein Array an der >- <SfxApplication> ein quasi-statischer Zugriff auf die Interfaces >- erlaubt. >+ Id for <SfxInterface>s, gives a quasi-static access to the interface >+ through an array to <SfxApplication>. > */ > > { >@@ -127,7 +126,7 @@ enum SfxInterfaceId > SFX_INTERFACE_SBA_END = 399, > SFX_INTERFACE_IDE_START = 400, > SFX_INTERFACE_IDE_END = 409, >- //-falls die noch einer braucht >+ //-if one is still needed > SFX_INTERFACE_APP = SFX_INTERFACE_SW_START, > SFX_INTERFACE_LIB = 450 > }; >@@ -142,20 +141,19 @@ typedef void (*SfxStateFunc)(SfxShell *, SfxItemSet &rSet); > > class SFX2_DLLPUBLIC SfxShell: public SfxBroadcaster > >-/* [Beschreibung] >+/* [Description] > >- Die Klasse SfxShell ist Basisklasse f"ur alle Schichten, die >- Funktionalit"at Form von <Slot>s bereitstellen wollen. >- >- Jede Instanz hat einen Verweis auf eine Interface-Beschreibung, der >- mit <SfxShell::GetInterface()const> erh"altlich ist. Dieses Interface >- stellt die Verbindung zu konkreten Methoden her und enth"alt einige >- weitere beschreibende Daten f"ur Controller wie Menus und Toolboxen, aber >- auch f"ur die diversen APIs. Der Hautpteil der Interface-Beschreibung >- liegt in Form einer <Type-Library> vor, die mit dem <SVIDL-Compiler> >- aus einem IDL-File generiert wird. F"ur jede SfxShell-Subclass ist ein >- solches IDL-File zu schreiben. >+ The class SfxShell is the base class for all classes, which provide >+ the functionality of the form <Slot>s. > >+ Each instance has a reference to an interface description, which is >+ obtainable through <SfxShell::GetInterface()const>. This interface >+ provides the connection to specific methods and contains some other >+ descriptive data for controllers like menus and toolboxes, but also >+ for the various APIs. The main part of the interface description is in >+ the form of a <Type-Library>, which is generated from an IDL-file by >+ the <SVIDL-Compiler>. For each SfxShell Subclass-File there is one >+ such IDL-file to write. > */ > > { >@@ -166,8 +164,8 @@ class SFX2_DLLPUBLIC SfxShell: public SfxBroadcaster > SfxUndoManager* pUndoMgr; > > private: >- SfxShell( const SfxShell & ); // n.i. >- SfxShell& operator = ( const SfxShell & ); // n.i. >+ SfxShell( const SfxShell & ); // internal >+ SfxShell& operator = ( const SfxShell & ); // internal > > protected: > SfxShell(); >@@ -264,15 +262,15 @@ public: > //-------------------------------------------------------------------- > SfxItemPool& SfxShell::GetPool() const > /* >- [Beschreibung] >+ [Description] > >- Jede Subclass von SfxShell mu"s einen Pool referenzieren. Dieser >- wird teilweise von SFx-eigenen Subklassen gesetzt (z.B. <SfxViewShell>), >- mu"s aber insbesondere bei direkt von SfxShell abgeleiteten Klassen >- und bei Ableitungen von SfxObjectShell selbst gesetzt werden. >+ Each Subclass of SfxShell must reference a pool. This is partly set by >+ SFx's own set of subclasses (eg <SfxViewShell>). In particular however >+ this must be set directly from one derived SfxShell class and ny >+ derivatives of SfxObjectShell. > >- Die Klasse SfxShell selbst hat noch keinen SfxItemPool, es wird >- daher ein 0-Pointer zur"uckgeliefert. >+ The SfxShell class itself does not have any SfxItemPool, therfore a >+ null-pointer is returned. > */ > > { >@@ -282,17 +280,16 @@ SfxItemPool& SfxShell::GetPool() const > //------------------------------------------------------------------- > inline void SfxShell::SetPool > ( >- SfxItemPool* pNewPool // Pointer auf den neuen Pool oder 0 >+ SfxItemPool* pNewPool // Pointer to the new Pool or null > ) > >-/* [Beschreibung] >+/* [Description] > >- Mit dieser Methode melden die Subklassen ihren speziellen <SfxItemPool> >- an der SfxShell an. Jede SfxShell Instanz mu\s Zugriff auf einen >- SfxItemPool haben. In der Regel ist dies der SfxItemPool der >- SfxDocumentShell. Die SfxShell Subklasse "ubernimmt nicht die >- Eigent"umerschaft "uber den "ubergebenen Pool. Bevor er gel"oscht >- wirde, mu\s er mit SetPool(0) abgemeldet werden. >+ With this method, the subclasses register their special <SfxItemPool> >+ in the SfxShell. Each SfxShell instance must have access to a SfxItemPool. >+ Usually this is the SfxItemPool of the SfxDocumentShell. The SfxShell >+ subclass does not take ownership of the orphaned pool. Before it is >+ deleted it has to be deregisted with SetPool(0). > */ > > { >@@ -352,11 +349,11 @@ inline void SfxShell::SetPool > > #define SFX_POSITION_MASK 0x000F > #define SFX_VISIBILITY_MASK 0xFFF0 >-#define SFX_VISIBILITY_UNVISIBLE 0x0000 // nie sichtbar >+#define SFX_VISIBILITY_UNVISIBLE 0x0000 // Never visible > #define SFX_VISIBILITY_PLUGSERVER 0x0010 > #define SFX_VISIBILITY_PLUGCLIENT 0x0020 > #define SFX_VISIBILITY_VIEWER 0x0040 >- // noch 1 sind frei! >+ // One is still free! > #define SFX_VISIBILITY_RECORDING 0x0200 > #define SFX_VISIBILITY_READONLYDOC 0x0400 > #define SFX_VISIBILITY_DESKTOP 0x0800 >@@ -364,7 +361,7 @@ inline void SfxShell::SetPool > #define SFX_VISIBILITY_FULLSCREEN 0x2000 > #define SFX_VISIBILITY_CLIENT 0x4000 > #define SFX_VISIBILITY_SERVER 0x8000 >-#define SFX_VISIBILITY_NOCONTEXT 0xFFFF // immer sichtbar >+#define SFX_VISIBILITY_NOCONTEXT 0xFFFF // Always visable > > #define SFX_OBJECTBAR_REGISTRATION(nPos,rResId) \ > GetStaticInterface()->RegisterObjectBar( nPos, rResId ) >diff --git a/sfx2/inc/sfx2/tabdlg.hxx b/sfx2/inc/sfx2/tabdlg.hxx >index 8afb111..6a9bed3 100644 >--- a/sfx2/inc/sfx2/tabdlg.hxx >+++ b/sfx2/inc/sfx2/tabdlg.hxx >@@ -58,7 +58,7 @@ class SfxBindings; > #endif /* !ENABLE_LAYOUT_SFX_TABDIALOG*/ > > typedef SfxTabPage* (*CreateTabPage)(Window *pParent, const SfxItemSet &rAttrSet); >-typedef USHORT* (*GetTabPageRanges)(); // liefert internationale Which-Wert >+typedef USHORT* (*GetTabPageRanges)(); // provides international Which-value > struct TabPageImpl; > class SfxUs_Impl; > >@@ -122,9 +122,9 @@ friend class SfxTabDialogController; > > protected: > virtual short Ok(); >- // wird im Sfx gel"oscht! >+ // Is deleted in Sfx! > virtual SfxItemSet* CreateInputItemSet( USHORT nId ); >- // wird *nicht* im Sfx gel"oscht! >+ // Is not deleted in Sfx! > virtual const SfxItemSet* GetRefreshedSet(); > virtual void PageCreated( USHORT nId, SfxTabPage &rPage ); > virtual long Notify( NotifyEvent& rNEvt ); >@@ -152,18 +152,18 @@ public: > > void AddTabPage( USHORT nId, > CreateTabPage pCreateFunc, // != 0 >- GetTabPageRanges pRangesFunc, // darf 0 sein >+ GetTabPageRanges pRangesFunc, // can be 0 > BOOL bItemsOnDemand = FALSE); > void AddTabPage( USHORT nId, > const String &rRiderText, > CreateTabPage pCreateFunc, // != 0 >- GetTabPageRanges pRangesFunc, // darf 0 sein >+ GetTabPageRanges pRangesFunc, // can be 0 > BOOL bItemsOnDemand = FALSE, > USHORT nPos = TAB_APPEND); > void AddTabPage( USHORT nId, > const Bitmap &rRiderBitmap, > CreateTabPage pCreateFunc, // != 0 >- GetTabPageRanges pRangesFunc, // darf 0 sein >+ GetTabPageRanges pRangesFunc, // can be 0 > BOOL bItemsOnDemand = FALSE, > USHORT nPos = TAB_APPEND); > >@@ -185,7 +185,7 @@ public: > { return aTabCtrl.GetCurPageId(); } > void ShowPage( USHORT nId ); > >- // liefert ggf. per Map konvertierte lokale Slots >+ // may provide local slots converted by Map > const USHORT* GetInputRanges( const SfxItemPool& ); > void SetInputSet( const SfxItemSet* pInSet ); > const SfxItemSet* GetOutputItemSet() const { return pOutSet; } >@@ -284,12 +284,11 @@ public: > { bHasExchangeSupport = bNew; } > > enum sfxpg { >- KEEP_PAGE = 0x0000, // Fehlerbehandlung; Seite nicht wechseln >- // 2. F"ullen eines ItemSets f"ur die Aktualilsierung >- // "ubergeordneter Beispiele; dieser Pointer kann immer >- // NULL sein!! >+ KEEP_PAGE = 0x0000, // Error handling; page does not change >+ // 2. Fill an itemset for update >+ // parent examples, this pointer can be NULL all the time! > LEAVE_PAGE = 0x0001, >- // Set aktualisieren und andere Page aktualisieren >+ // Set, refresh and update other Page > REFRESH_SET = 0x0002 > }; > >diff --git a/sfx2/inc/sfx2/tbxctrl.hxx b/sfx2/inc/sfx2/tbxctrl.hxx >index 0c792d0..a189460 100644 >--- a/sfx2/inc/sfx2/tbxctrl.hxx >+++ b/sfx2/inc/sfx2/tbxctrl.hxx >@@ -104,9 +104,9 @@ class SfxFrameStatusListener : public svt::FrameStatusListener > > //------------------------------------------------------------------ > >-/* FloatingWindows, die aus ToolBoxen abgerissen werden k"onnen, sollten >- dieser Klasse abgeleitet werden. Da sie ebenfalls von SfxControllerItem >- abgeleitet ist, erhalten ihre Instanzen auch die StateChanged Aufrufe. >+/* Floating windows that can be torn from tool boxes should be derived from >+ this class. Since it is also derived from SfxControllerItem, its instances >+ will also receive the StateChanged calls. > */ > > class SFX2_DLLPUBLIC SfxPopupWindow: public FloatingWindow, public SfxStatusListenerInterface >@@ -184,14 +184,13 @@ public: > static SfxToolBoxControl* CreateImpl( USHORT nSlotId, USHORT nId, ToolBox &rTbx ); \ > static void RegisterControl(USHORT nSlotId = 0, SfxModule *pMod=NULL) > >-/* F"ur spezielle ToolBox-Controls, z.B. eine Font-Auswahl-Box oder >- aus ToolBoxen abrei"sbare FloatingWindows mu"s passend zur Item-Subclass >- eine Subclass von SfxTooBoxControl implementiert werden. >+/* For special ToolBox controls, such as a font selection box or toolbox >+ tear-off floating windows, an appropriate Item-Subclass of SfxTooBoxControl >+ has to be implemented. > >- Diese Klasse mu"s in SfxApplication::Init() mit der statischen Methode >- RegisterControl() registriert werden. Der SFx erzeugt dann automatisch >- diese Controls in ToolBoxen, wenn die dazugeh"origen Slots von dem >- angegebenen Typ sind. >+ This class has to be registered in SfxApplication:Init() with the static >+ control method RegisterControl(). The SFx then automatically creates these >+ controls in the toolbox, if the associated slots are of the specific type. > */ > > struct SfxToolBoxControl_Impl; >@@ -338,10 +337,10 @@ public: > > class SfxAppToolBoxControl_Impl : public SfxToolBoxControl > >-/* [Beschreibung] >+/* [Description] > >- Interne Hilfsklasse f"ur um das Popup-Menu <AppMenu_Impl> unter Neu >- im SDT zu starten. >+ Internal helper class for the pop-up menu <AppMenu_Impl> under new >+ start in the SDT. > */ > > { >diff --git a/sfx2/inc/sfx2/viewsh.hxx b/sfx2/inc/sfx2/viewsh.hxx >index 441f136..c58538e 100644 >--- a/sfx2/inc/sfx2/viewsh.hxx >+++ b/sfx2/inc/sfx2/viewsh.hxx >@@ -71,7 +71,7 @@ class Dialog; > class Menu; > class NotifyEvent; > >-#define SFX_PRINTER_PRINTER 1 // ohne JOBSETUP => temporaer >+#define SFX_PRINTER_PRINTER 1 // without JOB SETUP => Temporary > #define SFX_PRINTER_JOBSETUP 2 > #define SFX_PRINTER_OPTIONS 4 > #define SFX_PRINTER_CHG_ORIENTATION 8 >@@ -92,7 +92,7 @@ enum SfxScrollingMode > SCROLLING_DEFAULT > }; > >-// "Geeicht" mit www.apple.com und Netscape 3.01 >+// "Verified" using www.apple.com and Netscape 3.01 > #define DEFAULT_MARGIN_WIDTH 8 > #define DEFAULT_MARGIN_HEIGHT 12 > >@@ -100,19 +100,19 @@ enum SfxScrollingMode > > // @[SfxViewShell-Flags] > >-#define SFX_VIEW_HAS_PRINTOPTIONS 0x0010 /* Options-Button und Options- >- Dialog im PrintDialog */ >-#define SFX_VIEW_CAN_PRINT 0x0020 /* enabled Printing ohne Printer >- erzeugen zu m"ussen */ >-#define SFX_VIEW_NO_SHOW 0x0040 /* Window der ViewShell darf nicht >- automatisch geshowed werden */ >-#define SFX_VIEW_NO_NEWWINDOW 0x0100 /* keine weitere View erlauben */ >+#define SFX_VIEW_HAS_PRINTOPTIONS 0x0010 /* Options-Button and Options- >+ Dialog in PrintDialog */ >+#define SFX_VIEW_CAN_PRINT 0x0020 /* Printing enabled without having >+ to create a Printer */ >+#define SFX_VIEW_NO_SHOW 0x0040 /* Window of the ViewShell shall >+ not be showed automatically */ >+#define SFX_VIEW_NO_NEWWINDOW 0x0100 /* Allow N View */ > >-/* [Beschreibung] >+/* [Description] > >- Die SfxViewShell-Flags steuern das Verhalten der SfxViewShell f"ur die >- Dauer ihrer Lebenszeit. Sie werden im Konstruktor der <SfxViewShell> >- angegeben. >+ The SfxViewShell flags control the behavior of SfxViewShell for the >+ duration of its lifetime. They are defined in the constructor of >+ <SfxViewShell>. > */ > > //========================================================================= >@@ -186,7 +186,7 @@ public: > > static SfxViewShell* Get( const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XController>& i_rController ); > >- // Ctoren/Dtoren Initialisierung >+ // Initialize Constructors/Destructors > TYPEINFO(); > SFX_DECL_INTERFACE(SFX_INTERFACE_SFXVIEWSH) > >@@ -208,7 +208,7 @@ public: > virtual void JumpToMark( const String& rMark ); > void VisAreaChanged(const Rectangle& rRect); > >- // Verhaltens-Flags >+ // Behavior Flags > SfxScrollingMode GetScrollingMode() const; > void SetScrollingMode( SfxScrollingMode eMode ); > >@@ -253,7 +253,7 @@ public: > virtual JobSetup GetJobSetup() const; > Printer* GetActivePrinter() const; > >- // Workingset >+ // Working set > virtual void WriteUserData( String&, BOOL bBrowse = FALSE ); > virtual void ReadUserData( const String&, BOOL bBrowse = FALSE ); > virtual void WriteUserDataSequence ( ::com::sun::star::uno::Sequence < ::com::sun::star::beans::PropertyValue >&, sal_Bool bBrowse = sal_False ); >@@ -340,19 +340,18 @@ public: > > inline void SfxViewShell::LostFocus() const > >-/* [Beschreibung] >+/* [Description] > >- Diese Methode mu\s vom Applikationsentwickler gerufen werden, wenn >- das Edit-Window den Focus verloren hat. Der SFx hat so z.B. die >- M"oglichkeit, den Accelerator auszuschalten, damit in bestimmten >- Floating-Windows die Cursor-Tasten, die Delete-Taste etc. funktionieren, >- obwohl sie "uber den Accelerator umdefiniert sind. >+ This method has to be called by the application developer, if the edit >+ window has lost the focus. The SFx has for example the ability to turn off >+ the accelerator, so that the cursor keys, the Delete button, etc. work in >+ certain Floating-Windows, even though they are redefined by the >+ Accelerator. > >+ [Note] > >- [Anmerkung] >- >- <StarView> liefert leider keine M"oglichkeit, solche Events >- 'von der Seite' einzuh"angen. >+ <StarView> unfortunatly does not provide the possibility to define >+ such events 'from the side'. > */ > > { >@@ -362,16 +361,14 @@ inline void SfxViewShell::LostFocus() const > > inline SfxViewFrame* SfxViewShell::GetViewFrame() const > >-/* [Bechreibung] >- >- Diese Methode liefert einen Pointer auf die <SfxViewFrame>-Instanz, >- in der diese SfxViewShell dargestellt wird. Dieses ist die Instanz, >- die imKonstruktor durchgereicht wurde. Es ist gew"ahrleistet, da\s >- der zur"uckgegebene Pointer auf eine g"ultige SfxViewFrame-Instanz >- zeigt. >+/* [Description] > >+ This method returns a pointer to the <SfxViewFrame> Instance in which >+ this SfxViewShell is displayed. This is the instance that was passed >+ on in the constructor. It is guaranteed that the returned pointer >+ points on the valid SfxViewFrame instance. > >- [Querverweise] >+ [Cross-reference] > > <SfxShell::GetFrame()const> > */ >diff --git a/sfx2/sdi/frmslots.sdi b/sfx2/sdi/frmslots.sdi >index e58d95e..80f73a1 100644 >--- a/sfx2/sdi/frmslots.sdi >+++ b/sfx2/sdi/frmslots.sdi >@@ -281,12 +281,12 @@ interface Window > ExecMethod = ExecView_Impl; > ] > >- // Nur f"ur Gestalter: Slot mu\s vorhanden sein >+ // Only for Designers: Slot must be present > SID_STYLE_NEW > [ > ] > >- // Nur f"ur Gestalter: Slot mu\s vorhanden sein >+ // Only for Designers: Slot must be present > SID_STYLE_DRAGHIERARCHIE > [ > ] >@@ -333,7 +333,7 @@ interface BrowseWindow : Window > { > SID_ACTIVATE // ole(no) api(final/play/rec) > [ >- // Implementierung in Subklassen >+ // Implementations in Subclasses > ] > SID_NEWWINDOW // ole(no) api(play/rec) > [ >diff --git a/sfx2/source/appl/app.cxx b/sfx2/source/appl/app.cxx >index fee36d1..854fb1e 100644 >--- a/sfx2/source/appl/app.cxx >+++ b/sfx2/source/appl/app.cxx >@@ -297,15 +297,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 ); >@@ -353,7 +354,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 >@@ -396,16 +397,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()> > */ > >@@ -415,11 +415,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()> > */ > >@@ -431,15 +431,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 e1c43c0..57c30a3 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 5ed3fd4..cb3a0c9 100644 >--- a/sfx2/source/appl/appbas.cxx >+++ b/sfx2/source/appl/appbas.cxx >@@ -150,7 +150,7 @@ BasicManager* SfxApplication::GetBasicManager() > // DBG_ASSERT( pAppData_Impl->nBasicCallLevel != 0, > // "unnecessary call to GetBasicManager() - inefficient!" ); > if ( pAppData_Impl->nBasicCallLevel == 0 ) >- // sicherheitshalber >+ // precaution > EnterBasicCall(); > > return BasicManagerRepository::getApplicationBasicManager( true ); >@@ -196,14 +196,9 @@ void SfxApplication::EnterBasicCall() > { > DBG_TRACE( "SfxShellObject: BASIC-on-demand" ); > >- // das kann l"anger dauern, da Progress nicht geht, wenigstens Sanduhr >-//(mba)/task SfxWaitCursor aWait; >- >- // zuerst das BASIC laden >+ // First load the BASIC > GetBasic(); > >- // Factories anmelden >-// SbxBase::AddFactory( new SfxSbxObjectFactory_Impl ); > } > } > >@@ -352,8 +347,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); >@@ -378,29 +373,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 3d5962e..3234cec 100644 >--- a/sfx2/source/appl/appcfg.cxx >+++ b/sfx2/source/appl/appcfg.cxx >@@ -518,7 +518,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; >@@ -607,14 +607,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"); >@@ -700,16 +700,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; >@@ -823,12 +823,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(); > } > >@@ -837,7 +837,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(); > >@@ -936,7 +936,7 @@ void SfxApplication::SetOptions(const SfxItemSet &rSet) > > //-------------------------------------------------------------------- > >-// alle Dokumente speichern >+// Save all Documents > > BOOL SfxApplication::SaveAll_Impl(BOOL bPrompt, BOOL bAutoSave) > { >@@ -1007,7 +1007,7 @@ SfxEventConfiguration* SfxApplication::GetEventConfig() const > //-------------------------------------------------------------------- > void SfxApplication::NotifyEvent( const SfxEventHint& rEventHint, bool bSynchron ) > { >- //DBG_ASSERT(pAppData_Impl->pEventConfig,"Keine Events angemeldet!"); >+ //DBG_ASSERT(pAppData_Impl->pEventConfig,"No Events registered!"); > > SfxObjectShell *pDoc = rEventHint.GetObjShell(); > if ( pDoc && ( pDoc->IsPreview() || !pDoc->Get_Impl()->bInitialized ) ) >diff --git a/sfx2/source/appl/appchild.cxx b/sfx2/source/appl/appchild.cxx >index af21173..bb8fdf2 100644 >--- a/sfx2/source/appl/appchild.cxx >+++ b/sfx2/source/appl/appchild.cxx >@@ -65,8 +65,6 @@ void SfxApplication::RegisterChildWindow_Impl( SfxModule *pMod, SfxChildWinFacto > if (pFact->nId == (*pAppData_Impl->pFactArr)[nFactory]->nId) > { > pAppData_Impl->pFactArr->Remove( nFactory ); >-// DBG_ERROR("ChildWindow mehrfach registriert!"); >-// return; > } > } > //#endif >@@ -82,7 +80,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 ) > { >@@ -92,7 +90,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; > } >@@ -102,9 +100,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(); >@@ -115,10 +113,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 ); >@@ -138,7 +136,7 @@ void SfxApplication::RegisterChildWindowContext_Impl( SfxModule *pMod, USHORT nI > return; > } > >- DBG_ERROR( "Kein ChildWindow fuer diesen Context!" ); >+ DBG_ERROR( "No ChildWindow for this Context!" ); > } > > //-------------------------------------------------------------------- >diff --git a/sfx2/source/appl/appdde.cxx b/sfx2/source/appl/appdde.cxx >index 34b3d45..d667bc8 100644 >--- a/sfx2/source/appl/appdde.cxx >+++ b/sfx2/source/appl/appdde.cxx >@@ -110,7 +110,7 @@ public: > virtual BOOL StartAdviseLoop(); > virtual BOOL MakeItem( const String& rItem ); > >-// wird benoetigt? >+// Is this still used? > // virtual void Connect( long n ); > // virtual void Disconnect( long n ); > // virtual void StopAdviseLoop(); >@@ -126,15 +126,14 @@ SV_IMPL_PTRARR( SfxDdeDocTopics_Impl, SfxDdeDocTopic_Impl *) > BOOL SfxAppEvent_Impl( ApplicationEvent &rAppEvent, > const String &rCmd, const String &rEvent ) > >-/* [Beschreibung] >+/* [Description] > >- 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. >+ 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" >@@ -149,7 +148,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 ) > { >@@ -173,32 +172,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 ) >@@ -214,18 +212,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. > */ > > { >@@ -236,18 +233,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. > */ > > { >@@ -258,15 +254,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. > */ > > { >@@ -277,21 +273,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 ) > { >@@ -306,18 +301,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. > */ > > { >@@ -328,18 +322,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. > */ > > { >@@ -349,15 +342,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. > */ > > { >@@ -385,19 +378,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. > */ > > { >@@ -411,18 +403,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. > */ > > { >@@ -433,18 +424,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. > */ > > { >@@ -455,15 +445,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. > */ > > { >@@ -475,7 +465,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(); >@@ -483,10 +473,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( >@@ -511,20 +501,19 @@ 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 ) > { > // JP 18.03.96 - Bug 26470 >- // 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; >@@ -543,8 +532,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; > >@@ -571,14 +560,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(); >@@ -588,7 +577,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; >@@ -604,9 +593,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); > >@@ -715,7 +702,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 db271db..5e203c5 100644 >--- a/sfx2/source/appl/appinit.cxx >+++ b/sfx2/source/appl/appinit.cxx >@@ -257,8 +257,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 85874f8..fdd89a3 100644 >--- a/sfx2/source/appl/appmain.cxx >+++ b/sfx2/source/appl/appmain.cxx >@@ -100,18 +100,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()> > */ >@@ -122,7 +123,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 >@@ -137,17 +138,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*[])> > */ > >@@ -164,14 +165,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 f834558..99d6c77 100644 >--- a/sfx2/source/appl/appmisc.cxx >+++ b/sfx2/source/appl/appmisc.cxx >@@ -193,13 +193,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> >@@ -217,7 +216,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 ); >@@ -233,7 +232,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 ) >@@ -253,21 +252,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; > } > >@@ -283,9 +281,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 87e6703..4cdd6ea 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 ); >@@ -288,19 +287,18 @@ private: > > sal_uInt32 CheckPasswd_Impl > ( >- //Window *pWin, // Parent des Dialogs >+ //Window *pWin, // Parent of thr Dialogs > 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; >@@ -464,8 +462,6 @@ ULONG SfxApplication::LoadTemplate( SfxObjectShellLock& xDoc, const String &rFil > > xDoc->GetStorage()->copyToStorage( xTempStorage ); > >-//REMOVE // the following operations should be done in one step >-//REMOVE xDoc->DoHandsOff(); > if ( !xDoc->DoSaveCompleted( new SfxMedium( xTempStorage, String() ) ) ) > throw uno::RuntimeException(); > } >@@ -549,7 +545,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); >@@ -557,7 +553,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 ) > { >@@ -793,8 +789,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 0b22773..cff626d 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 ); > >@@ -127,8 +127,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 >@@ -142,7 +142,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 e8e426b..58aec1b 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 68c45e3..961d0e1 100644 >--- a/sfx2/source/appl/appserv.cxx >+++ b/sfx2/source/appl/appserv.cxx >@@ -245,7 +245,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; > } >@@ -412,13 +412,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 >@@ -427,7 +426,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; >@@ -440,13 +439,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 >@@ -455,7 +453,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; >@@ -648,7 +646,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 )); > >@@ -682,7 +680,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) >@@ -1385,7 +1383,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 c1a89ef..ad74114 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; >@@ -394,15 +394,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(); >@@ -414,7 +414,7 @@ void SfxChildWindow::InitializeChildWinFactory_Impl( sal_uInt16 nId, SfxChildWin > //aWinOpt.GetPosition( rInfo.aPos.X(), rInfo.aPos.Y() ); > //aWinOpt.GetSize( rInfo.aSize.Width(), rInfo.aSize.Height() ); > >- // 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 ); >@@ -423,7 +423,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; >@@ -452,7 +452,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; > >@@ -484,7 +484,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; > >@@ -509,7 +509,7 @@ void SfxChildWindow::CreateContext( sal_uInt16 nContextId, SfxBindings& rBinding > > if ( !pCon ) > { >- DBG_ERROR( "Kein geeigneter Context gefunden!" ); >+ DBG_ERROR( "No suitable context found! "); > return; > } > >@@ -544,7 +544,7 @@ FloatingWindow* SfxChildWindowContext::GetFloatingWindow() const > } > else > { >- DBG_ERROR("Kein FloatingWindow-Context!"); >+ DBG_ERROR("No FloatingWindow-Context!"); > return NULL; > } > } >@@ -618,7 +618,7 @@ sal_Bool SfxChildWinInfo::GetExtraData_Impl > sal_uInt16 *pPos > ) const > { >- // ung"ultig? >+ // invalid? > if ( !aExtraString.Len() ) > return sal_False; > String aStr; >@@ -626,8 +626,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); >@@ -636,20 +636,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; >@@ -657,10 +657,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; >@@ -704,8 +704,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 a09999a..2f14239 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,20 +127,16 @@ BOOL SvFileObject::GetData( ::com::sun::star::uno::Any & rData, > { > Graphic aGrf; > >- //JP 15.07.98: Bug 52959 >- // 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; >-//!!?? bNativFormat = 0 != (ASPECT_ICON & pSvData->GetAspect()); >+ //!!?? bNativFormat = 0 != (ASPECT_ICON & pSvData->GetAspect()); > >- // 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(); > >@@ -156,13 +152,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() ); >@@ -208,7 +201,7 @@ BOOL SvFileObject::GetData( ::com::sun::star::uno::Any & rData, > > bNativFormat = bOldNativFormat; > >- // alles fertig? >+ // Everything ready? > if( xMed.Is() && !bSynchron && bClearMedium ) > { > xMed.Clear(); >@@ -225,16 +218,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() ) >@@ -272,19 +261,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(); >@@ -308,7 +296,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; > } > >@@ -318,7 +306,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; >@@ -336,7 +324,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() ); >@@ -372,7 +360,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(); > } > } >@@ -386,14 +374,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() ); > } > } >@@ -460,7 +448,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); >@@ -519,19 +507,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(); > } > >@@ -564,7 +551,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; > >@@ -575,13 +562,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; >@@ -597,7 +582,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; >@@ -606,8 +591,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 ); > } > >@@ -641,14 +625,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 > { >@@ -681,10 +665,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 622a125..57f5ba9 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 f2c9d1b..df8ceca 100644 >--- a/sfx2/source/appl/impldde.cxx >+++ b/sfx2/source/appl/impldde.cxx >@@ -152,7 +152,7 @@ BOOL SvDDEObject::GetData( ::com::sun::star::uno::Any & rData /*out param*/, > if( !pConnection ) > return FALSE; > >- if( pConnection->GetError() ) // dann versuchen wir es nochmal >+ if( pConnection->GetError() ) // then we try once more > { > String sServer( pConnection->GetServiceName() ); > String sTopic( pConnection->GetTopicName() ); >@@ -163,13 +163,13 @@ BOOL SvDDEObject::GetData( ::com::sun::star::uno::Any & rData /*out param*/, > nError = DDELINK_ERROR_APP; > } > >- if( bWaitForData ) // wir sind rekursiv drin, wieder raus >+ if( bWaitForData ) // we are in an rekursive loop, get out again > return FALSE; > >- // Verriegeln gegen Reentrance >+ // Lock against Reentrance > bWaitForData = TRUE; > >- // falls gedruckt werden soll, warten wir bis die Daten vorhanden sind >+ // if you want to print, we'll wait until the data is available > if( bSynchron ) > { > DdeRequest aReq( *pConnection, sItem, 5000 ); >@@ -189,7 +189,7 @@ BOOL SvDDEObject::GetData( ::com::sun::star::uno::Any & rData /*out param*/, > } > else > { >- // ansonsten wird es asynchron ausgefuehrt >+ // otherwise it will be executed asynchronously > // if( !pLink || !pLink->IsBusy() ) > { > if( pRequest ) >@@ -216,9 +216,9 @@ BOOL SvDDEObject::Connect( SvBaseLink * pSvLink ) > static BOOL bInWinExec = FALSE; > #endif > USHORT nLinkType = pSvLink->GetUpdateMode(); >- if( pConnection ) // Verbindung steht ja schon >+ if( pConnection ) // Connection is already made > { >- // tja, dann nur noch als Abhaengig eintragen >+ // well, then just add it as dependent > AddDataAdvise( pSvLink, > SotExchange::GetFormatMimeType( pSvLink->GetContentType()), > LINKUPDATE_ONCALL == nLinkType >@@ -241,8 +241,8 @@ 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" ) ) > { > BOOL bSysTopic; >@@ -256,12 +256,12 @@ BOOL SvDDEObject::Connect( SvBaseLink * pSvLink ) > nError = DDELINK_ERROR_DATA; > return FALSE; > } >- // ansonsten unter Win/WinNT die Applikation direkt starten >+ // otherwise in Win/WinNT, start the Application directly > } > > #if defined(WIN) || defined(WNT) > >- // Server nicht da, starten und nochmal versuchen >+ // Server not up, try once more to start it. > if( !bInWinExec ) > { > ByteString aCmdLine( sServer, RTL_TEXTENCODING_ASCII_US ); >@@ -300,7 +300,7 @@ BOOL SvDDEObject::Connect( SvBaseLink * pSvLink ) > > if( LINKUPDATE_ALWAYS == nLinkType && !pLink && !pConnection->GetError() ) > { >- // Hot Link einrichten, Daten kommen irgendwann spaeter >+ // Setting up Hot Link, Data will be available at some point later on > pLink = new DdeHotLink( *pConnection, sItem ); > pLink->SetDataHdl( LINK( this, SvDDEObject, ImplGetDDEData ) ); > pLink->SetDoneHdl( LINK( this, SvDDEObject, ImplDoneDDEData ) ); >@@ -353,22 +353,22 @@ BOOL SvDDEObject::ImplHasOtherFormat( DdeTransaction& rReq ) > nFmt = FORMAT_GDIMETAFILE; > break; > >- // sonst noch irgendwas ?? >+ // something else? > } > if( nFmt ) >- rReq.SetFormat( nFmt ); // damit nochmal versuchen >+ rReq.SetFormat( nFmt ); // try it once more > return 0 != nFmt; > } > > BOOL SvDDEObject::IsPending() const >-/* [Beschreibung] >- >- 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 >+/* [Description] >+ >+ The method determines whether the data-object can be read from a DDE. >+ >+ Returned is the following: >+ ERRCODE_NONE if it has been completely read >+ ERRCODE_SO_PENDING if it has not been completely read >+ ERRCODE_SO_FALSE otherwise > */ > { > return bWaitForData; >@@ -398,8 +398,8 @@ IMPL_LINK( SvDDEObject, ImplGetDDEData, DdeData*, pData ) > Sequence< sal_Int8 > aSeq( (const sal_Int8*)p, nLen ); > if( pGetData ) > { >- *pGetData <<= aSeq; // Daten kopieren >- pGetData = 0; // und den Pointer bei mir zuruecksetzen >+ *pGetData <<= aSeq; // Copy Data >+ pGetData = 0; // reset the pointer here > } > else > { >@@ -422,9 +422,9 @@ IMPL_LINK( SvDDEObject, ImplDoneDDEData, void*, pData ) > { > DdeTransaction* pReq = 0; > if( !pLink || ( pLink && pLink->IsBusy() )) >- pReq = pRequest; // dann kann nur der fertig sein >+ pReq = pRequest; // only the one that is ready > else if( pRequest && pRequest->IsBusy() ) >- pReq = pLink; // dann kann nur der fertig sein >+ pReq = pLink; // only the one that is ready > > if( pReq ) > { >@@ -434,13 +434,12 @@ IMPL_LINK( SvDDEObject, ImplDoneDDEData, void*, pData ) > } > else if( pReq == pRequest ) > { >- // das wars dann > bWaitForData = FALSE; > } > } > } > else >- // das warten ist beendet >+ // End waiting > bWaitForData = FALSE; > > return 0; >diff --git a/sfx2/source/appl/impldde.hxx b/sfx2/source/appl/impldde.hxx >index ca7c3ad..d9171f8 100644 >--- a/sfx2/source/appl/impldde.hxx >+++ b/sfx2/source/appl/impldde.hxx >@@ -49,8 +49,8 @@ class SvDDEObject : public SvLinkSource > DdeRequest* pRequest; > ::com::sun::star::uno::Any * pGetData; > >- BYTE bWaitForData : 1; // wird auf Daten gewartet? >- BYTE nError : 7; // Error Code fuer den Dialog >+ BYTE bWaitForData : 1; // waiting for data? >+ BYTE nError : 7; // Error code for dialogue > > > BOOL ImplHasOtherFormat( DdeTransaction& ); >diff --git a/sfx2/source/appl/linkmgr2.cxx b/sfx2/source/appl/linkmgr2.cxx >index 8cc84ae..6530659 100644 >--- a/sfx2/source/appl/linkmgr2.cxx >+++ b/sfx2/source/appl/linkmgr2.cxx >@@ -119,15 +119,11 @@ void LinkManager::CloseCachedComps() > maCachedComps.clear(); > } > >-/************************************************************************ >-|* LinkManager::Remove() >-|* >-|* Beschreibung >-*************************************************************************/ >+//-------------------------------------------------------------------------- > > void LinkManager::Remove( SvBaseLink *pLink ) > { >- // keine Links doppelt einfuegen >+ // No duplicate links inserted > int bFound = FALSE; > SvBaseLinkRef** ppRef = (SvBaseLinkRef**)aLinkTbl.GetData(); > for( USHORT n = aLinkTbl.Count(); n; --n, ++ppRef ) >@@ -140,7 +136,7 @@ void LinkManager::Remove( SvBaseLink *pLink ) > bFound = TRUE; > } > >- // falls noch leere rum stehen sollten, weg damit >+ // Remove emty ones if they exist > if( !(*ppRef)->Is() ) > { > delete *ppRef; >@@ -177,7 +173,7 @@ void LinkManager::Remove( USHORT nPos, USHORT nCnt ) > > BOOL LinkManager::Insert( SvBaseLink* pLink ) > { >- // keine Links doppelt einfuegen >+ // No duplicate links inserted > for( USHORT n = 0; n < aLinkTbl.Count(); ++n ) > { > SvBaseLinkRef* pTmp = aLinkTbl[ n ]; >@@ -200,7 +196,7 @@ BOOL LinkManager::InsertLink( SvBaseLink * pLink, > USHORT nUpdateMode, > const String* pName ) > { >- // unbedingt zuerst >+ // This First > pLink->SetObjType( nObjType ); > if( pName ) > pLink->SetName( *pName ); >@@ -239,7 +235,7 @@ BOOL LinkManager::InsertDDELink( SvBaseLink * pLink ) > } > > >-// erfrage die Strings fuer den Dialog >+// Obtain the string for the dialog > BOOL LinkManager::GetDisplayNames( const SvBaseLink * pLink, > String* pType, > String* pFile, >@@ -312,8 +308,8 @@ void LinkManager::UpdateAllLinks( > SvStringsDtor aApps, aTopics, aItems; > String sApp, sTopic, sItem; > >- // erstmal eine Kopie vom Array machen, damit sich updatende Links in >- // Links in ... nicht dazwischen funken!! >+ // First make a copy of the array in order to update links >+ // links in ... no contact between them! > SvPtrarr aTmpArr( 255, 50 ); > USHORT n; > for( n = 0; n < aLinkTbl.Count(); ++n ) >@@ -331,7 +327,7 @@ void LinkManager::UpdateAllLinks( > { > SvBaseLink* pLink = (SvBaseLink*)aTmpArr[ n ]; > >- // suche erstmal im Array nach dem Eintrag >+ // search first in the array after the entry > USHORT nFndPos = USHRT_MAX; > for( USHORT i = 0; i < aLinkTbl.Count(); ++i ) > if( pLink == *aLinkTbl[ i ] ) >@@ -341,9 +337,9 @@ void LinkManager::UpdateAllLinks( > } > > if( USHRT_MAX == nFndPos ) >- continue; // war noch nicht vorhanden! >+ continue; // was not available! > >- // Graphic-Links noch nicht updaten >+ // Graphic-Links not to update yet > if( !pLink->IsVisible() || > ( !bUpdateGrfLinks && OBJECT_CLIENT_GRF == pLink->GetObjType() )) > continue; >@@ -352,8 +348,8 @@ void LinkManager::UpdateAllLinks( > { > int nRet = QueryBox( pParentWin, WB_YES_NO | WB_DEF_YES, SfxResId( STR_QUERY_UPDATE_LINKS ) ).Execute(); > if( RET_YES != nRet ) >- return ; // es soll nichts geupdatet werden >- bAskUpdate = FALSE; // einmal reicht >+ return ; // nothing should be updated >+ bAskUpdate = FALSE; // once is enough > } > > pLink->Update(); >@@ -361,11 +357,7 @@ void LinkManager::UpdateAllLinks( > CloseCachedComps(); > } > >-/************************************************************************ >-|* SvBaseLink::CreateObject() >-|* >-|* Beschreibung >-*************************************************************************/ >+//-------------------------------------------------------------------------- > > SvLinkSourceRef LinkManager::CreateObj( SvBaseLink * pLink ) > { >@@ -386,7 +378,7 @@ SvLinkSourceRef LinkManager::CreateObj( SvBaseLink * pLink ) > > BOOL LinkManager::InsertServer( SvLinkSource* pObj ) > { >- // keine doppelt einfuegen >+ // no duplicate inserts > if( !pObj || USHRT_MAX != aServerTbl.GetPos( pObj ) ) > return FALSE; > >@@ -493,8 +485,8 @@ BOOL LinkManager::InsertFileLink( sfx2::SvBaseLink& rLink ) > return FALSE; > } > >-// eine Uebertragung wird abgebrochen, also alle DownloadMedien canceln >-// (ist zur Zeit nur fuer die FileLinks interressant!) >+// A transfer is aborted, so cancel all download media >+// (for now this is only of interest for the file links!) > void LinkManager::CancelTransfers() > { > SvFileObject* pFileObj; >@@ -509,23 +501,22 @@ void LinkManager::CancelTransfers() > // CastAndAddRef( pLnk->GetObj() )) ) > pFileObj->CancelTransfers(); > } >- >- // um Status Informationen aus dem FileObject an den BaseLink zu >- // senden, gibt es eine eigene ClipBoardId. Das SvData-Object hat >- // dann die entsprechenden Informationen als String. >- // Wird zur Zeit fuer FileObject in Verbindung mit JavaScript benoetigt >- // - das braucht Informationen ueber Load/Abort/Error >+ // For the purpose of sending Status information from the file object to >+ // the base link, there exist a dedicated ClipBoardId. The SvData-object >+ // gets the appropriate information as a string >+ // For now this is required for file object in conjunction with JavaScript >+ // - needs information about Load/Abort/Error > ULONG LinkManager::RegisterStatusInfoId() > { > static ULONG nFormat = 0; > > if( !nFormat ) > { >-// wie sieht die neue Schnittstelle aus? >+// what is the new interface? > // nFormat = Exchange::RegisterFormatName( "StatusInfo vom SvxInternalLink" ); > nFormat = SotExchange::RegisterFormatName( > String::CreateFromAscii( RTL_CONSTASCII_STRINGPARAM( >- "StatusInfo vom SvxInternalLink" ))); >+ "StatusInfo from SvxInternalLink" ))); > } > return nFormat; > } >@@ -594,9 +585,8 @@ BOOL SvxInternalLink::Connect( sfx2::SvBaseLink* pLink ) > LinkManager* pLinkMgr = pLink->GetLinkManager(); > if (pLinkMgr && pLinkMgr->GetDisplayNames(pLink, 0, &sTopic, &sItem) && sTopic.Len()) > { >- // erstmal nur ueber die DocumentShells laufen und die mit dem >- // Namen heraussuchen: >- >+ // first only loop over the DocumentShells the shells and find those >+ // with the name: > com::sun::star::lang::Locale aLocale; > MsLangId::convertLanguageToLocale( LANGUAGE_SYSTEM, aLocale ); > CharClass aCC( aLocale ); >@@ -635,7 +625,7 @@ BOOL SvxInternalLink::Connect( sfx2::SvBaseLink* pLink ) > > > aCC.toLower( sTmp ); >- if( sTmp == sNmURL ) // die wollen wir haben >+ if( sTmp == sNmURL ) // we want these > { > pFndShell = pShell; > break; >@@ -675,7 +665,7 @@ BOOL SvxInternalLink::Connect( sfx2::SvBaseLink* pLink ) > } > else > { >- // dann versuche die Datei zu laden: >+ // then try to download the file: > INetURLObject aURL( sTopic ); > INetProtocol eOld = aURL.GetProtocol(); > aURL.SetURL( sTopic = lcl_DDE_RelToAbs( sTopic, sReferer ) ); >diff --git a/sfx2/source/appl/linksrc.cxx b/sfx2/source/appl/linksrc.cxx >index dddd468..4384db4 100644 >--- a/sfx2/source/appl/linksrc.cxx >+++ b/sfx2/source/appl/linksrc.cxx >@@ -61,7 +61,7 @@ SvLinkSourceTimer::SvLinkSourceTimer( SvLinkSource * pOwn ) > > void SvLinkSourceTimer::Timeout() > { >- // sicher gegen zerstoeren im Handler >+ // Secure against beeing destroyed in Handler > SvLinkSourceRef aAdv( pOwner ); > pOwner->SendDataChanged(); > } >@@ -275,7 +275,7 @@ void SvLinkSource::SendDataChanged() > void SvLinkSource::NotifyDataChanged() > { > if( pImpl->nTimeout ) >- StartTimer( &pImpl->pTimer, this, pImpl->nTimeout ); // Timeout neu >+ StartTimer( &pImpl->pTimer, this, pImpl->nTimeout ); // New timeout > else > { > SvLinkSource_EntryIter_Impl aIter( pImpl->aArr ); >@@ -314,10 +314,10 @@ void SvLinkSource::DataChanged( const String & rMimeType, > const ::com::sun::star::uno::Any & rVal ) > { > if( pImpl->nTimeout && !rVal.hasValue() ) >- { // nur wenn keine Daten mitgegeben wurden >+ { // only when no data was included > // fire all data to the sink, independent of the requested format > pImpl->aDataMimeType = rMimeType; >- StartTimer( &pImpl->pTimer, this, pImpl->nTimeout ); // Timeout neu >+ StartTimer( &pImpl->pTimer, this, pImpl->nTimeout ); // New timeout > } > else > { >diff --git a/sfx2/source/appl/lnkbase2.cxx b/sfx2/source/appl/lnkbase2.cxx >index 7c51a05..6f4e727 100644 >--- a/sfx2/source/appl/lnkbase2.cxx >+++ b/sfx2/source/appl/lnkbase2.cxx >@@ -14,7 +14,7 @@ > * only, as published by the Free Software Foundation. > * > * OpenOffice.org is distributed in the hope that it will be useful, >- * but WITHOUT ANY WARRANTY; without even the implied warranty of >+zd * but WITHOUT ANY WARRANTY; without even the implied warranty of > * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the > * GNU Lesser General Public License version 3 for more details > * (a copy is included in the LICENSE file that accompanied this code). >@@ -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> >@@ -73,16 +72,16 @@ struct BaseLink_Impl > { delete m_pFileDlg; } > }; > >-// nur fuer die interne Verwaltung >+// only for internal management > struct ImplBaseLinkData > { > struct tClientType > { >- // gilt fuer alle Links >+ // applies for all links > ULONG nCntntType; // Update Format >- // nicht Ole-Links >- BOOL bIntrnlLnk; // ist es ein interner Link >- USHORT nUpdateMode;// UpdateMode >+ // Not Ole-Links >+ BOOL bIntrnlLnk; // It is an internal link >+ USHORT nUpdateMode; // UpdateMode > }; > > struct tDDEType >@@ -131,12 +130,7 @@ public: > BOOL IsInDTOR() const { return bIsInDTOR; } > }; > >- >-/************************************************************************ >-|* SvBaseLink::SvBaseLink() >-|* >-|* Beschreibung >-*************************************************************************/ >+//-------------------------------------------------------------------------- > > SvBaseLink::SvBaseLink() > { >@@ -147,11 +141,7 @@ SvBaseLink::SvBaseLink() > bWasLastEditOK = FALSE; > } > >-/************************************************************************ >-|* SvBaseLink::SvBaseLink() >-|* >-|* Beschreibung >-*************************************************************************/ >+//-------------------------------------------------------------------------- > > SvBaseLink::SvBaseLink( USHORT nUpdateMode, ULONG nContentType ) > { >@@ -161,17 +151,13 @@ SvBaseLink::SvBaseLink( USHORT nUpdateMode, ULONG nContentType ) > bVisible = bSynchron = bUseCache = TRUE; > bWasLastEditOK = FALSE; > >- // falls es ein Ole-Link wird, >+ // It it going to be a Ole-Link, > pImplData->ClientType.nUpdateMode = nUpdateMode; > pImplData->ClientType.nCntntType = nContentType; > pImplData->ClientType.bIntrnlLnk = FALSE; > } > >-/************************************************************************ >-|* SvBaseLink::SvBaseLink() >-|* >-|* Beschreibung >-*************************************************************************/ >+//-------------------------------------------------------------------------- > > SvBaseLink::SvBaseLink( const String& rLinkName, USHORT nObjectType, SvLinkSource* pObj ) > { >@@ -183,7 +169,7 @@ SvBaseLink::SvBaseLink( const String& rLinkName, USHORT nObjectType, SvLinkSourc > > if( !pObj ) > { >- DBG_ASSERT( pObj, "Wo ist mein zu linkendes Object" ); >+ DBG_ASSERT( pObj, "Where is my left-most object" ); > return; > } > >@@ -193,15 +179,14 @@ SvBaseLink::SvBaseLink( const String& rLinkName, USHORT nObjectType, SvLinkSourc > DdeTopic* pTopic = FindTopic( aLinkName, &nItemStt ); > if( pTopic ) > { >- // dann haben wir alles zusammen >- // MM hat gefummelt ??? >- // MM_TODO wie kriege ich den Namen >+ // then we have it all together >+ // MM_TODO how do I get the name > String aStr = aLinkName; // xLinkName->GetDisplayName(); > aStr = aStr.Copy( nItemStt ); > pImplData->DDEType.pItem = new ImplDdeItem( *this, aStr ); > pTopic->InsertItem( pImplData->DDEType.pItem ); > >- // dann koennen wir uns auch das Advise merken >+ // store the Advise > xObj = pObj; > } > } >@@ -209,11 +194,7 @@ SvBaseLink::SvBaseLink( const String& rLinkName, USHORT nObjectType, SvLinkSourc > xObj = pObj; > } > >-/************************************************************************ >-|* SvBaseLink::~SvBaseLink() >-|* >-|* Beschreibung >-*************************************************************************/ >+//-------------------------------------------------------------------------- > > SvBaseLink::~SvBaseLink() > { >@@ -243,11 +224,7 @@ IMPL_LINK( SvBaseLink, EndEditHdl, String*, _pNewName ) > return 0; > } > >-/************************************************************************ >-|* SvBaseLink::SetObjType() >-|* >-|* Beschreibung >-*************************************************************************/ >+//-------------------------------------------------------------------------- > > void SvBaseLink::SetObjType( USHORT nObjTypeP ) > { >@@ -257,33 +234,21 @@ void SvBaseLink::SetObjType( USHORT nObjTypeP ) > nObjType = nObjTypeP; > } > >-/************************************************************************ >-|* SvBaseLink::SetName() >-|* >-|* Beschreibung >-*************************************************************************/ >+//-------------------------------------------------------------------------- > > void SvBaseLink::SetName( const String & rNm ) > { > aLinkName = rNm; > } > >-/************************************************************************ >-|* SvBaseLink::GetName() >-|* >-|* Beschreibung >-*************************************************************************/ >+//-------------------------------------------------------------------------- > > String SvBaseLink::GetName() const > { > return aLinkName; > } > >-/************************************************************************ >-|* SvBaseLink::SetObj() >-|* >-|* Beschreibung >-*************************************************************************/ >+//-------------------------------------------------------------------------- > > void SvBaseLink::SetObj( SvLinkSource * pObj ) > { >@@ -294,45 +259,32 @@ void SvBaseLink::SetObj( SvLinkSource * pObj ) > xObj = pObj; > } > >-/************************************************************************ >-|* SvBaseLink::SetLinkSourceName() >-|* >-|* Beschreibung >-*************************************************************************/ >+//-------------------------------------------------------------------------- > > void SvBaseLink::SetLinkSourceName( const String & rLnkNm ) > { > if( aLinkName == rLnkNm ) > return; > >- AddNextRef(); // sollte ueberfluessig sein >- // Alte Verbindung weg >+ AddNextRef(); // should be superfluous >+ // remove old connection > Disconnect(); > > aLinkName = rLnkNm; > >- // Neu verbinden >+ // New Connection > _GetRealObject(); >- ReleaseRef(); // sollte ueberfluessig sein >+ ReleaseRef(); // should be superfluous > } > >-/************************************************************************ >-|* SvBaseLink::GetLinkSourceName() >-|* >-|* Beschreibung >-*************************************************************************/ >+//-------------------------------------------------------------------------- > > String SvBaseLink::GetLinkSourceName() const > { > return aLinkName; > } > >- >-/************************************************************************ >-|* SvBaseLink::SetUpdateMode() >-|* >-|* Beschreibung >-*************************************************************************/ >+//-------------------------------------------------------------------------- > > void SvBaseLink::SetUpdateMode( USHORT nMode ) > { >@@ -378,8 +330,6 @@ BOOL SvBaseLink::Update() > if( xObj->GetData( aData, sMimeType ) ) > { > DataChanged( sMimeType, aData ); >- //JP 13.07.00: Bug 76817 - for manual Updates there is no >- // need to hold the ServerObject > if( OBJECT_CLIENT_DDE == nObjType && > LINKUPDATE_ONCALL == GetUpdateMode() && xObj.Is() ) > xObj->RemoveAllDataAdvise( this ); >@@ -387,11 +337,11 @@ BOOL SvBaseLink::Update() > } > if( xObj.Is() ) > { >- // sollten wir asynschron sein? >+ // should be asynschron? > if( xObj->IsPending() ) > return TRUE; > >- // dann brauchen wir das Object auch nicht mehr >+ // we do not need the object anymore > AddNextRef(); > Disconnect(); > ReleaseRef(); >@@ -421,14 +371,14 @@ void SvBaseLink::_GetRealObject( BOOL bConnect) > { > String sServer; > if( pImpl->m_pLinkMgr->GetDisplayNames( this, &sServer ) && >- sServer == GetpApp()->GetAppName() ) // interner Link !!! >+ sServer == GetpApp()->GetAppName() ) // internal Link !!! > { >- // damit der Internal - Link erzeugt werden kann !!! >+ // so that the Internal link can be created! > nObjType = OBJECT_INTERN; > xObj = pImpl->m_pLinkMgr->CreateObj( this ); > > pImplData->ClientType.bIntrnlLnk = TRUE; >- nObjType = OBJECT_CLIENT_DDE; // damit wir wissen was es mal war !! >+ nObjType = OBJECT_CLIENT_DDE; // so we know what it once was! > } > else > { >@@ -448,7 +398,7 @@ ULONG SvBaseLink::GetContentType() const > if( OBJECT_CLIENT_SO & nObjType ) > return pImplData->ClientType.nCntntType; > >- return 0; // alle Formate ? >+ return 0; // all Formats ? > } > > >@@ -578,7 +528,6 @@ bool SvBaseLink::ExecuteEdit( const String& _rNewName ) > void SvBaseLink::Closed() > { > if( xObj.Is() ) >- // beim Advise Abmelden > xObj->RemoveAllDataAdvise( this ); > } > >@@ -593,8 +542,7 @@ FileDialogHelper* SvBaseLink::GetFileDialog( sal_uInt32 nFlags, const String& rF > ImplDdeItem::~ImplDdeItem() > { > bIsInDTOR = TRUE; >- // damit im Disconnect nicht jemand auf die Idee kommt, den Pointer zu >- // loeschen!! >+ // So that no-one gets the idea to delete the pointer when Disconnecting! > SvBaseLinkRef aRef( pLink ); > aRef->Disconnect(); > } >@@ -603,7 +551,7 @@ DdeData* ImplDdeItem::Get( ULONG nFormat ) > { > if( pLink->GetObj() ) > { >- // ist das noch gueltig? >+ // is it still valid? > if( bIsValidData && nFormat == aData.GetFormat() ) > return &aData; > >@@ -635,12 +583,12 @@ BOOL ImplDdeItem::Put( const DdeData* ) > > void ImplDdeItem::AdviseLoop( BOOL bOpen ) > { >- // Verbindung wird geschlossen, also Link abmelden >+ // Connection is closed, so also unsubscribe link > if( pLink->GetObj() ) > { > if( bOpen ) > { >- // es wird wieder eine Verbindung hergestellt >+ // A connection is re-established > if( OBJECT_DDE_EXTERN == pLink->GetObjType() ) > { > pLink->GetObj()->AddDataAdvise( pLink, String::CreateFromAscii( "text/plain;charset=utf-16" ), ADVISEMODE_NODATA ); >@@ -649,8 +597,8 @@ void ImplDdeItem::AdviseLoop( BOOL bOpen ) > } > else > { >- // damit im Disconnect nicht jemand auf die Idee kommt, >- // den Pointer zu loeschen!! >+ // So that no-one gets the idea to delete the pointer >+ // when Disconnecting! > SvBaseLinkRef aRef( pLink ); > aRef->Disconnect(); > } >@@ -672,7 +620,7 @@ static DdeTopic* FindTopic( const String & rLinkName, USHORT* pItemStt ) > pService = rSvc.Next() ) > if( pService->GetName() == sService ) > { >- // dann suchen wir uns das Topic >+ // then we search for the Topic > String sTopic( sNm.GetToken( 0, cTokenSeperator, nTokenPos ) ); > if( pItemStt ) > *pItemStt = nTokenPos; >@@ -686,10 +634,10 @@ static DdeTopic* FindTopic( const String & rLinkName, USHORT* pItemStt ) > if( pTopic->GetName() == sTopic ) > return pTopic; > >- // Topic nicht gefunden ? >- // dann versuchen wir ihn mal anzulegen >+ // Topic not found? >+ // then we try once to create it > if( i || !pService->MakeTopic( sTopic ) ) >- break; // hat nicht geklappt, also raus >+ break; // did not work, exiting > } > break; > } >diff --git a/sfx2/source/appl/makefile.mk b/sfx2/source/appl/makefile.mk >index a583102..42e5364 100644 >--- a/sfx2/source/appl/makefile.mk >+++ b/sfx2/source/appl/makefile.mk >@@ -37,7 +37,7 @@ LIBTARGET=NO > .INCLUDE : settings.mk > .INCLUDE : $(PRJ)$/util$/makefile.pmk > >-# w.g. compilerbugs >+# due to compilerbugs > .IF "$(GUI)"=="WNT" > .IF "$(COM)"!="GCC" > CFLAGS+=-Od >diff --git a/sfx2/source/appl/module.cxx b/sfx2/source/appl/module.cxx >index ef3f934..df11f9b 100644 >--- a/sfx2/source/appl/module.cxx >+++ b/sfx2/source/appl/module.cxx >@@ -167,7 +167,8 @@ SfxModule::~SfxModule() > { > if ( SFX_APP()->Get_Impl() ) > { >- // Das Modul wird noch vor dem DeInitialize zerst"ort, also auis dem Array entfernen >+ // The module will be destroyed before the Deinitialize, >+ // so remove from the array > SfxModuleArr_Impl& rArr = GetModules_Impl(); > for( USHORT nPos = rArr.Count(); nPos--; ) > { >@@ -196,7 +197,7 @@ SfxSlotPool* SfxModule::GetSlotPool() const > > void SfxModule::RegisterChildWindow(SfxChildWinFactory *pFact) > { >- DBG_ASSERT( pImpl, "Kein echtes Modul!" ); >+ DBG_ASSERT( pImpl, "No real Module!" ); > > if (!pImpl->pFactArr) > pImpl->pFactArr = new SfxChildWinFactArr_Impl; >@@ -206,7 +207,7 @@ void SfxModule::RegisterChildWindow(SfxChildWinFactory *pFact) > if (pFact->nId == (*pImpl->pFactArr)[nFactory]->nId) > { > pImpl->pFactArr->Remove( nFactory ); >- DBG_ERROR("ChildWindow mehrfach registriert!"); >+ DBG_ERROR("ChildWindow registered multiple times!"); > return; > } > } >@@ -220,7 +221,7 @@ void SfxModule::RegisterChildWindow(SfxChildWinFactory *pFact) > void SfxModule::RegisterChildWindowContext( USHORT nId, > SfxChildWinContextFactory *pFact) > { >- DBG_ASSERT( pImpl, "Kein echtes Modul!" ); >+ DBG_ASSERT( pImpl, "No real Module!" ); > > USHORT nCount = pImpl->pFactArr->Count(); > for (USHORT nFactory=0; nFactory<nCount; ++nFactory) >@@ -235,7 +236,7 @@ void SfxModule::RegisterChildWindowContext( USHORT nId, > } > } > >- DBG_ERROR( "Kein ChildWindow fuer diesen Context!" ); >+ DBG_ERROR( "No ChildWindow for this Context!" ); > } > > //------------------------------------------------------------------------- >@@ -252,7 +253,7 @@ void SfxModule::RegisterToolBoxControl( SfxTbxCtrlFactory *pFact ) > if ( pF->nTypeId && pF->nTypeId == pFact->nTypeId && > (pF->nSlotId == pFact->nSlotId || pF->nSlotId == 0) ) > { >- DBG_WARNING("TbxController-Registrierung ist nicht eindeutig!"); >+ DBG_WARNING("TbxController-Registering is not clearly defined!"); > } > } > #endif >@@ -274,7 +275,7 @@ void SfxModule::RegisterStatusBarControl( SfxStbCtrlFactory *pFact ) > if ( pF->nTypeId && pF->nTypeId == pFact->nTypeId && > (pF->nSlotId == pFact->nSlotId || pF->nSlotId == 0) ) > { >- DBG_WARNING("StbController-Registrierung ist nicht eindeutig!"); >+ DBG_WARNING("TbxController-Registering is not clearly defined!"); > } > } > #endif >@@ -296,7 +297,7 @@ void SfxModule::RegisterMenuControl( SfxMenuCtrlFactory *pFact ) > if ( pF->nTypeId && pF->nTypeId == pFact->nTypeId && > (pF->nSlotId == pFact->nSlotId || pF->nSlotId == 0) ) > { >- DBG_WARNING("MenuController-Registrierung ist nicht eindeutig!"); >+ DBG_WARNING("MenuController-Registering is not clearly defined!"); > } > } > #endif >diff --git a/sfx2/source/appl/sfxdll.cxx b/sfx2/source/appl/sfxdll.cxx >index 653995d..0064118 100644 >--- a/sfx2/source/appl/sfxdll.cxx >+++ b/sfx2/source/appl/sfxdll.cxx >@@ -32,7 +32,7 @@ > #ifdef WIN > #include <svwin.h> > >-// Statische DLL-Verwaltungs-Variablen >+// Static DLL Administrative variables > static HINSTANCE hDLLInst = 0; > > //========================================================================== >diff --git a/sfx2/source/appl/sfxpicklist.cxx b/sfx2/source/appl/sfxpicklist.cxx >index 2181285..f4bc141 100644 >--- a/sfx2/source/appl/sfxpicklist.cxx >+++ b/sfx2/source/appl/sfxpicklist.cxx >@@ -220,7 +220,7 @@ void SfxPickList::CreatePickListEntries() > { > RemovePickListEntries(); > >- // Einlesen der Pickliste >+ // Reading the pick list > Sequence< Sequence< PropertyValue > > seqPicklist = SvtHistoryOptions().GetList( ePICKLIST ); > > sal_uInt32 nCount = seqPicklist.getLength(); >@@ -357,7 +357,7 @@ void SfxPickList::Notify( SfxBroadcaster&, const SfxHint& rHint ) > if ( rHint.IsA( TYPE( SfxEventHint ))) > { > SfxEventHint* pEventHint = PTR_CAST(SfxEventHint,&rHint); >- // nur ObjectShell-bezogene Events mit Medium interessieren >+ // only ObjectShell-related events with media interest > SfxObjectShell* pDocSh = pEventHint->GetObjShell(); > if( !pDocSh ) > return; >@@ -393,12 +393,12 @@ void SfxPickList::Notify( SfxBroadcaster&, const SfxHint& rHint ) > if( !pMed ) > return; > >- // unbenannt-Docs und embedded-Docs nicht in History >+ // Unnamed Documents and embedded-Documents not in History > if ( !pDocSh->HasName() || > SFX_CREATE_MODE_STANDARD != pDocSh->GetCreateMode() ) > return; > >- // Hilfe nicht in History >+ // Help not in History > INetURLObject aURL( pDocSh->IsDocShared() ? pDocSh->GetSharedFileURL() : ::rtl::OUString( pMed->GetOrigURL() ) ); > if ( aURL.GetProtocol() == INET_PROT_VND_SUN_STAR_HELP ) > return; >@@ -424,12 +424,12 @@ void SfxPickList::Notify( SfxBroadcaster&, const SfxHint& rHint ) > if( !pMed ) > return; > >- // unbenannt-Docs und embedded-Docs nicht in Pickliste >+ // Unnamed Documents and embedded-Documents not im Pickliste > if ( !pDocSh->HasName() || > SFX_CREATE_MODE_STANDARD != pDocSh->GetCreateMode() ) > return; > >- // Hilfe nicht in History >+ // Help not in History > INetURLObject aURL( pDocSh->IsDocShared() ? pDocSh->GetSharedFileURL() : ::rtl::OUString( pMed->GetOrigURL() ) ); > if ( aURL.GetProtocol() == INET_PROT_VND_SUN_STAR_HELP ) > return; >diff --git a/sfx2/source/appl/shutdownicon.cxx b/sfx2/source/appl/shutdownicon.cxx >index 47839f8..4d3b3f9 100644 >--- a/sfx2/source/appl/shutdownicon.cxx >+++ b/sfx2/source/appl/shutdownicon.cxx >@@ -416,7 +416,7 @@ IMPL_STATIC_LINK( ShutdownIcon, DialogClosedHdl_Impl, FileDialogHelper*, EMPTYAR > { > DBG_ASSERT( pThis->m_pFileDlg, "ShutdownIcon, DialogClosedHdl_Impl(): no file dialog" ); > >- // use ctor for filling up filters automatically! #89169# >+ // use constructor for filling up filters automatically! #89169# > if ( ERRCODE_NONE == pThis->m_pFileDlg->GetError() ) > { > Reference< XFilePicker > xPicker = pThis->m_pFileDlg->GetFilePicker(); >diff --git a/sfx2/source/appl/workwin.cxx b/sfx2/source/appl/workwin.cxx >index d979fdf..aa63ad6 100644 >--- a/sfx2/source/appl/workwin.cxx >+++ b/sfx2/source/appl/workwin.cxx >@@ -146,11 +146,11 @@ DBG_NAME(SfxWorkWindow) > //SV_IMPL_OBJARR( SfxObjectBarArr_Impl, SfxObjectBar_Impl ); > > //==================================================================== >-// Sortiert die Children nach ihrem Alignment >-// Reihenfolge entspricht der im enum SfxChildAlignment (->CHILDWIN.HXX). >+// Sort the Children according their alignment >+// The order corresponds to the enum SfxChildAlignment (->CHILDWIN.HXX). > // > >-// Hilfe, um die "Anderungen am Alignment kompatibal zu machen! >+// Help to make changes to the alignment compatible! > > > SFX_IMPL_XINTERFACE_3( LayoutManagerListener, OWeakObject, ::com::sun::star::frame::XLayoutManagerListener, ::com::sun::star::lang::XEventListener, ::com::sun::star::lang::XComponent ) >@@ -537,7 +537,7 @@ void SfxWorkWindow::Sort_Impl() > > > //==================================================================== >-// ctor f"ur workwin eines Frames >+// constructor for workwin of a Frame > > SfxFrameWorkWin_Impl::SfxFrameWorkWin_Impl( Window *pWin, SfxFrame *pFrm, SfxFrame* pMaster ) > : SfxWorkWindow( >@@ -555,11 +555,11 @@ SfxFrameWorkWin_Impl::SfxFrameWorkWin_Impl( Window *pWin, SfxFrame *pFrm, SfxFra > bInternalDockingAllowed = sal_True; > } > >- // Die ben"otigten SplitWindows (je eins f"ur jede Seite) werden erzeugt >+ // The required split windows (one for each side) can be created > for ( USHORT n=0; n<SFX_SPLITWINDOWS_MAX; n++ ) > { >- // Die SplitWindows sind direkte ChildWindows des WorkWindows und enthalten >- // die angedockten Fenster. >+ // The SplitWindows excludes direct ChildWindows of the WorkWindows >+ // and receives the docked window. > > SfxChildAlignment eAlign = > ( n == SFX_SPLITWINDOWS_LEFT ? SFX_ALIGN_LEFT : >@@ -576,7 +576,7 @@ SfxFrameWorkWin_Impl::SfxFrameWorkWin_Impl( Window *pWin, SfxFrame *pFrm, SfxFra > } > > //==================================================================== >-// ctor der Basisklasse >+// Constructor of the base class > > SfxWorkWindow::SfxWorkWindow( Window *pWin, SfxBindings& rB, SfxWorkWindow* pParentWorkwin ) : > pParent( pParentWorkwin ), >@@ -599,15 +599,15 @@ 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 ); > > pChildWins = new SfxChildWindows_Impl; > pChilds = new SfxChildList_Impl; > >- // F"ur die ObjectBars wird ein fester Platz in der ChildList reserviert, >- // damit sie immer in einer definierten Reihenfolge kommen. >+ // For the ObjectBars a integral place in the Childlist is reserved, >+ // so that they always come in a defined order. > SfxChild_Impl* pChild=0; > for (USHORT n=0; n < SFX_OBJECTBAR_MAX; ++n) > pChilds->Insert(0,pChild); >@@ -622,13 +622,13 @@ SfxWorkWindow::SfxWorkWindow( Window *pWin, SfxBindings& rB, SfxWorkWindow* pPar > } > > //==================================================================== >-// dtor >+// Destructor > > SfxWorkWindow::~SfxWorkWindow() > { > DBG_DTOR(SfxWorkWindow, 0); > >- // SplitWindows l"oschen >+ // Delete SplitWindows > for ( USHORT n=0; n<SFX_SPLITWINDOWS_MAX; n++ ) > { > SfxSplitWindow *p = pSplit[n]; >@@ -637,8 +637,8 @@ SfxWorkWindow::~SfxWorkWindow() > delete p; > } > >- // Hilfsstruktur f"ur Child-Windows l"oschen >- DBG_ASSERT( pChilds->Count() == 0, "dangling childs" ); >+ // Delete help structure for Child-Windows >+ DBG_ASSERT( pChilds->Count() == 0, "dangling children" ); > delete pChilds; > delete pChildWins; > >@@ -702,17 +702,17 @@ void SfxWorkWindow::SaveStatus_Impl() > } > > //-------------------------------------------------------------------- >-// Hilfsmethode zum Freigeben der Childlisten. Wenn danach nicht der dtor >-// aufgerufen wird, sondern weiter gearbeitet wird, mu\s wie im ctor von >-// SfxWorkWindow noch Platz f"ur die Objectbars und SplitWindows reserviert >-// werden. >+// Helper method to release the child lists. Should the destructor not be >+// called after this, instead work continues, then space for the object bars >+// and split windows has to be reserved in the same way as in the constructor >+// of SfxWorkWindow. > > void SfxWorkWindow::DeleteControllers_Impl() > { > DBG_CHKTHIS(SfxWorkWindow, 0); > >- // SplitWindows locken (d.h. Resize-Reaktion an den >- // DockingWindows unterdr"ucken) >+ // Lock SplitWindows (which means supressing the Resize-Reaction of the >+ // DockingWindows) > USHORT n; > for ( n=0; n<SFX_SPLITWINDOWS_MAX; n++ ) > { >@@ -721,7 +721,7 @@ void SfxWorkWindow::DeleteControllers_Impl() > p->Lock(); > } > >- // Child-Windows l"oschen >+ // Delete Child-Windows > for ( n=0; n<pChildWins->Count(); ) > { > SfxChildWin_Impl* pCW = (*pChildWins)[n]; >@@ -737,10 +737,10 @@ void SfxWorkWindow::DeleteControllers_Impl() > */ > pChild->Hide(); > >- // Wenn das ChildWindow ein direktes Childfenster ist und nicht >- // in einem SplitWindow liegt, am WorkWindow abmelden. >- // Nach TH ist eine Abmeldung am Splitwindow nicht erforderlich, >- // wenn dieses auch gleich mit zerst"ort wird (s.u.). >+ // If the child window is a direct child window and not in a >+ // SplitWindow, cancel it at the workwindow. >+ // After TH a cancellation on the SplitWindow is not necessary >+ // since this window is also destroyed (see below). > if (pCW->pCli) > ReleaseChild_Impl(*pChild->GetWindow()); > pCW->pWin = 0; >@@ -780,21 +780,22 @@ void SfxWorkWindow::DeleteControllers_Impl() > { > xLayoutManager->reset(); > >- // StatusBar l"oschen >+ // Delete StatusBar > ResetStatusBar_Impl(); > >- // ObjectBars l"oschen( zuletzt, damit pChilds nicht tote Pointer enh"alt ) >+ // Delete ObjectBars (this is done last, so that pChilds does not >+ // receive dead Pointers) > for ( USHORT i = 0; i < aObjBarList.size(); i++ ) > { >- // Nicht jede Position mu\s belegt sein >+ // Not every position must be occupied > USHORT nId = aObjBarList[i].nId; > if ( nId ) > aObjBarList[i].nId = 0; > } > } > >- // ObjectBars werden alle auf einmal released, da sie einen >- // festen zusammenh"angenden Bereich im Array pChilds belegen >+ // ObjectBars are all released at once, since they occupy a >+ // fixed contiguous area in the array pChild > pChilds->Remove(0, SFX_OBJECTBAR_MAX); > bSorted = FALSE; > >@@ -802,7 +803,7 @@ void SfxWorkWindow::DeleteControllers_Impl() > } > > //==================================================================== >-// Virtuelle Methode zum Anordnen der Childfenster. >+// Virtual method for placing the child window. > > void SfxWorkWindow::ArrangeChilds_Impl( BOOL /*bForce*/) > { >@@ -832,16 +833,14 @@ void SfxFrameWorkWin_Impl::ArrangeChilds_Impl( BOOL bForce ) > if ( IsVisible_Impl() ) > aBorder = Arrange_Impl(); > } >- >- // Wenn das aktuelle Dokument der Applikation einen IPClient enth"alt, mu\s >- // dem dazugeh"origen Objekt durch SetTopToolFramePixel der zur Verf"ugung >- // stehende Platz zugeteilt werden. Das Objekt zeigt dann seine UITools an >- // und setzt den App-Border(->SfxInPlaceEnv_Impl::ArrangeChilds_Impl()). >- // Anderenfalls wird hier direkt der AppBorder gesetzt, um evtl. den Border >- // zu "uberschreiben, den bisher ein Objekt aus einem anderen Dokument >- // gesetzt hatte. >- // Das Objekt setzt, wenn es seine UI-Tools wegnimmt, den SetAppBorder nicht, >- // damit kein ObjectBar-Zappeln entsteht. >+ // If the current application document contains a IPClient, then the >+ // object through SetTopToolFramePixel has to be assigned the available >+ // space. The object will then point to its UITools and sets the app border >+ // (-> SfxInPlaceEnv_Impl:: ArrangeChilds_Impl ()). Otherwise the >+ // app border is set here directly to possibly overwrite the Border that >+ // was set by an object from another document. The object does not set >+ // the SetAppBorder when it removes its UI tools so that no-dithering >+ // ObjectBar arises. > // (->SfxInPlaceEnv_Impl::ArrangeChilds_Impl()) > > pMasterFrame->SetToolSpaceBorderPixel_Impl( aBorder ); >@@ -853,13 +852,12 @@ void SfxFrameWorkWin_Impl::ArrangeChilds_Impl( BOOL bForce ) > > SvBorder SfxWorkWindow::Arrange_Impl() > >-/* [Beschreibung] >- >- Diese Methode ordnet alle sichtbaren ChildFenster so an, da\s die angedockten >- Fenster nach der Sorierreihenfolge von au\sen nach innen aneinander >- gesetzt werden. Wenn ein an sich sichtbares Fenster nicht mehr in die >- noch freie ClientArea pa\st, wird es auf "nicht sichtbar" gesetzt. >+/* [Description] > >+ This method organizes all visible child windows so that the docked window >+ sorted in order from the outside to the inside are placed after one >+ another. If a visible window does not fit anymore into the free >+ ClientArea, it is set to "not visible". > */ > { > DBG_CHKTHIS(SfxWorkWindow, 0); >@@ -884,10 +882,10 @@ SvBorder SfxWorkWindow::Arrange_Impl() > if ( !pCli->pWin ) > continue; > >- // Zun"achst nehmen wir an, da\s das Fenster Platz hat >+ // First, we assume that there is room for the window. > pCli->nVisible |= CHILD_FITS_IN; > >- // Nicht sichtbare Fenster "uberspringen >+ // Skip invisiable windows > if (pCli->nVisible != CHILD_VISIBLE) > continue; > >@@ -1004,7 +1002,7 @@ SvBorder SfxWorkWindow::Arrange_Impl() > } > > //-------------------------------------------------------------------- >-// Close-Handler: die Konfiguration der ChildWindows wird gespeichert. >+// Close-Handler: The Configuration of the ChildWindows is saved. > // > > void SfxWorkWindow::Close_Impl() >@@ -1042,7 +1040,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" ); > >@@ -1291,11 +1289,10 @@ void SfxWorkWindow::SetObjectBar_Impl( USHORT nPos, sal_uInt32 nResId, > > bool SfxWorkWindow::KnowsObjectBar_Impl( USHORT nPos ) const > >-/* [Beschreibung] >+/* [Description] > >- Stellt fest, ob an der betreffenden Position "uberhaupt eine >- Objektleiste zur Verf"ugung stehen w"urde. Ist unabh"agig davon, >- ob diese tats"achlich ein- oder ausgeschaltet ist. >+ Determines if a object list is available at the position in question. >+ This is independent for the fact whether it is actually turned on or off. > */ > > { >@@ -1440,8 +1437,8 @@ sal_Bool SfxWorkWindow::IsPluginMode( SfxObjectShell* pObjShell ) > > void SfxWorkWindow::UpdateObjectBars_Impl() > { >- // SplitWindows locken (d.h. Resize-Reaktion an den >- // DockingWindows unterdr"ucken) >+ // Lock SplitWindows (which means supressing the Resize-Reaction of the >+ // DockingWindows) > USHORT n; > for ( n=0; n<SFX_SPLITWINDOWS_MAX; n++ ) > { >@@ -1450,7 +1447,7 @@ void SfxWorkWindow::UpdateObjectBars_Impl() > p->Lock(); > } > >- // was man so "ofters braucht, merkt man sich (spart Code und Laufzeit) >+ // you realize what is needed often (saves Code and execution time) > SFX_APP(); > > Reference< com::sun::star::beans::XPropertySet > xPropSet( GetFrameInterface(), UNO_QUERY ); >@@ -1475,21 +1472,21 @@ void SfxWorkWindow::UpdateObjectBars_Impl() > bPluginMode = IsPluginMode( pFrame->GetObjectShell() ); > } > >- // "uber alle Toolboxen iterieren >+ // Iterate over all Toolboxes > xLayoutManager->lock(); > for ( n = 0; n < aObjBarList.size(); ++n ) > { > USHORT nId = aObjBarList[n].nId; > sal_Bool bDestroy = aObjBarList[n].bDestroy; > >- // die Modi bestimmen, f"ur die die ToolBox gilt >+ // Determine the vaild mode for the ToolBox > USHORT nTbxMode = aObjBarList[n].nMode; > bool bFullScreenTbx = SFX_VISIBILITY_FULLSCREEN == > ( nTbxMode & SFX_VISIBILITY_FULLSCREEN ); > nTbxMode &= ~SFX_VISIBILITY_FULLSCREEN; > nTbxMode &= ~SFX_VISIBILITY_VIEWER; > >- // wird in diesem Kontext eine ToolBox gefordert? >+ // Is a ToolBox required in this context ? > bool bModesMatching = ( nUpdateMode && ( nTbxMode & nUpdateMode) == nUpdateMode ); > if ( bDestroy ) > { >@@ -1513,7 +1510,7 @@ void SfxWorkWindow::UpdateObjectBars_Impl() > } > else if ( nId != 0 ) > { >- // ggf. Toolbox an dieser Position l"oschen >+ // Delete the Toolbox at this Position if possible > rtl::OUString aTbxId( m_aTbxTypeName ); > aTbxId += GetResourceURLFromResId( aObjBarList[n].nId ); > xLayoutManager->destroyElement( aTbxId ); >@@ -1527,7 +1524,7 @@ void SfxWorkWindow::UpdateObjectBars_Impl() > > UpdateChildWindows_Impl(); > >- // SplitWindows wieder ent-locken >+ // Unlock the SplitWindows again > for ( n=0; n<SFX_SPLITWINDOWS_MAX; n++ ) > { > SfxSplitWindow *p = pSplit[n]; >@@ -1548,7 +1545,7 @@ bool SfxWorkWindow::AllowChildWindowCreation_Impl( const SfxChildWin_Impl& i_rCW > > void SfxWorkWindow::UpdateChildWindows_Impl() > { >- // alle vorhandenen oder in den Kontext gekommenen ChildWindows >+ // any current or in the context available Childwindows > for ( USHORT n=0; n<pChildWins->Count(); n++ ) > { > SfxChildWin_Impl *pCW = (*pChildWins)[n]; >@@ -1556,8 +1553,8 @@ void SfxWorkWindow::UpdateChildWindows_Impl() > BOOL bCreate = FALSE; > if ( pCW->nId && !pCW->bDisabled && (pCW->aInfo.nFlags & SFX_CHILDWIN_ALWAYSAVAILABLE || IsVisible_Impl( pCW->nVisibility ) ) ) > { >- // Im Kontext ist ein geeignetes ChildWindow erlaubt; >- // ist es auch eingeschaltet ? >+ // In the context is an appropriate ChildWindow allowed; >+ // it is also turned on? > if ( pChildWin == NULL && pCW->bCreate ) > { > // Internal docking is only used for embedding into another >@@ -1571,7 +1568,7 @@ void SfxWorkWindow::UpdateChildWindows_Impl() > } > else if ( !IsDockingAllowed() || bIsFullScreen ) // || !bInternalDocking ) > { >- // im PresentationMode oder FullScreen nur FloatingWindows >+ // In Presentation mode or FullScreen only FloatingWindows > SfxChildAlignment eAlign; > if ( pCW->aInfo.GetExtraData_Impl( &eAlign ) ) > bCreate = ( eAlign == SFX_ALIGN_NOALIGNMENT ); >@@ -1582,8 +1579,8 @@ void SfxWorkWindow::UpdateChildWindows_Impl() > if ( bCreate ) > bCreate = AllowChildWindowCreation_Impl( *pCW ); > >- // Momentan kein Fenster da, aber es ist eingeschaltet; Fenster >- // und ggf. Context erzeugen >+ // Currently, no window here, but it is enabled; windows >+ // Create window and if possible theContext > if ( bCreate ) > CreateChildWin_Impl( pCW, FALSE ); > >@@ -1595,23 +1592,23 @@ void SfxWorkWindow::UpdateChildWindows_Impl() > } > else if ( pChildWin ) > { >- // Fenster existiert schon; soll es auch sichtbar sein ? >+ // Window already exists, it should also be visible? > if ( ( !bIsFullScreen || pChildWin->GetAlignment() == SFX_ALIGN_NOALIGNMENT ) && bAllChildsVisible ) > { >- // Updatemode ist kompatibel; auf jeden Fall wieder einschalten >+ // Update Mode is compatible; definitely enable it > bCreate = AllowChildWindowCreation_Impl( *pCW ); > if ( bCreate ) > { > if ( pCW->pCli ) > { >- // Fenster ist direktes Child >+ // The window is a direct Child > if ( bAllChildsVisible && ( (IsDockingAllowed() && bInternalDockingAllowed) || pCW->pCli->eAlign == SFX_ALIGN_NOALIGNMENT ) ) > pCW->pCli->nVisible |= CHILD_NOT_HIDDEN; > } > else > { > if ( pCW->bCreate && IsDockingAllowed() && bInternalDockingAllowed ) >- // Fenster liegt in einem SplitWindow >+ // The window ia within a SplitWindow > ((SfxDockingWindow*)pChildWin->GetWindow())->Reappear_Impl(); > } > >@@ -1651,16 +1648,18 @@ void SfxWorkWindow::CreateChildWin_Impl( SfxChildWin_Impl *pCW, BOOL bSetFocus ) > if ( bSetFocus ) > bSetFocus = pChildWin->WantsFocus(); > pChildWin->SetWorkWindow_Impl( this ); >- // Zumindest der ExtraString wird beim Auswerten ver"andert, also neu holen >+ >+ // At least the extra string is changed during the evaluation, >+ // also get it anewed > SfxChildWinInfo aInfo = pChildWin->GetInfo(); > pCW->aInfo.aExtraString = aInfo.aExtraString; > pCW->aInfo.bVisible = aInfo.bVisible; > pCW->aInfo.nFlags |= aInfo.nFlags; > >- // Nein !! Sonst kann man keine Fenster defaultmaessig ausschalten ( Partwindow! ) >+ // No! Otherwise, you could have disable any window stored (Partwindow!) > // pCW->aInfo.bVisible = TRUE; > >- // Erzeugung war erfolgreich >+ // The creation was successful > GetBindings().Invalidate(pCW->nId); > > USHORT nPos = pChildWin->GetPosition(); >@@ -1670,7 +1669,7 @@ void SfxWorkWindow::CreateChildWin_Impl( SfxChildWin_Impl *pCW, BOOL bSetFocus ) > if ((*pChilds)[TbxMatch(nPos)])// && > // pChildWin->GetAlignment() == (*pChilds)[nPos]->eAlign ) > { >- // ChildWindow ersetzt ObjectBar >+ // ChildWindow replaces ObjectBar > (*pChilds)[TbxMatch(nPos)]->nVisible ^= CHILD_NOT_HIDDEN; > } > } >@@ -1682,9 +1681,8 @@ void SfxWorkWindow::CreateChildWin_Impl( SfxChildWin_Impl *pCW, BOOL bSetFocus ) > > if ( pChildWin->GetAlignment() == SFX_ALIGN_NOALIGNMENT || pChildWin->GetWindow()->GetParent() == pWorkWin) > { >- // Das Fenster ist entweder nicht angedockt oder au\serhalb >- // eines SplitWindows angedockt und mu\s daher explizit als >- // Child registriert werden >+ // The window is not docked or docked outside of one split windows >+ // and must therefore be registered explicitly as a Child > pCW->pCli = RegisterChild_Impl(*(pChildWin->GetWindow()), pChildWin->GetAlignment(), pChildWin->CanGetFocus()); > pCW->pCli->nVisible = CHILD_VISIBLE; > if ( pChildWin->GetAlignment() != SFX_ALIGN_NOALIGNMENT && bIsFullScreen ) >@@ -1693,17 +1691,15 @@ void SfxWorkWindow::CreateChildWin_Impl( SfxChildWin_Impl *pCW, BOOL bSetFocus ) > } > else > { >- // Ein angedocktes Fenster, dessen Parent nicht das WorkWindow ist, >- // mu\s in einem SplitWindow liegen und daher nicht explizit >- // registriert werden. >- // Das passiert aber schon bei der Initialisierung des >- // SfxDockingWindows! >+ // A docked window which parent is not a WorkingWindow, must lie >+ // in a SplitWindow and thus not be explicitly registered. >+ // This happens already in the initialization of SfxDockingWindows! > } > > if ( pCW->nInterfaceId != pChildWin->GetContextId() ) > pChildWin->CreateContext( pCW->nInterfaceId, GetBindings() ); > >- // Information in der INI-Datei sichern >+ // Save the information in the INI file > SaveStatus_Impl(pChildWin, pCW->aInfo); > } > } >@@ -1713,24 +1709,24 @@ void SfxWorkWindow::RemoveChildWin_Impl( SfxChildWin_Impl *pCW ) > USHORT nId = pCW->nSaveId; > SfxChildWindow *pChildWin = pCW->pWin; > >- // vorhandenes Fenster geht aus dem Kontext und wird daher entfernt >+ // existing window goes out of the context and is therefore removed > USHORT nPos = pChildWin->GetPosition(); > if (nPos != CHILDWIN_NOPOS) > { > /* >- // ChildWindow "uberlagert einen ObjectBar >+ // ChildWindow overloads a ObjectBar > DBG_ASSERT(nPos < SFX_OBJECTBAR_MAX, "Illegal objectbar position!"); > if ((*pChilds)[TbxMatch(nPos)] && > (aObjBars[nPos].nMode & nUpdateMode) ) //&& > // pChildWin->GetAlignment() == (*pChilds)[nPos]->eAlign ) > { >- // ObjectBar war "uberlagert; jetzt wieder anzeigen >+ // ObjectBar was overloaded; now display it again > (*pChilds)[TbxMatch(nPos)]->nVisible ^= CHILD_NOT_HIDDEN; > } > */ > } > >- // Information in der INI-Datei sichern >+ // Save the information in the INI file > USHORT nFlags = pCW->aInfo.nFlags; > pCW->aInfo = pChildWin->GetInfo(); > pCW->aInfo.nFlags |= nFlags; >@@ -1740,15 +1736,15 @@ void SfxWorkWindow::RemoveChildWin_Impl( SfxChildWin_Impl *pCW ) > > if ( pCW->pCli ) > { >- // ChildWindow ist ein direktes ChildWindow und mu\s sich daher >- // beim WorkWindow abmelden >+ // Child window is a direct child window and must therefore unregister >+ // itself from the WorkWindow > pCW->pCli = 0; > ReleaseChild_Impl(*pChildWin->GetWindow()); > } > else > { >- // ChildWindow liegt in einem SplitWindow und meldet sich >- // selbst im dtor dort ab >+ // ChildWindow is within a SplitWindow and unregister itself in >+ // the destructor. > } > > pWorkWin->GetSystemWindow()->GetTaskPaneList()->RemoveWindow( pChildWin->GetWindow() ); >@@ -1790,7 +1786,8 @@ void SfxWorkWindow::SetTempStatusBar_Impl( BOOL bSet ) > aStatBar.bTemp = bSet; > if ( !bOn || bReset || (!bSet && aStatBar.nId ) ) > { >- // Nur was tun, wenn die Temp-Einstellung wirklich was bewirkt >+ // Just do something if the temp settings really are causing >+ // anything > UpdateStatusBar_Impl(); > ArrangeChilds_Impl(); > ShowChilds_Impl(); >@@ -1809,21 +1806,20 @@ void SfxWorkWindow::UpdateStatusBar_Impl() > Any aValue = xPropSet->getPropertyValue( m_aLayoutManagerPropName ); > aValue >>= xLayoutManager; > >- // keine Statusleiste, wenn keine Id gew"unscht oder bei FullScreenView >- // oder wenn ausgeschaltet >+ // No status bar, if no ID is required or when in FullScreenView or >+ // if disabled > if ( aStatBar.nId && IsDockingAllowed() && bInternalDockingAllowed && bShowStatusBar && > ( (aStatBar.bOn && !bIsFullScreen) || aStatBar.bTemp ) ) > { >- // Id hat sich ge"andert, also passenden Statusbarmanager erzeugen, >- // dieser "ubernimmt die aktuelle Statusleiste; >+ // Id has changed, thus create a suitable Statusbarmanager, this takes >+ // over the current status bar; > if ( xLayoutManager.is() ) > xLayoutManager->requestElement( m_aStatusBarResName ); > } > else > { >- // Aktuelle StatusBar vernichten >- // Der Manager erzeugt die Statusleiste nur, er zerst"ort sie >- // nicht ! >+ // Destroy the current StatusBar >+ // The Manager only creates the Status bar, does not destroy it. > if ( xLayoutManager.is() ) > xLayoutManager->destroyElement( m_aStatusBarResName ); > } >@@ -1995,8 +1991,8 @@ void SfxWorkWindow::ConfigChild_Impl(SfxChildIdentifier eChild, > Rectangle aInnerRect( aOuterRect ); > BOOL bTbx = (eChild == SFX_CHILDWIN_OBJECTBAR); > >- // Das gerade betroffene Fenster wird bei der Berechnung des >- // inneren Rechtecks mit eingeschlossen! >+ // The current affected window is included in the calculation of >+ // the inner rectangle! > for ( USHORT m=0; m<aSortedList.Count(); ++m ) > { > USHORT i=aSortedList[m]; >@@ -2007,93 +2003,93 @@ void SfxWorkWindow::ConfigChild_Impl(SfxChildIdentifier eChild, > switch ( pCli->eAlign ) > { > case SFX_ALIGN_TOP: >- // Objekt-Toolboxen kommen immer zuletzt >+ // Objekt-Toolboxes come always last > //if ( bTbx || i <= nPos) > aInnerRect.Top() += pCli->aSize.Height(); > break; > > case SFX_ALIGN_TOOLBOXTOP: >- // Toolbox geht nur vor, wenn nicht h"ohere Position >+ // Toolbox has priority, if no higher Position > if ( bTbx && i <= nPos) > aInnerRect.Top() += pCli->aSize.Height(); > break; > > case SFX_ALIGN_HIGHESTTOP: >- // Geht immer vor >+ // Always performed first > aInnerRect.Top() += pCli->aSize.Height(); > break; > > case SFX_ALIGN_LOWESTTOP: >- // Wird nur mitgez"ahlt, wenn es das aktuelle Fenster ist >+ // Is only counted if it is the current window > if ( i == nPos ) > aInnerRect.Top() += pCli->aSize.Height(); > break; > > case SFX_ALIGN_BOTTOM: >- // Objekt-Toolboxen kommen immer zuletzt >+ // Objekt-Toolboxes come always last > //if ( bTbx || i <= nPos) > aInnerRect.Bottom() -= pCli->aSize.Height(); > break; > > case SFX_ALIGN_TOOLBOXBOTTOM: >- // Toolbox geht nur vor, wenn nicht h"ohere Position >+ // Toolbox has priority, if no higher Position > if ( bTbx && i <= nPos) > aInnerRect.Bottom() -= pCli->aSize.Height(); > break; > > case SFX_ALIGN_LOWESTBOTTOM: >- // Geht immer vor >+ // Always performed first > aInnerRect.Bottom() -= pCli->aSize.Height(); > break; > > case SFX_ALIGN_HIGHESTBOTTOM: >- // Wird nur mitgez"ahlt, wenn es das aktuelle Fenster ist >+ // Is only counted if it is the current window > if ( i == nPos ) > aInnerRect.Bottom() -= pCli->aSize.Height(); > break; > > case SFX_ALIGN_LEFT: >- // Toolboxen kommen immer zuletzt >+ // Toolboxes come always last > //if (bTbx || i <= nPos) > aInnerRect.Left() += pCli->aSize.Width(); > break; > > case SFX_ALIGN_TOOLBOXLEFT: >- // Toolboxen kommen immer zuletzt >+ // Toolboxes come always last > if (bTbx && i <= nPos) > aInnerRect.Left() += pCli->aSize.Width(); > break; > > case SFX_ALIGN_FIRSTLEFT: >- // Geht immer vor >+ // Always performed first > aInnerRect.Left() += pCli->aSize.Width(); > break; > > case SFX_ALIGN_LASTLEFT: >- // Wird nur mitgez"ahlt, wenn es das aktuelle Fenster ist >+ // Is only counted if it is the current window > if (i == nPos) > aInnerRect.Left() += pCli->aSize.Width(); > > case SFX_ALIGN_RIGHT: >- // Toolboxen kommen immer zuletzt >+ // Toolboxes come always last > //if (bTbx || i <= nPos) > aInnerRect.Right() -= pCli->aSize.Width(); > break; > > case SFX_ALIGN_TOOLBOXRIGHT: >- // Toolboxen kommen immer zuletzt >+ // Toolboxes come always last > if (bTbx && i <= nPos) > aInnerRect.Right() -= pCli->aSize.Width(); > break; > > case SFX_ALIGN_FIRSTRIGHT: >- // Wird nur mitgez"ahlt, wenn es das aktuelle Fenster ist >+ // Is only counted if it is the current window > if (i == nPos) > aInnerRect.Right() -= pCli->aSize.Width(); > break; > > case SFX_ALIGN_LASTRIGHT: >- // Geht immer vor >+ // Always performed first > aInnerRect.Right() -= pCli->aSize.Width(); > break; > >@@ -2165,14 +2161,14 @@ void SfxWorkWindow::SetChildWindowVisible_Impl( sal_uInt32 lId, BOOL bEnabled, U > SfxChildWin_Impl *pCW=NULL; > SfxWorkWindow *pWork = pParent; > >- // Den obersten parent nehmen; ChildWindows werden immer am WorkWindow >- // der Task bzw. des Frames oder am AppWorkWindow angemeldet >+ // Get the top parent, child windows are alwas registered at the >+ // task of the WorkWindow for example the frame or on AppWorkWindow > while ( pWork && pWork->pParent ) > pWork = pWork->pParent; > > if ( pWork ) > { >- // Dem Parent schon bekannt ? >+ // The Parent already known? > USHORT nCount = pWork->pChildWins->Count(); > for (USHORT n=0; n<nCount; n++) > if ((*pWork->pChildWins)[n]->nSaveId == nId) >@@ -2184,7 +2180,7 @@ void SfxWorkWindow::SetChildWindowVisible_Impl( sal_uInt32 lId, BOOL bEnabled, U > > if ( !pCW ) > { >- // Kein Parent oder dem Parent noch unbekannt, dann bei mir suchen >+ // If no Parent or the Parent us still unknown, then search here > USHORT nCount = pChildWins->Count(); > for (USHORT n=0; n<nCount; n++) > if ((*pChildWins)[n]->nSaveId == nId) >@@ -2196,8 +2192,8 @@ void SfxWorkWindow::SetChildWindowVisible_Impl( sal_uInt32 lId, BOOL bEnabled, U > > if ( !pCW ) > { >- // Ist neu, also initialisieren; je nach Flag beim Parent oder bei >- // mir eintragen >+ // If new, then initialize, add this here depending on the flag or >+ // the Parent > pCW = new SfxChildWin_Impl( lId ); > pCW->nId = nId; > InitializeChild_Impl( pCW ); >@@ -2216,7 +2212,7 @@ void SfxWorkWindow::SetChildWindowVisible_Impl( sal_uInt32 lId, BOOL bEnabled, U > } > > //-------------------------------------------------------------------- >-// Der An/Aus-Status eines ChildWindows wird umgeschaltet. >+// The on/of-Status of a ChildWindows is switched > > void SfxWorkWindow::ToggleChildWindow_Impl(USHORT nId, BOOL bSetFocus) > { >@@ -2228,7 +2224,7 @@ void SfxWorkWindow::ToggleChildWindow_Impl(USHORT nId, BOOL bSetFocus) > > if ( n<nCount ) > { >- // Das Fenster ist schon bekannt >+ // The Window is aleady known > SfxChildWin_Impl *pCW = (*pChildWins)[n]; > SfxChildWindow *pChild = pCW->pWin; > >@@ -2255,7 +2251,7 @@ void SfxWorkWindow::ToggleChildWindow_Impl(USHORT nId, BOOL bSetFocus) > } > else > { >- // Fenster soll ausgeschaltet werdem >+ // The Window should be switched off > pChild->SetVisible_Impl( FALSE ); > RemoveChildWin_Impl( pCW ); > } >@@ -2318,11 +2314,11 @@ void SfxWorkWindow::ToggleChildWindow_Impl(USHORT nId, BOOL bSetFocus) > > if ( n < nCount ) > { >- DBG_ERROR("ChildWindow ist nicht im Kontext!"); >+ DBG_ERROR("The ChildWindow is not in context!"); > } > else > { >- DBG_ERROR("ChildWindow ist nicht registriert!"); >+ DBG_ERROR("The ChildWindow is not registered!"); > } > #endif > } >@@ -2355,14 +2351,14 @@ BOOL SfxWorkWindow::IsFloating( USHORT nId ) > SfxChildWin_Impl *pCW=NULL; > SfxWorkWindow *pWork = pParent; > >- // Den obersten parent nehmen; ChildWindows werden immer am WorkWindow >- // der Task bzw. des Frames oder am AppWorkWindow angemeldet >+ // Get the top parent, child windows are alwas registered at the >+ // task of the WorkWindow for example the frame or on AppWorkWindow > while ( pWork && pWork->pParent ) > pWork = pWork->pParent; > > if ( pWork ) > { >- // Dem Parent schon bekannt ? >+ // The Parent already known? > USHORT nCount = pWork->pChildWins->Count(); > for (USHORT n=0; n<nCount; n++) > if ((*pWork->pChildWins)[n]->nSaveId == nId) >@@ -2374,7 +2370,7 @@ BOOL SfxWorkWindow::IsFloating( USHORT nId ) > > if ( !pCW ) > { >- // Kein Parent oder dem Parent noch unbekannt, dann bei mir suchen >+ // If no Parent or the Parent us still unknown, then search here > USHORT nCount = pChildWins->Count(); > for (USHORT n=0; n<nCount; n++) > if ((*pChildWins)[n]->nSaveId == nId) >@@ -2386,8 +2382,8 @@ BOOL SfxWorkWindow::IsFloating( USHORT nId ) > > if ( !pCW ) > { >- // Ist neu, also initialisieren; je nach Flag beim Parent oder bei >- // mir eintragen >+ // If new, then initialize, add this here depending on the flag or >+ // the Parent > pCW = new SfxChildWin_Impl( nId ); > pCW->bEnable = FALSE; > pCW->nId = 0; >@@ -2439,14 +2435,14 @@ void SfxWorkWindow::SetChildWindow_Impl(USHORT nId, BOOL bOn, BOOL bSetFocus) > SfxChildWin_Impl *pCW=NULL; > SfxWorkWindow *pWork = pParent; > >- // Den obersten parent nehmen; ChildWindows werden immer am WorkWindow >- // der Task bzw. des Frames oder am AppWorkWindow angemeldet >+ // Get the top parent, child windows are alwas registered at the >+ // task of the WorkWindow for example the frame or on AppWorkWindow > while ( pWork && pWork->pParent ) > pWork = pWork->pParent; > > if ( pWork ) > { >- // Dem Parent schon bekannt ? >+ // The Parent already known? > USHORT nCount = pWork->pChildWins->Count(); > for (USHORT n=0; n<nCount; n++) > if ((*pWork->pChildWins)[n]->nSaveId == nId) >@@ -2458,7 +2454,7 @@ void SfxWorkWindow::SetChildWindow_Impl(USHORT nId, BOOL bOn, BOOL bSetFocus) > > if ( !pCW ) > { >- // Kein Parent oder dem Parent noch unbekannt, dann bei mir suchen >+ // If no Parent or the Parent us still unknown, then search here > USHORT nCount = pChildWins->Count(); > for (USHORT n=0; n<nCount; n++) > if ((*pChildWins)[n]->nSaveId == nId) >@@ -2471,8 +2467,8 @@ void SfxWorkWindow::SetChildWindow_Impl(USHORT nId, BOOL bOn, BOOL bSetFocus) > > if ( !pCW ) > { >- // Ist neu, also initialisieren; je nach Flag beim Parent oder bei >- // mir eintragen >+ // If new, then initialize, add this here depending on the flag or >+ // the Parent > pCW = new SfxChildWin_Impl( nId ); > InitializeChild_Impl( pCW ); > if ( !pWork || pCW->aInfo.nFlags & SFX_CHILDWIN_TASK ) >@@ -2563,11 +2559,11 @@ void SfxWorkWindow::ShowChildWindow_Impl(USHORT nId, BOOL bVisible, BOOL bSetFoc > > if ( n<nCount ) > { >- DBG_ERROR("ChildWindow ist nicht im Kontext!"); >+ DBG_ERROR("The ChildWindow is not in context!"); > } > else > { >- DBG_ERROR("ChildWindow ist nicht registriert!"); >+ DBG_ERROR("The ChildWindow is not registered"); > } > #endif > } >@@ -2604,9 +2600,8 @@ void SfxWorkWindow::ResetChildWindows_Impl() > } > > //------------------------------------------------------------------------ >-// Virtuelle Methode, die die Gr"o\se der Fl"ache (client area) des parent >-// windows liefert, in der Child-Fenster angeordnet werden k"onnen. >-// in der ClientArea des parent findet. >+// Virtual method that returns the size of the area (client area) of the >+// parent windows, in which the ChildWindow can be fitted. > > Rectangle SfxWorkWindow::GetTopRect_Impl() > { >@@ -2614,9 +2609,8 @@ Rectangle SfxWorkWindow::GetTopRect_Impl() > } > > //------------------------------------------------------------------------ >-// Virtuelle Methode, die die Gr"o\se der Fl"ache (client area) des parent >-// windows liefert, in der Child-Fenster angeordnet werden k"onnen. >-// in der ClientArea des parent findet. >+// Virtual method that returns the size of the area (client area) of the >+// parent windows, in which the ChildWindow can be fitted. > > Rectangle SfxFrameWorkWin_Impl::GetTopRect_Impl() > { >@@ -2624,8 +2618,8 @@ Rectangle SfxFrameWorkWin_Impl::GetTopRect_Impl() > } > > //------------------------------------------------------------------------ >-// Virtuelle Methode, um herauszufinden, ob ein Child-Fenster noch Platz >-// in der ClientArea des parent findet. >+// Virtual method to find out if there is room for a ChildWindow in the >+// client area of the parent. > > BOOL SfxWorkWindow::RequestTopToolSpacePixel_Impl( SvBorder aBorder ) > { >@@ -2639,7 +2633,7 @@ BOOL SfxWorkWindow::RequestTopToolSpacePixel_Impl( SvBorder aBorder ) > > void SfxWorkWindow::SaveStatus_Impl(SfxChildWindow *pChild, const SfxChildWinInfo &rInfo) > { >- // Den Status vom Presentation mode wollen wir nicht sichern >+ // The Status of the Presentation mode is not saved > if ( IsDockingAllowed() && bInternalDockingAllowed ) > pChild->SaveStatus(rInfo); > } >@@ -2802,11 +2796,10 @@ void SfxWorkWindow::ArrangeAutoHideWindows( SfxSplitWindow *pActSplitWin ) > Rectangle aArea( aUpperClientArea ); > for ( USHORT n=0; n<SFX_SPLITWINDOWS_MAX; n++ ) > { >- // Es werden entweder Dummyfenster oder Fenster im AutoShow-Modus >- // ( nicht gepinned, FadeIn ) behandelt. >- // Nur das "ubergebene Fenster darf unsichtbar sein, denn vielleicht >- // soll daf"ur gerade die Gr"o\se berechnet werden, bevor es angezeigt >- // wird. >+ // Either dummy window or window in the auto-show-mode are processed >+ // (not pinned, FadeIn). >+ // Only the abandoned window may be invisible, because perhaps its >+ // size is just beeing calculated before it is displayed. > SfxSplitWindow* pSplitWin = pSplit[n]; > BOOL bDummyWindow = !pSplitWin->IsFadeIn(); > Window *pDummy = pSplitWin->GetSplitWindow(); >@@ -2814,7 +2807,7 @@ void SfxWorkWindow::ArrangeAutoHideWindows( SfxSplitWindow *pActSplitWin ) > if ( (pSplitWin->IsPinned() && !bDummyWindow) || (!pWin->IsVisible() && pActSplitWin != pSplitWin) ) > continue; > >- // Breite und Position des Dummy-Fensters als Ausgangspunkt >+ // Width and position of the dummy window as a starting point > Size aSize = pDummy->GetSizePixel(); > Point aPos = pDummy->GetPosPixel(); > >@@ -2822,13 +2815,13 @@ void SfxWorkWindow::ArrangeAutoHideWindows( SfxSplitWindow *pActSplitWin ) > { > case ( 0 ) : > { >- // Linkes SplitWindow >- // Breite vom Fenster selbst holen, wenn nicht das DummyWindow >+ // Left SplitWindow >+ // Get the width of the Window yourself, if no DummyWindow > if ( !bDummyWindow ) > aSize.Width() = pSplitWin->GetSizePixel().Width(); > >- // Wenn links ein Window sichtbar ist, beginnt der freie >- // Bereich rechts davon bzw. bei der Client area >+ // If a Window is visable to the left, then the free region >+ // starts to the right from it, for example at the Client area > long nLeft = aPos.X() + aSize.Width(); > if ( nLeft > aArea.Left() ) > aArea.Left() = nLeft; >@@ -2836,26 +2829,26 @@ void SfxWorkWindow::ArrangeAutoHideWindows( SfxSplitWindow *pActSplitWin ) > } > case ( 1 ) : > { >- // Rechtes SplitWindow >- // Position um Differenz der Breiten korrigieren >+ // Right SplitWindow >+ // Position to correct the difference of the widths > aPos.X() += aSize.Width(); > >- // Breite vom Fenster selbst holen, wenn nicht das DummyWindow >+ // Get the width of the Window yourself, if no DummyWindow > if ( !bDummyWindow ) > aSize.Width() = pSplitWin->GetSizePixel().Width(); > > aPos.X() -= aSize.Width(); > >- // Wenn links schon ein Fenster aufgeklappt ist, darf >- // das rechte nicht dar"uber gehen >+ // If already a window is opened at the left side, then the >+ // right is not allowed to overlap this one. > if ( aPos.X() < aArea.Left() ) > { > aPos.X() = aArea.Left(); > aSize.Width() = aArea.GetWidth(); > } > >- // Wenn rechts ein Window sichtbar ist, endet der freie >- // Bereich links davon bzw. bei der Client area >+ // If a Window is visable to the right, then the free region >+ // starts to the left from it, for example at the Client area > long nRight = aPos.X(); > if ( nRight < aArea.Right() ) > aArea.Right() = nRight; >@@ -2863,18 +2856,19 @@ void SfxWorkWindow::ArrangeAutoHideWindows( SfxSplitWindow *pActSplitWin ) > } > case ( 2 ) : > { >- // Oberes SplitWindow >- // H"ohe vom Fenster selbst holen, wenn nicht das DummyWindow >+ // Top SplitWindow >+ // Get the height of the Window yourself, if no DummyWindow > if ( !bDummyWindow ) > aSize.Height() = pSplitWin->GetSizePixel().Height(); > >- // Breite anpassen, je nachdem ob links oder rechts >- // schon ein Fenster aufgeklappt ist >+ >+ // Adjust width with regard to if a Window is already open >+ // to the left or right > aPos.X() = aArea.Left(); > aSize.Width() = aArea.GetWidth(); > >- // Wenn oben ein Window sichtbar ist, beginnt der freie >- // Bereich darunter bzw. bei der Client Area >+ // If a Window is visable at the top, then the free region >+ // starts beneath it, for example at the Client area > long nTop = aPos.Y() + aSize.Height(); > if ( nTop > aArea.Top() ) > aArea.Top() = nTop; >@@ -2882,23 +2876,23 @@ void SfxWorkWindow::ArrangeAutoHideWindows( SfxSplitWindow *pActSplitWin ) > } > case ( 3 ) : > { >- // Das untere SplitWindow >- // Position um Differenz der H"ohen korrigieren >+ // The bottom SplitWindow >+ // Position to correct the difference of the heights > aPos.Y() += aSize.Height(); > >- // H"ohe vom Fenster selbst holen, wenn nicht das DummmyWindow >+ // Get the height of the Window yourself, if no DummyWindow > if ( !bDummyWindow ) > aSize.Height() = pSplitWin->GetSizePixel().Height(); > > aPos.Y() -= aSize.Height(); > >- // Breite anpassen, je nachdem ob links oder rechts >- // schon ein Fenster aufgeklappt ist >+ // Adjust width with regard to if a Window is already open >+ // to the left or right. > aPos.X() = aArea.Left(); > aSize.Width() = aArea.GetWidth(); > >- // Wenn oben schon ein Fenster aufgeklappt ist, darf >- // das untere nicht dar"uber gehen >+ // If already a window is opened at the top, then the >+ // bottom one is not allowed to overlap this one. > if ( aPos.Y() < aArea.Top() ) > { > aPos.Y() = aArea.Top(); >@@ -2910,11 +2904,11 @@ void SfxWorkWindow::ArrangeAutoHideWindows( SfxSplitWindow *pActSplitWin ) > } > > if ( !bDummyWindow ) >- // Das FadeIn-Window ist ein Float, dessen Koordinaten in >- // Screenkoordinaten gesetzt werden >+ // the FadeIn-Window is a Floating window, which coordinates are >+ // set in Screen coordinates. > pSplitWin->SetPosSizePixel( pWorkWin->OutputToScreenPixel(aPos), aSize ); > else >- // Das angedockte DummyWindow >+ // the docked DummyWindow > pDummy->SetPosSizePixel( aPos, aSize ); > } > } >@@ -2997,7 +2991,7 @@ Window* SfxWorkWindow::GetActiveChild_Impl() > > BOOL SfxWorkWindow::ActivateNextChild_Impl( BOOL bForward ) > { >- // Alle Kinder gem"a\s Liste sortieren >+ // Sort all children under list > SvUShorts aList; > for ( USHORT i=SFX_OBJECTBAR_MAX; i<pChilds->Count(); i++) > { >@@ -3027,7 +3021,7 @@ BOOL SfxWorkWindow::ActivateNextChild_Impl( BOOL bForward ) > SfxChild_Impl *pAct=NULL; > if ( pActiveChild ) > { >- // Das aktive Fenster suchen >+ // Look for the active window > for ( n=0; n<aList.Count(); n++ ) > { > SfxChild_Impl* pCli = (*pChilds)[aList[n]]; >@@ -3047,7 +3041,7 @@ BOOL SfxWorkWindow::ActivateNextChild_Impl( BOOL bForward ) > { > for ( USHORT i=0; i<SFX_SPLITWINDOWS_MAX; i++ ) > { >- // Eventuell ist pAct ein Splitwindow >+ // Maybe the pNext is a Splitwindow > SfxSplitWindow *p = pSplit[i]; > if ( pAct->pWin == p ) > { >@@ -3057,8 +3051,8 @@ BOOL SfxWorkWindow::ActivateNextChild_Impl( BOOL bForward ) > } > } > >- // pAct ist ein direktes ChildWindow >- // mit dem Nachfolger bzw. Vorg"anger des aktiven Fensters weitermachen >+ // pAct is a direct ChildWindow >+ // continue with the successor or predecessor of the active window > if ( bForward ) > n = n+1; > else >@@ -3076,11 +3070,11 @@ BOOL SfxWorkWindow::ActivateNextChild_Impl( BOOL bForward ) > SfxChild_Impl* pNext = pCli; > for ( USHORT i=0; n<SFX_SPLITWINDOWS_MAX; n++ ) > { >- // Eventuell ist pNext ein Splitwindow >+ // Maybe the pNext is a Splitwindow > SfxSplitWindow *p = pSplit[i]; > if ( pNext->pWin == p ) > { >- // Das erste/letzte Fenster dort aktivieren >+ // Activate the first/last window > p->SetActiveWindow_Impl( NULL ); > pNext = NULL; > if( p->ActivateNextChild_Impl( bForward ) ) >diff --git a/sfx2/source/bastyp/bastyp.hrc b/sfx2/source/bastyp/bastyp.hrc >index 36e3047..7095543 100644 >--- a/sfx2/source/bastyp/bastyp.hrc >+++ b/sfx2/source/bastyp/bastyp.hrc >@@ -27,7 +27,7 @@ > > #include <sfx2/sfx.hrc> > >-//fuer das Mapping Fehlercode -> ResId >+//for the mapping error code -> ResId > > #define RC_BASTYP RID_SFX_BASTYP_START > #define STR_FILTER_NOT_INSTALLED (RC_BASTYP + 9) >diff --git a/sfx2/source/bastyp/fltfnc.cxx b/sfx2/source/bastyp/fltfnc.cxx >index b083ef6..3f76500 100644 >--- a/sfx2/source/bastyp/fltfnc.cxx >+++ b/sfx2/source/bastyp/fltfnc.cxx >@@ -218,7 +218,7 @@ const SfxFilter* SfxFilterContainer::GetDefaultFilter_Impl( const String& rName > const SfxFilter* pFilter = aMatcher.GetFilter4FilterName(sDefaultFilter); > > if ( >- (pFilter ) && >+ (pFilter) && > (pFilter->GetServiceName().CompareIgnoreCaseToAscii( sServiceName ) != COMPARE_EQUAL) > ) > { >@@ -370,7 +370,6 @@ sal_uInt32 SfxFilterMatcher::GuessFilterIgnoringContent( > ::rtl::OUString sTypeName; > try > { >- //!MBA: nmust, ndont? > sTypeName = xDetection->queryTypeByURL( rMedium.GetURLObject().GetMainURL( INetURLObject::NO_DECODE ) ); > } > catch( Exception& ) >@@ -486,7 +485,7 @@ sal_Bool SfxFilterMatcher::IsFilterInstalled_Impl( const SfxFilter* pFilter ) > { > if ( pFilter->GetFilterFlags() & SFX_FILTER_MUSTINSTALL ) > { >- // Hier k"onnte noch eine Nachinstallation angeboten werden >+ // Here could a re-installation be offered > String aText( SfxResId( STR_FILTER_NOT_INSTALLED ) ); > aText.SearchAndReplaceAscii( "$(FILTER)", pFilter->GetUIName() ); > QueryBox aQuery( NULL, WB_YES_NO | WB_DEF_YES, aText ); >@@ -494,11 +493,11 @@ sal_Bool SfxFilterMatcher::IsFilterInstalled_Impl( const SfxFilter* pFilter ) > if ( nRet == RET_YES ) > { > #ifdef DBG_UTIL >- // Setup starten >- InfoBox( NULL, DEFINE_CONST_UNICODE("Hier soll jetzt das Setup starten!") ).Execute(); >+ // Start Setup >+ InfoBox( NULL, DEFINE_CONST_UNICODE("Here should the Setup now be starting!") ).Execute(); > #endif >- // Installation mu\s hier noch mitteilen, ob es geklappt hat, dann kann das >- // Filterflag gel"oscht werden >+ // Installation must still give feedback if it worked or not, >+ // then the Filterflag be deleted > } > > return ( !(pFilter->GetFilterFlags() & SFX_FILTER_MUSTINSTALL) ); >@@ -516,9 +515,9 @@ sal_Bool SfxFilterMatcher::IsFilterInstalled_Impl( const SfxFilter* pFilter ) > > > sal_uInt32 SfxFilterMatcher::DetectFilter( SfxMedium& rMedium, const SfxFilter**ppFilter, sal_Bool /*bPlugIn*/, sal_Bool bAPI ) const >-/* [Beschreibung] >+/* [Description] > >- Hier wird noch die Filterauswahlbox hochgezogen. Sonst GuessFilter >+ Here the Filter selection box is pulled up. Otherwise GuessFilter > */ > > { >@@ -557,17 +556,18 @@ sal_uInt32 SfxFilterMatcher::DetectFilter( SfxMedium& rMedium, const SfxFilter** > { > const SfxFilter* pInstallFilter = NULL; > >- // Jetzt auch Filter testen, die nicht installiert sind ( ErrCode ist irrelevant ) >+ // Now test the filter which are not installed (ErrCode is irrelevant) > GuessFilter( rMedium, &pInstallFilter, SFX_FILTER_IMPORT, SFX_FILTER_CONSULTSERVICE ); > if ( pInstallFilter ) > { > if ( IsFilterInstalled_Impl( pInstallFilter ) ) >- // Eventuell wurde der Filter nachinstalliert >+ // Maybe the filter was installed was installed afterwards. > pFilter = pInstallFilter; > } > else > { >- // Jetzt auch Filter testen, die erst von Star bezogen werden m"ussen ( ErrCode ist irrelevant ) >+ // Now test the filter, which first must be obtained by Star >+ // (ErrCode is irrelevant) > GuessFilter( rMedium, &pInstallFilter, SFX_FILTER_IMPORT, 0 ); > if ( pInstallFilter ) > IsFilterInstalled_Impl( pInstallFilter ); >@@ -835,7 +835,7 @@ SfxFilterMatcherIter::SfxFilterMatcherIter( > : nOrMask( nOrMaskP ), nAndMask( nAndMaskP ), > nCurrent(0), pMatch( pMatchP->pImpl) > { >- if( nOrMask == 0xffff ) //Wg. Fehlbuild auf s >+ if( nOrMask == 0xffff ) // Due to faulty build on s > nOrMask = 0; > pMatch->InitForIterating(); > } >diff --git a/sfx2/source/bastyp/frmhtml.cxx b/sfx2/source/bastyp/frmhtml.cxx >index 791298a..c8d56c6 100644 >--- a/sfx2/source/bastyp/frmhtml.cxx >+++ b/sfx2/source/bastyp/frmhtml.cxx >@@ -68,14 +68,14 @@ static HTMLOptionEnum const aScollingTable[] = > > void SfxFrameHTMLParser::ParseFrameOptions( SfxFrameDescriptor *pFrame, const HTMLOptions *pOptions, const String& rBaseURL ) > { >- // die Optionen holen und setzen >+ // Get and set the options > Size aMargin( pFrame->GetMargin() ); > >- // MIB 15.7.97: Netscape scheint marginwidth auf 0 zu setzen, sobald >- // marginheight gesetzt wird und umgekehrt. Machen wir jetzt wegen >- // bug #41665# auch so. >- // Netscape l"a\st aber ein direktes Setzen auf 0 nicht zu, IE4.0 schon. >- // Den Bug machen wir nicht mit! >+ // MIB 07/15/1997: Netscape seems to set marginwidth to 0 as soon as >+ // margin height is set, and vice versa. Due to bug #41665# let us also >+ // do like that for now. Netscape does however not allow for a direct >+ // seting to 0, while IE4.0 does >+ // We will not mimic that bug ! > BOOL bMarginWidth = FALSE, bMarginHeight = FALSE; > > USHORT nArrLen = pOptions->Count(); >diff --git a/sfx2/source/bastyp/frmhtmlw.cxx b/sfx2/source/bastyp/frmhtmlw.cxx >index f7b597a..70e4fec 100644 >--- a/sfx2/source/bastyp/frmhtmlw.cxx >+++ b/sfx2/source/bastyp/frmhtmlw.cxx >@@ -277,7 +277,7 @@ void SfxFrameHTMLWriter::OutHeader( rtl_TextEncoding eDestEnc ) > Strm() << sNewLine; > HTMLOutFuncs::Out_AsciiTag( Strm(), sHTML_head, FALSE ) << sNewLine; > >-//! OutScript(); // Hier fehlen noch die Scripten im Header >+//! OutScript(); // Hear the scripts in the Header are still missing > } > */ > >@@ -333,7 +333,7 @@ void SfxFrameHTMLWriter::Out_FrameDescriptor( > } > } > >- // frame border (MS+Netscape-Erweiterung) >+ // frame border (MS+Netscape-Extension) > aAny = xSet->getPropertyValue( ::rtl::OUString(RTL_CONSTASCII_USTRINGPARAM("FrameIsAutoBorder")) ); > if ( (aAny >>= bVal) && !bVal ) > { >diff --git a/sfx2/source/bastyp/minarray.cxx b/sfx2/source/bastyp/minarray.cxx >index 54daf35..7ed7c52 100644 >--- a/sfx2/source/bastyp/minarray.cxx >+++ b/sfx2/source/bastyp/minarray.cxx >@@ -101,7 +101,7 @@ void SfxPtrArr::Append( void* aElem ) > { > DBG_MEMTEST(); > DBG_ASSERT( sal::static_int_cast< unsigned >(nUsed+1) < ( USHRT_MAX / sizeof(void*) ), "array too large" ); >- // musz das Array umkopiert werden? >+ // Does the Array need to be copied? > if ( nUnused == 0 ) > { > USHORT nNewSize = (nUsed == 1) ? (nGrow==1 ? 2 : nGrow) : nUsed+nGrow; >@@ -116,7 +116,7 @@ void SfxPtrArr::Append( void* aElem ) > pData = pNewData; > } > >- // jetzt hinten in den freien Raum schreiben >+ // now write at the back in the open space > pData[nUsed] = aElem; > ++nUsed; > --nUnused; >@@ -127,14 +127,14 @@ void SfxPtrArr::Append( void* aElem ) > USHORT SfxPtrArr::Remove( USHORT nPos, USHORT nLen ) > { > DBG_MEMTEST(); >- // nLen adjustieren, damit nicht ueber das Ende hinaus geloescht wird >+ // Adjust nLen, thus to avoid deleting beyond the end > nLen = Min( (USHORT)(nUsed-nPos), nLen ); > >- // einfache Aufgaben erfordern einfache Loesungen! >+ // simple problems require simple solutions! > if ( nLen == 0 ) > return 0; > >- // bleibt vielleicht keiner uebrig >+ // Maybe no one will remain > if ( (nUsed-nLen) == 0 ) > { > delete [] pData; >@@ -144,10 +144,10 @@ USHORT SfxPtrArr::Remove( USHORT nPos, USHORT nLen ) > return nLen; > } > >- // feststellen, ob das Array dadurch physikalisch schrumpft... >+ // Determine whether the array has physically shrunk... > if ( (nUnused+nLen) >= nGrow ) > { >- // auf die naechste Grow-Grenze aufgerundet verkleinern >+ // reduce (rounded up) to the next Grow-border > USHORT nNewUsed = nUsed-nLen; > USHORT nNewSize = ((nNewUsed+nGrow-1)/nGrow) * nGrow; > DBG_ASSERT( nNewUsed <= nNewSize && nNewUsed+nGrow > nNewSize, >@@ -168,7 +168,7 @@ USHORT SfxPtrArr::Remove( USHORT nPos, USHORT nLen ) > return nLen; > } > >- // in allen anderen Faellen nur zusammenschieben >+ // in all other cases, only push together > if ( nUsed-nPos-nLen > 0 ) > memmove( pData+nPos, pData+nPos+nLen, (nUsed-nPos-nLen)*sizeof(void*) ); > nUsed = nUsed - nLen; >@@ -181,11 +181,11 @@ USHORT SfxPtrArr::Remove( USHORT nPos, USHORT nLen ) > BOOL SfxPtrArr::Remove( void* aElem ) > { > DBG_MEMTEST(); >- // einfache Aufgaben ... >+ // simple tasks ... > if ( nUsed == 0 ) > return FALSE; > >- // rueckwaerts, da meist der letzte zuerst wieder entfernt wird >+ // backwards, since most of the last is first removed > void* *pIter = pData + nUsed - 1; > for ( USHORT n = 0; n < nUsed; ++n, --pIter ) > if ( *pIter == aElem ) >@@ -201,11 +201,11 @@ BOOL SfxPtrArr::Remove( void* aElem ) > BOOL SfxPtrArr::Replace( void* aOldElem, void* aNewElem ) > { > DBG_MEMTEST(); >- // einfache Aufgaben ... >+ // simple tasks ... > if ( nUsed == 0 ) > return FALSE; > >- // rueckwaerts, da meist der letzte zuerst wieder entfernt wird >+ // backwards, since most of the last is first removed > void* *pIter = pData + nUsed - 1; > for ( USHORT n = 0; n < nUsed; ++n, --pIter ) > if ( *pIter == aOldElem ) >@@ -240,10 +240,10 @@ void SfxPtrArr::Insert( USHORT nPos, void* rElem ) > { > DBG_MEMTEST(); > DBG_ASSERT( sal::static_int_cast< unsigned >(nUsed+1) < ( USHRT_MAX / sizeof(void*) ), "array too large" ); >- // musz das Array umkopiert werden? >+ // Does the Array have o be copied? > if ( nUnused == 0 ) > { >- // auf die naechste Grow-Grenze aufgerundet vergroeszern >+ // increase (rounded up ) to the next Grow-border > USHORT nNewSize = nUsed+nGrow; > void** pNewData = new void*[nNewSize]; > >@@ -257,11 +257,11 @@ void SfxPtrArr::Insert( USHORT nPos, void* rElem ) > pData = pNewData; > } > >- // jetzt den hinteren Teil verschieben >+ // Now move the rear part > if ( nPos < nUsed ) > memmove( pData+nPos+1, pData+nPos, (nUsed-nPos)*sizeof(void*) ); > >- // jetzt in den freien Raum schreiben >+ // Now write into the free space. > memmove( pData+nPos, &rElem, sizeof(void*) ); > nUsed += 1; > nUnused -= 1; >@@ -336,7 +336,7 @@ ByteArr& ByteArr::operator=( const ByteArr& rOrig ) > void ByteArr::Append( char aElem ) > { > DBG_MEMTEST(); >- // musz das Array umkopiert werden? >+ // Does the Array have o be copied? > if ( nUnused == 0 ) > { > USHORT nNewSize = (nUsed == 1) ? (nGrow==1 ? 2 : nGrow) : nUsed+nGrow; >@@ -351,7 +351,7 @@ void ByteArr::Append( char aElem ) > pData = pNewData; > } > >- // jetzt hinten in den freien Raum schreiben >+ // now write at the back in the open space > pData[nUsed] = aElem; > ++nUsed; > --nUnused; >@@ -362,14 +362,14 @@ void ByteArr::Append( char aElem ) > USHORT ByteArr::Remove( USHORT nPos, USHORT nLen ) > { > DBG_MEMTEST(); >- // nLen adjustieren, damit nicht ueber das Ende hinaus geloescht wird >+ // Adjust nLen, thus to avoid deleting beyond the end > nLen = Min( (USHORT)(nUsed-nPos), nLen ); > >- // einfache Aufgaben erfordern einfache Loesungen! >+ // simple problems require simple solutions! > if ( nLen == 0 ) > return 0; > >- // bleibt vielleicht keiner uebrig >+ // Maybe no one will remain > if ( (nUsed-nLen) == 0 ) > { > delete [] pData; >@@ -379,10 +379,10 @@ USHORT ByteArr::Remove( USHORT nPos, USHORT nLen ) > return nLen; > } > >- // feststellen, ob das Array dadurch physikalisch schrumpft... >+ // Determine whether the array has physically shrunk... > if ( (nUnused+nLen) >= nGrow ) > { >- // auf die naechste Grow-Grenze aufgerundet verkleinern >+ // reduce (rounded up) to the next Grow-border > USHORT nNewUsed = nUsed-nLen; > USHORT nNewSize = ((nNewUsed+nGrow-1)/nGrow) * nGrow; > DBG_ASSERT( nNewUsed <= nNewSize && nNewUsed+nGrow > nNewSize, >@@ -403,7 +403,7 @@ USHORT ByteArr::Remove( USHORT nPos, USHORT nLen ) > return nLen; > } > >- // in allen anderen Faellen nur zusammenschieben >+ // in all other cases, only push together > if ( nUsed-nPos-nLen > 0 ) > memmove( pData+nPos, pData+nPos+nLen, (nUsed-nPos-nLen)*sizeof(char) ); > nUsed = nUsed - nLen; >@@ -416,11 +416,11 @@ USHORT ByteArr::Remove( USHORT nPos, USHORT nLen ) > BOOL ByteArr::Remove( char aElem ) > { > DBG_MEMTEST(); >- // einfache Aufgaben ... >+ // simple tasks ... > if ( nUsed == 0 ) > return FALSE; > >- // rueckwaerts, da meist der letzte zuerst wieder entfernt wird >+ // backwards, since most of the last is first removed > char *pIter = pData + nUsed - 1; > for ( USHORT n = 0; n < nUsed; ++n, --pIter ) > if ( *pIter == aElem ) >@@ -454,10 +454,10 @@ BOOL ByteArr::Contains( const char rItem ) const > void ByteArr::Insert( USHORT nPos, char rElem ) > { > DBG_MEMTEST(); >- // musz das Array umkopiert werden? >+ // Does the Array need to be copied? > if ( nUnused == 0 ) > { >- // auf die naechste Grow-Grenze aufgerundet vergroeszern >+ // increase (rounded up) to the next Grow-border > USHORT nNewSize = nUsed+nGrow; > char* pNewData = new char[nNewSize]; > >@@ -471,11 +471,11 @@ void ByteArr::Insert( USHORT nPos, char rElem ) > pData = pNewData; > } > >- // jetzt den hinteren Teil verschieben >+ // Now move the rear part > if ( nPos < nUsed ) > memmove( pData+nPos+1, pData+nPos, (nUsed-nPos)*sizeof(char) ); > >- // jetzt in den freien Raum schreiben >+ // now write at the back in the open space > memmove( pData+nPos, &rElem, sizeof(char) ); > nUsed += 1; > nUnused -= 1; >@@ -568,7 +568,7 @@ WordArr& WordArr::operator=( const WordArr& rOrig ) > void WordArr::Append( short aElem ) > { > DBG_MEMTEST(); >- // musz das Array umkopiert werden? >+ // Does the Array need to be copied? > if ( nUnused == 0 ) > { > USHORT nNewSize = (nUsed == 1) ? (nGrow==1 ? 2 : nGrow) : nUsed+nGrow; >@@ -583,7 +583,7 @@ void WordArr::Append( short aElem ) > pData = pNewData; > } > >- // jetzt hinten in den freien Raum schreiben >+ // now write at the back in the open space > pData[nUsed] = aElem; > ++nUsed; > --nUnused; >@@ -594,14 +594,14 @@ void WordArr::Append( short aElem ) > USHORT WordArr::Remove( USHORT nPos, USHORT nLen ) > { > DBG_MEMTEST(); >- // nLen adjustieren, damit nicht ueber das Ende hinaus geloescht wird >+ // Adjust nLen, thus to avoid deleting beyond the end > nLen = Min( (USHORT)(nUsed-nPos), nLen ); > >- // einfache Aufgaben erfordern einfache Loesungen! >+ // simple problems require simple solutions! > if ( nLen == 0 ) > return 0; > >- // bleibt vielleicht keiner uebrig >+ // Maybe no one will remain > if ( (nUsed-nLen) == 0 ) > { > delete [] pData; >@@ -611,10 +611,10 @@ USHORT WordArr::Remove( USHORT nPos, USHORT nLen ) > return nLen; > } > >- // feststellen, ob das Array dadurch physikalisch schrumpft... >+ // Determine whether the array has physically shrunk... > if ( (nUnused+nLen) >= nGrow ) > { >- // auf die naechste Grow-Grenze aufgerundet verkleinern >+ // reduce (rounded up) to the next Grow-border > USHORT nNewUsed = nUsed-nLen; > USHORT nNewSize = ((nNewUsed+nGrow-1)/nGrow) * nGrow; > DBG_ASSERT( nNewUsed <= nNewSize && nNewUsed+nGrow > nNewSize, >@@ -635,7 +635,7 @@ USHORT WordArr::Remove( USHORT nPos, USHORT nLen ) > return nLen; > } > >- // in allen anderen Faellen nur zusammenschieben >+ // in all other cases, only push together > if ( nUsed-nPos-nLen > 0 ) > memmove( pData+nPos, pData+nPos+nLen, (nUsed-nPos-nLen)*sizeof(short) ); > nUsed = nUsed - nLen; >@@ -648,11 +648,11 @@ USHORT WordArr::Remove( USHORT nPos, USHORT nLen ) > BOOL WordArr::Remove( short aElem ) > { > DBG_MEMTEST(); >- // einfache Aufgaben ... >+ // simple tasks ... > if ( nUsed == 0 ) > return FALSE; > >- // rueckwaerts, da meist der letzte zuerst wieder entfernt wird >+ // backwards, since most of the last is first removed > short *pIter = pData + nUsed - 1; > for ( USHORT n = 0; n < nUsed; ++n, --pIter ) > if ( *pIter == aElem ) >@@ -686,10 +686,10 @@ BOOL WordArr::Contains( const short rItem ) const > void WordArr::Insert( USHORT nPos, short rElem ) > { > DBG_MEMTEST(); >- // musz das Array umkopiert werden? >+ // Does the Array need to be copied? > if ( nUnused == 0 ) > { >- // auf die naechste Grow-Grenze aufgerundet vergroeszern >+ // increase (rounded up) to the next Grow-border > USHORT nNewSize = nUsed+nGrow; > short* pNewData = new short[nNewSize]; > >@@ -703,11 +703,11 @@ void WordArr::Insert( USHORT nPos, short rElem ) > pData = pNewData; > } > >- // jetzt den hinteren Teil verschieben >+ // Now move the rear part > if ( nPos < nUsed ) > memmove( pData+nPos+1, pData+nPos, (nUsed-nPos)*sizeof(short) ); > >- // jetzt in den freien Raum schreiben >+ // now write at the back in the open space > memmove( pData+nPos, &rElem, sizeof(short) ); > nUsed += 1; > nUnused -= 1; >diff --git a/sfx2/source/bastyp/progress.cxx b/sfx2/source/bastyp/progress.cxx >index d4c7f14..58284d4 100644 >--- a/sfx2/source/bastyp/progress.cxx >+++ b/sfx2/source/bastyp/progress.cxx >@@ -38,7 +38,7 @@ > #include <svl/eitem.hxx> > #include <tools/time.hxx> > >-// wg. nRescheduleLocks >+// includes below due to nRescheduleLocks > #include "appdata.hxx" > #include <sfx2/request.hxx> > #include <sfx2/frame.hxx> >@@ -149,28 +149,27 @@ SfxProgress_Impl::SfxProgress_Impl( const String &/*rTitle*/ ) > > SfxProgress::SfxProgress > ( >- SfxObjectShell* pObjSh, /* SfxObjectShell, an der die Aktion ausgef"uhrt >- wird. Kann NULL sein, dann wird die Applikation >- verwendet */ >+ SfxObjectShell* pObjSh, /* The action is performed on the >+ SfxObjectShell which can be NULL. >+ When it is then the application will be >+ used */ > >- const String& rText, /* Text, der in der Statuszeile vor den Statusmonitor >- erscheint */ >+ const String& rText, /* Text, which appears before the Statusmonitor >+ in the status line */ > >- ULONG nRange, /* Maximalwert des Bereiches */ >+ ULONG nRange, /* Max value for range */ > >- BOOL bAll /* alle Dokumente oder nur das Dokument des ViewFrames >- disablen (FALSE) */ >- ,BOOL bWait /* initial den Wait-Pointer aktivieren (TRUE) */ >+ BOOL bAll /* Disable all documents or only the document of the ViewFram */ >+ ,BOOL bWait /* Aktivate the wait-Pointer initially (TRUE) */ > ) > >-/* [Beschreibung] >+/* [Description] > >- Der Konstruktor der Klasse SfxProgress schaltet den als Parameter >- "ubergebenen SfxObjectShell und SfxViewFrames, welche dieses Dokument >- anzeigen in einen Progress-Mode. D.h. solange eine dieser SfxViewFrame >- Instanzen aktiv ist, ist der dazugeh"orige SfxDispatcher und das >- dazugeh"orige Window disabled. In der Statuszeile wird ein Balken zur >- Fortschritts-Anzeige angezeigt. >+ The constructor of the class SfxProgress switches the SfxObjectShell >+ passed as parameter and SfxViewFrames which display this document in >+ a progress mode. Ie as long as one of those SfxViewFrame instances is >+ active the associated SfxDispatcher and associated Window is disabled. >+ A progress-bar will be displayed in the status bar, > */ > > : pImp( new SfxProgress_Impl( rText ) ), >@@ -206,11 +205,10 @@ SfxProgress::SfxProgress > > SfxProgress::~SfxProgress() > >-/* [Beschreibung] >+/* [Description] > >- Der Destruktor der Klasse SfxProgress restauriert den alten Zustand; >- die Dokumente werden wieder freigeschaltet und die Statuszeile zeigt >- wieder Items an. >+ The destructor of the class SfxProgress restores the old status, >+ the documents are released again and the status bar shows the items again. > */ > > { >@@ -227,9 +225,9 @@ SfxProgress::~SfxProgress() > > void SfxProgress::Stop() > >-/* [Beschreibung] >+/* [Description] > >- Vorzeitiges Beenden des <SfxProgress>. >+ Early Exit of <SfxProgress>. > */ > > { >@@ -258,13 +256,12 @@ void SfxProgress::Stop() > > void SfxProgress::SetText > ( >- const String& /* neuer Text */ >+ const String& /* new Text */ > ) > >-/* [Beschreibung] >+/* [Description] > >- "Andert den Text, der links neben dem Fortschritts-Balken >- angezeigt wird. >+ Changes the text that appears to the left next to progress bar. > */ > > { >@@ -306,7 +303,7 @@ IMPL_STATIC_LINK( SfxProgress, SetStateHdl, PlugInLoadStatus*, pStatus ) > > // ----------------------------------------------------------------------- > >-// muss in AppDaten >+// Required in App data > static ULONG nLastTime = 0; > > long TimeOut_Impl( void*, void* pArgV ) >@@ -326,9 +323,9 @@ long TimeOut_Impl( void*, void* pArgV ) > > BOOL SfxProgress::SetStateText > ( >- ULONG nNewVal, /* neuer Wert f"ur die Fortschritts-Anzeige */ >- const String& rNewVal, /* Status als Text */ >- ULONG nNewRange /* neuer Maximalwert, 0 f"ur Beibehaltung des alten */ >+ ULONG nNewVal, /* New value for the progress-bar */ >+ const String& rNewVal, /* Status as Text */ >+ ULONG nNewRange /* new maximum value, 0 for retaining the old */ > ) > > { >@@ -340,37 +337,32 @@ BOOL SfxProgress::SetStateText > > BOOL SfxProgress::SetState > ( >- ULONG nNewVal, /* neuer Wert f"ur die Fortschritts-Anzeige */ >+ ULONG nNewVal, /* new value for the progress bar */ > >- ULONG nNewRange /* neuer Maximalwert, 0 f"ur Beibehaltung des alten */ >+ ULONG nNewRange /* new maximum value, 0 for retaining the old */ > ) >-/* [Beschreibung] >+/* [Description] > >- Setzen des aktuellen Status; nach einem zeitlichen Versatz >- wird Reschedule aufgerufen. >+ Setting the current status, after a time delay Reschedule is called. > >+ [Return value] > >- [R"uckgabewert] >- >- BOOL TRUE >- Fortfahren mit der Aktion >- >- FALSE >- Abbrechen der Aktion >+ BOOL TRUE Proceed with the action >+ FALSE Cancel action > */ > > { >- // wurde via Stop-Button angehalten? >+ // Was stoped by Stop-Button? > // if ( pImp->IsCancelled() ) > // return FALSE; > > if( pImp->pActiveProgress ) return TRUE; > >- // neuen Wert "ubernehmen >+ // transfer new value > BOOL bOver=FALSE; > nVal = nNewVal; > >- // neuer Range? >+ // new Range? > if ( nNewRange && nNewRange != pImp->nMax ) > { > DBG( DbgOutf( "SfxProgress: range changed from %lu to %lu", >@@ -442,11 +434,12 @@ BOOL SfxProgress::SetState > > void SfxProgress::Resume() > >-/* [Beschreibung] >+/* [Description] >+ >+ Resumed the status of the display after an interrupt. > >- Nimmt die Anzeige des Status nach einer Unterbrechung wieder auf. >+ [Cross-reference] > >- [Querverweise] > <SfxProgress::Suspend()> > */ > >@@ -487,11 +480,12 @@ void SfxProgress::Resume() > > void SfxProgress::Suspend() > >-/* [Beschreibung] >+/* [Description] > >- Unterbricht die Anzeige des Status >+ Interrupts the status of the display >+ >+ [Cross-reference] > >- [Querverweise] > <SfxProgress::Resume()> > */ > >@@ -529,8 +523,8 @@ void SfxProgress::Suspend() > void SfxProgress::Lock() > { > if( pImp->pActiveProgress ) return; >- // kein Reschedule bei Embedded-Objekten, >- // da wir gegen das OLE Protokoll wehrlos sind >+ // No Reschedule for Embedded-Objects, >+ // because we are defenseless against the OLE protocol > if ( !pImp->xObjSh.Is() ) > { > for ( SfxObjectShell *pDocSh = SfxObjectShell::GetFirst(); >@@ -580,10 +574,9 @@ void SfxProgress::UnLock() > > void SfxProgress::Reschedule() > >-/* [Beschreibung] >- >- Reschedule von au"sen rufbar >+/* [Description] > >+ Reschedule, callable from the outside > */ > > { >@@ -607,17 +600,14 @@ void SfxProgress::Reschedule() > > void SfxProgress::SetWaitMode > ( >- BOOL bWait /* TRUE >- Wartecursor wird verwendet >+ BOOL bWait /* TRUE Wait-cursor is used > >- FALSE >- Es wird kein Wartecursor verwendet */ >+ FALSE Wait-cursor not used */ > ) > >-/* [Beschreibung] >- >- Wartecursor-Modus umschalten. >+/* [Description] > >+ Switch Wait-mode. > */ > > { >@@ -655,10 +645,9 @@ void SfxProgress::SetWaitMode > > BOOL SfxProgress::GetWaitMode() const > >-/* [Beschreibung] >- >- Wartecursor-Modus abfragen. >+/* [Description] > >+ Get Wait-cursor mode. > */ > > { >@@ -669,36 +658,34 @@ BOOL SfxProgress::GetWaitMode() const > > SfxProgress* SfxProgress::GetActiveProgress > ( >- SfxObjectShell* pDocSh /* <SfxObjectShell>, die nach einem laufenden >- <SfxProgress> gefragt werden soll, oder >- 0, wenn ein f"ur die gesamte Applikation >- laufender SfxProgress erfragt werden soll. >- Der Pointer braucht nur zum Zeitpunkt des >- Aufrufs g"ultig zu sein. */ >+ SfxObjectShell* pDocSh /* the <SfxObjectShell>, which should be >+ queried after a current <SfxProgress>, >+ or 0 if an current SfxProgress for the >+ entire application should be obtained. >+ The pointer only needs at the time of >+ the call to be valid. >+ */ > ) > >-/* [Beschreibung] >- >- Mit dieser Methode kann erfragt werden, ob und welcher <SfxProgress>- >- f"ur eine bestimmte Instanz von SfxObjectShell oder gar die gesamte >- Applikation zur Zeit aktiv ist. Dies kann z.B. zum Abfangen von >- Time-Out-Events etc. verwendet werden. >- >- Anstelle eines Pointer auf den SfxProgress der SfxObjectShell wird >- ggf. der auf den SfxProgress der Applikation geliefert, mit der >- Abfrage 'SfxProgress::GetActiveProgress(pMyDocSh)' wird also >- insofern vorhanden der SfxProgress von 'pMyDocSh' geliefert, >- sonst der SfxProgress der Applikation bzw. ein 0-Pointer. >+/* [Description] > >+ This method is used to check whether and which <SfxProgress> is currently >+ active for a specific instance of SfxObjectShell or even an entire >+ application. This can for example be used to check for Time-Out-Events, etc. > >- [Anmerkung] >+ Instead of a pointer to the SfxProgress the SfxObjectShell may be >+ pointed at the SfxProgress of the application, with the query >+ 'SfxProgress:: GetActiveProgress (pMyDocSh)' thus the current >+ SfxProgress of 'pMyDocSh' is delivered, otherwise the SfxProgress of >+ the application or a 0-pointer. > >- "auft kein SfxProgress an der Applikation und ebenfalls keiner an >- der angegebenen SfxObjectShell, dann wird immer 0 zur"uckgeliefert, >- auch wenn an einer anderen SfxObjectShell ein SfxProgress l"uft. >+ [Note] > >+ If no SfxProgress is running in the application and also not at the >+ specified SfxObjectShell, then this method will always return 0, >+ even if one SfxProgress runs on another SfxObjectShell. > >- [Querverweise] >+ [Cross-reference] > > <SfxApplication::GetProgress()const> > <SfxObjectShell::GetProgress()const> >@@ -736,14 +723,13 @@ void SfxProgress::LeaveLock() > > bool SfxProgress::StatusBarManagerGone_Impl > ( >- SfxStatusBarManager * // dieser <SfxStatusBarManager> wird zerst"ort >+ SfxStatusBarManager * // This <SfxStatusBarManager> will be destroyed > ) > >-/* [Beschreibung] >+/* [Description] > >- Interne Methode zum Benachrichtigen des SfxProgress, da\s der angegebene >- SfxStatusBarManger zerst"ort wird. Damit der Progress ihn loslassen >- kann. >+ Internal method for notifying the SfxProgress that the specified >+ SfxStatusBarManger will be destroyed so that the Progress can let go of it. > */ > > { >diff --git a/sfx2/source/bastyp/sfxhtml.cxx b/sfx2/source/bastyp/sfxhtml.cxx >index c0d97a0..977882b 100644 >--- a/sfx2/source/bastyp/sfxhtml.cxx >+++ b/sfx2/source/bastyp/sfxhtml.cxx >@@ -81,12 +81,12 @@ SfxHTMLParser::SfxHTMLParser( SvStream& rStream, BOOL bIsNewDoc, > nMetaTags( 0 ) > { > DBG_ASSERT( RTL_TEXTENCODING_DONTKNOW == GetSrcEncoding( ), >- "SfxHTMLParser::SfxHTMLParser: Wo kommt der ZS her?" ); >+ "SfxHTMLParser::SfxHTMLParser: From where comes ZS?" ); > DBG_ASSERT( !IsSwitchToUCS2(), > "SfxHTMLParser::SfxHTMLParser: Switch to UCS2?" ); > > // Altough the real default encoding is ISO8859-1, we use MS-1252 >- // als default encoding. >+ // as default encoding. > SetSrcEncoding( GetExtendedCompatibilityTextEncoding( RTL_TEXTENCODING_ISO_8859_1 ) ); > > // If the file starts with a BOM, switch to UCS2. >@@ -95,15 +95,15 @@ SfxHTMLParser::SfxHTMLParser( SvStream& rStream, BOOL bIsNewDoc, > > SfxHTMLParser::~SfxHTMLParser() > { >- DBG_ASSERT( !pDLMedium, "Da ist ein File-Download stehengeblieben" ); >+ DBG_ASSERT( !pDLMedium, "Here is a File Download that has got stuck" ); > delete pDLMedium; > } > > BOOL SfxHTMLParser::ParseMapOptions(ImageMap * pImageMap, > const HTMLOptions * pOptions) > { >- DBG_ASSERT( pImageMap, "ParseMapOptions: keine Image-Map" ); >- DBG_ASSERT( pOptions, "ParseMapOptions: keine Optionen" ); >+ DBG_ASSERT( pImageMap, "ParseMapOptions: No Image-Map" ); >+ DBG_ASSERT( pOptions, "ParseMapOptions: No Options" ); > > String aName; > >@@ -129,8 +129,8 @@ BOOL SfxHTMLParser::ParseAreaOptions(ImageMap * pImageMap, const String& rBaseUR > USHORT nEventMouseOver, > USHORT nEventMouseOut ) > { >- DBG_ASSERT( pImageMap, "ParseAreaOptions: keine Image-Map" ); >- DBG_ASSERT( pOptions, "ParseAreaOptions: keine Optionen" ); >+ DBG_ASSERT( pImageMap, "ParseAreaOptions: no Image-Map" ); >+ DBG_ASSERT( pOptions, "ParseAreaOptions: no Options" ); > > USHORT nShape = IMAP_OBJ_RECTANGLE; > SvULongs aCoords; >@@ -247,41 +247,42 @@ IMAPOBJ_SETEVENT: > void SfxHTMLParser::StartFileDownload( const String& rURL, int nToken, > SfxObjectShell *pSh ) > { >- DBG_ASSERT( !pDLMedium, "StartFileDwonload bei aktivem Download" ); >+ DBG_ASSERT( !pDLMedium, "StartFileDownload when active Download" ); > if( pDLMedium ) > return; > > pDLMedium = new SfxMedium( rURL, SFX_STREAM_READONLY, FALSE ); > if( pSh ) > { >- // Medium registrieren, damit abgebrochen werden kann >+ // Register the medium, so that it can be stopped. > pSh->RegisterTransfer( *pDLMedium ); > >- // Target-Frame uebertragen, damit auch javascript:-URLs >- // "geladen" werden koennen. >+ // Transfer Target-Frame, so that also the javascript:-URLs >+ // can be "loaded". > //const SfxMedium *pShMedium = pSh->GetMedium(); > //if( pShMedium ) > // pDLMedium->SetLoadTargetFrame( pShMedium->GetLoadTargetFrame() ); > } > >- // Download anstossen (Achtung: Kann auch synchron sein). >+ // Push Download (Note: Can also be synchronous). > if ( TRUE /*pMedium->GetDoneLink() == Link()*/ ) > pDLMedium->DownLoad(); > else > { >- // Downloading-Flag auf TRUE setzen. Es werden dann auch >- // Data-Available-Links, wenn wir in den Pending-Staus gelangen. >+ // Set Downloading-Flag to TRUE. When we get into the Pending-status >+ // we will then also have Data-Available-Links. > SetDownloadingFile( TRUE ); > pDLMedium->DownLoad( STATIC_LINK( this, SfxHTMLParser, FileDownloadDone ) ); > >- // Wenn das Dowsnloading-Flag noch gesetzt ist erfolgt der Download >- // asynchron. Wir gehen dann in den Pedning-Staus und warten dort. >- // Solange sind alle Aufrufe des Data-Avaialble-Link gesperrt. >+ // If the Downloading-Flag is still set downloading will be done >+ // asynchronously. We will go into Pedning-status and wait there. >+ // As long as we are there all calls to the Data-Link Avaialble are >+ // locked. > if( IsDownloadingFile() ) > { >- // Den aktuellen Zustand einfrieren und in den Pending-Status gehen. >- // Wenn der Download beendet oder abgebrochen wurde, wird ueber >- // NewDataRead ein Continue mit dem uebergeben Token angesteossen. >+ // Unfreeze the current state and go into the Pending-Status. >+ // When the download is completed or aborted, a Continue with >+ // the transfer token will be pushed by passedNewDataRead. > SaveState( nToken ); > eState = SVPAR_PENDING; > } >@@ -302,15 +303,15 @@ BOOL SfxHTMLParser::FinishFileDownload( String& rStr ) > if( bOK ) > { > SvStream* pStream = pDLMedium->GetInStream(); >- DBG_ASSERT( pStream, "Kein In-Stream vom Medium erhalten" ); >+ DBG_ASSERT( pStream, "No In-Stream received from Medium" ); > > SvMemoryStream aStream; >- if( pStream ) // HACK wegen #65563# >+ if( pStream ) // HACK due to bug #65563# > aStream << *pStream; > > aStream.Seek( STREAM_SEEK_TO_END ); > DBG_ASSERT( aStream.Tell() < STRING_MAXLEN, >- "File zu lang fuer einen String, Ende abgeschnitten" ); >+ "File too long for a string, cut off the end" ); > xub_StrLen nLen = aStream.Tell() < STRING_MAXLEN > ? (xub_StrLen)aStream.Tell() > : STRING_MAXLEN; >@@ -341,11 +342,11 @@ BOOL SfxHTMLParser::FinishFileDownload( String& rStr ) > > IMPL_STATIC_LINK( SfxHTMLParser, FileDownloadDone, void*, EMPTYARG ) > { >- // Der Download ist jetzt abgeschlossen. Ausserdem muss/darf der >- // Data-Available-Link wieder durchgelassen werden. >+ // The Download is now completed. also the Data-Available-Link >+ // must or are allowed to be passed through. > pThis->SetDownloadingFile( FALSE ); > >- // ... und einmal aufrufen, damit weitergelesen wird. >+ // ... and call once, thus will continue reading. > pThis->CallAsyncCallLink(); > > return 0; >diff --git a/sfx2/source/control/bindings.cxx b/sfx2/source/control/bindings.cxx >index 8cd3098..5fe049a 100644 >--- a/sfx2/source/control/bindings.cxx >+++ b/sfx2/source/control/bindings.cxx >@@ -50,7 +50,7 @@ > #include <comphelper/processfactory.hxx> > #include <svtools/itemdel.hxx> > >-// wg. nInReschedule >+//Includes below due to nInReschedule > #include "appdata.hxx" > #include <sfx2/bindings.hxx> > #include <sfx2/msg.hxx> >@@ -149,22 +149,22 @@ public: > SfxWorkWindow* pWorkWin; > SfxBindings* pSubBindings; > SfxBindings* pSuperBindings; >- SfxStateCacheArr_Impl* pCaches; // je ein cache fuer jede gebundene >- sal_uInt16 nCachedFunc1; // index der zuletzt gerufenen >- sal_uInt16 nCachedFunc2; // index der vorletzt gerufenen >- sal_uInt16 nMsgPos; // Message-Position, ab der zu aktualisieren ist >- SfxPopupAction ePopupAction; // in DeleteFloatinWindow() abgefragt >+ SfxStateCacheArr_Impl* pCaches; // One chache for each binding >+ sal_uInt16 nCachedFunc1; // index for the last one called >+ sal_uInt16 nCachedFunc2; // index for the second last called >+ sal_uInt16 nMsgPos; // Message-Position relative the one to be updated >+ SfxPopupAction ePopupAction; // Checked in DeleteFloatinWindow() > sal_Bool bContextChanged; >- sal_Bool bMsgDirty; // wurde ein MessageServer invalidiert? >- sal_Bool bAllMsgDirty; // wurden die MessageServer invalidiert? >- sal_Bool bAllDirty; // nach InvalidateAll >- sal_Bool bCtrlReleased; // waehrend EnterRegistrations >- AutoTimer aTimer; // fuer volatile Slots >- sal_Bool bInUpdate; // fuer Assertions >- sal_Bool bInNextJob; // fuer Assertions >- sal_Bool bFirstRound; // Erste Runde im Update >- sal_uInt16 nFirstShell; // Shell, die in erster Runde bevorzugt wird >- sal_uInt16 nOwnRegLevel; // z"ahlt die echten Locks, ohne die der SuperBindings >+ sal_Bool bMsgDirty; // Has a MessageServer been invalidated? >+ sal_Bool bAllMsgDirty; // Has a MessageServer been invalidated? >+ sal_Bool bAllDirty; // After InvalidateAll >+ sal_Bool bCtrlReleased; // while EnterRegistrations >+ AutoTimer aTimer; // for volatile Slots >+ sal_Bool bInUpdate; // for Assertions >+ sal_Bool bInNextJob; // for Assertions >+ sal_Bool bFirstRound; // First round in Update >+ sal_uInt16 nFirstShell; // Shell, the first round is prefered >+ sal_uInt16 nOwnRegLevel; // Counts the real Locks, exept those of the Super Bindings > InvalidateSlotMap m_aInvalidateSlots; // store slots which are invalidated while in update > }; > >@@ -172,10 +172,10 @@ public: > > struct SfxFoundCache_Impl > { >- sal_uInt16 nSlotId; // die Slot-Id >- sal_uInt16 nWhichId; // falls verf"ugbar die Which-Id, sonst nSlotId >- const SfxSlot* pSlot; // Pointer auf den <Master-Slot> >- SfxStateCache* pCache; // Pointer auf den StatusCache, ggf. 0 >+ sal_uInt16 nSlotId; // the Slot-Id >+ sal_uInt16 nWhichId; // If available: Which-Id, else: nSlotId >+ const SfxSlot* pSlot; // Pointer to <Master-Slot> >+ SfxStateCache* pCache; // Pointer to StatusCache, if possible NULL > > SfxFoundCache_Impl(): > nSlotId(0), >@@ -215,7 +215,7 @@ SV_IMPL_OP_PTRARR_SORT(SfxFoundCacheArr_Impl, SfxFoundCache_Impl*); > SfxBindings::SfxBindings() > : pImp(new SfxBindings_Impl), > pDispatcher(0), >- nRegLevel(1) // geht erst auf 0, wenn Dispatcher gesetzt >+ nRegLevel(1) // first becomes 0, when the Dispatcher is set > { > pImp->nMsgPos = 0; > pImp->bAllMsgDirty = sal_True; >@@ -245,21 +245,20 @@ SfxBindings::SfxBindings() > > SfxBindings::~SfxBindings() > >-/* [Beschreibung] >+/* [Description] > >- Destruktor der Klasse SfxBindings. Die eine, f"ur jede <SfxApplication> >- existierende Instanz wird von der <SfxApplication> nach Ausf"urhung >- von <SfxApplication::Exit()> automatisch zerst"ort. >+ Destructor of the SfxBindings class. The one, for each <SfxApplication> >+ existing Instance is automaticaölly destroyed by the <SfxApplication> >+ after the execution of <SfxApplication::Exit()>. > >- Noch existierende <SfxControllerItem> Instanzen, die bei dieser >- SfxBindings Instanz angemeldet sind, werden im Destruktor >- automatisch zerst"ort. Dies sind i.d.R. Floating-Toolboxen, Value-Sets >- etc. Arrays von SfxControllerItems d"urfen zu diesem Zeitpunkt nicht >- mehr exisitieren. >+ The still existing <SfxControllerItem> instances, which are registered >+ by the SfxBindings instance, are automatically destroyed in the Destructor. >+ These are usually the Floating-Toolboxen, Value-Sets >+ etc. Arrays of SfxControllerItems may at this time no longer exist. > */ > > { >- // Die SubBindings sollen ja nicht gelocked werden ! >+ // The SubBindings should not be locked! > pImp->pSubBindings = NULL; > > ENTERREGISTRATIONS(); >@@ -267,7 +266,7 @@ SfxBindings::~SfxBindings() > pImp->aTimer.Stop(); > DeleteControllers_Impl(); > >- // Caches selbst l"oschen >+ // Delete Caches > sal_uInt16 nCount = pImp->pCaches->Count(); > for ( sal_uInt16 nCache = 0; nCache < nCount; ++nCache ) > delete pImp->pCaches->GetObject(nCache); >@@ -282,19 +281,19 @@ SfxBindings::~SfxBindings() > > void SfxBindings::DeleteControllers_Impl() > { >- // in der ersten Runde den SfxPopupWindows l"oschen >+ // in the first round delete SfxPopupWindows > sal_uInt16 nCount = pImp->pCaches->Count(); > sal_uInt16 nCache; > for ( nCache = 0; nCache < nCount; ++nCache ) > { >- // merken wo man ist >+ // Remember were you are > SfxStateCache *pCache = pImp->pCaches->GetObject(nCache); > sal_uInt16 nSlotId = pCache->GetId(); > >- // SfxPopupWindow l"oschen lassen >+ // Delete SfxPopupWindow > pCache->DeleteFloatingWindows(); > >- // da der Cache verkleinert worden sein kann, wiederaufsetzen >+ // Re-align, because the cache may have been reduced > sal_uInt16 nNewCount = pImp->pCaches->Count(); > if ( nNewCount < nCount ) > { >@@ -306,13 +305,13 @@ void SfxBindings::DeleteControllers_Impl() > } > } > >- // alle Caches l"oschen >+ // Delete all Caches > for ( nCache = pImp->pCaches->Count(); nCache > 0; --nCache ) > { >- // Cache via ::com::sun::star::sdbcx::Index besorgen >+ // Get Cache via ::com::sun::star::sdbcx::Index > SfxStateCache *pCache = pImp->pCaches->GetObject(nCache-1); > >- // alle Controller in dem Cache unbinden >+ // unbind all controllers in the cache > SfxControllerItem *pNext; > for ( SfxControllerItem *pCtrl = pCache->GetItemLink(); > pCtrl; pCtrl = pNext ) >@@ -324,7 +323,7 @@ void SfxBindings::DeleteControllers_Impl() > if ( pCache->GetInternalController() ) > pCache->GetInternalController()->UnBind(); > >- // Cache l"oschen >+ // Delete Cache > if( nCache-1 < pImp->pCaches->Count() ) > delete (*pImp->pCaches)[nCache-1]; > pImp->pCaches->Remove(nCache-1, 1); >@@ -339,7 +338,7 @@ void SfxBindings::DeleteControllers_Impl() > pCtrl->ReleaseBindings(); > } > >- DBG_ASSERT( !pImp->pUnoCtrlArr->Count(), "UnoControllerItems nicht entfernt!" ); >+ DBG_ASSERT( !pImp->pUnoCtrlArr->Count(), "Do not remove UnoControllerItems!" ); > DELETEZ( pImp->pUnoCtrlArr ); > } > } >@@ -356,7 +355,7 @@ SfxPopupAction SfxBindings::GetPopupAction_Impl() const > > void SfxBindings::HidePopups( bool bHide ) > { >- // SfxPopupWindows hiden >+ // Hide SfxPopupWindows > HidePopupCtrls_Impl( bHide ); > SfxBindings *pSub = pImp->pSubBindings; > while ( pSub ) >@@ -365,7 +364,7 @@ void SfxBindings::HidePopups( bool bHide ) > pSub = pSub->pImp->pSubBindings; > } > >- // SfxChildWindows hiden >+ // Hide SfxChildWindows > DBG_ASSERT( pDispatcher, "HidePopups not allowed without dispatcher" ); > if ( pImp->pWorkWin ) > pImp->pWorkWin->HidePopups_Impl( bHide, sal_True ); >@@ -375,12 +374,12 @@ void SfxBindings::HidePopupCtrls_Impl( bool bHide ) > { > if ( bHide ) > { >- // SfxPopupWindows hiden >+ // Hide SfxPopupWindows > pImp->ePopupAction = SFX_POPUP_HIDE; > } > else > { >- // SfxPopupWindows showen >+ // Show SfxPopupWindows > pImp->ePopupAction = SFX_POPUP_SHOW; > } > >@@ -393,7 +392,7 @@ void SfxBindings::HidePopupCtrls_Impl( bool bHide ) > > void SfxBindings::Update_Impl > ( >- SfxStateCache* pCache // der upzudatende SfxStatusCache >+ SfxStateCache* pCache // The up to date SfxStatusCache > ) > { > if( pCache->GetDispatch().is() && pCache->GetItemLink() ) >@@ -407,7 +406,7 @@ void SfxBindings::Update_Impl > return; > DBG_PROFSTART(SfxBindingsUpdate_Impl); > >- // alle mit derselben Statusmethode zusammensammeln, die dirty sind >+ // gather together all with the same status method which are dirty > SfxDispatcher &rDispat = *pDispatcher; > const SfxSlot *pRealSlot = 0; > const SfxSlotServer* pMsgServer = 0; >@@ -416,10 +415,10 @@ void SfxBindings::Update_Impl > sal_Bool bUpdated = sal_False; > if ( pSet ) > { >- // Status erfragen >+ // Query Status > if ( rDispat._FillState( *pMsgServer, *pSet, pRealSlot ) ) > { >- // Status posten >+ // Post Status > const SfxInterface *pInterface = > rDispat.GetShell(pMsgServer->GetShellLevel())->GetInterface(); > for ( sal_uInt16 nPos = 0; nPos < aFound.Count(); ++nPos ) >@@ -440,8 +439,9 @@ void SfxBindings::Update_Impl > > if ( !bUpdated && pCache ) > { >- // Wenn pCache == NULL und kein SlotServer ( z.B. weil Dispatcher gelockt! ), >- // darf nat"urlich kein Update versucht werden >+ // When pCache == NULL and no SlotServer >+ // (for example due to locked Dispatcher! ), >+ // obviously do not try to update > SfxFoundCache_Impl aFoundCache( > pCache->GetId(), 0, > pRealSlot, pCache ); >@@ -475,16 +475,12 @@ void SfxBindings::AddSlotToInvalidateSlotsMap_Impl( USHORT nId ) > > void SfxBindings::Update > ( >- sal_uInt16 nId // die gebundene und upzudatende Slot-Id >+ sal_uInt16 nId // the bound and up-to-date Slot-Id > ) > { > DBG_MEMTEST(); > DBG_ASSERT( pImp->pCaches != 0, "SfxBindings not initialized" ); > >-//!!TLX: Fuehrte zu Vorlagenkatalogstillstand >-// if ( nRegLevel ) >-// return; >- > if ( pDispatcher ) > pDispatcher->Flush(); > >@@ -512,7 +508,7 @@ void SfxBindings::Update > > if ( bInternalUpdate ) > { >- // Status erfragen >+ // Query Status > const SfxSlotServer* pMsgServer = pCache->GetSlotServer(*pDispatcher, pImp->xProv); > if ( !pCache->IsControllerDirty() && > ( !pMsgServer || >@@ -570,10 +566,10 @@ void SfxBindings::Update() > > void SfxBindings::SetState > ( >- const SfxItemSet& rSet // zu setzende Status-Werte >+ const SfxItemSet& rSet // status values to be set > ) > { >- // wenn gelockt, dann nur invalidieren >+ // when locked then only invalidate > if ( nRegLevel ) > { > SfxItemIter aIter(rSet); >@@ -584,12 +580,12 @@ void SfxBindings::SetState > } > else > { >- // Status d"urfen nur angenommen werden, wenn alle Slot-Pointer gesetzt sind >+ // Status may be accepted only if all slot-pointers are set > if ( pImp->bMsgDirty ) > UpdateSlotServer_Impl(); > >- // "uber das ItemSet iterieren, falls Slot gebunden, updaten >- //! Bug: WhichIter verwenden und ggf. VoidItems hochschicken >+ // Iterate over the itemset, update if the slot bound >+ //! Bug: Use WhichIter and possibly send VoidItems up > SfxItemIter aIter(rSet); > for ( const SfxPoolItem *pItem = aIter.FirstItem(); > pItem; >@@ -599,12 +595,12 @@ void SfxBindings::SetState > GetStateCache( rSet.GetPool()->GetSlotId(pItem->Which()) ); > if ( pCache ) > { >- // Status updaten >+ // Update status > if ( !pCache->IsControllerDirty() ) > pCache->Invalidate(sal_False); > pCache->SetState( SFX_ITEM_AVAILABLE, pItem ); > >- //! nicht implementiert: Updates von EnumSlots via MasterSlots >+ //! Not implemented: Updates from EnumSlots via master slots > } > } > } >@@ -614,7 +610,7 @@ void SfxBindings::SetState > > void SfxBindings::SetState > ( >- const SfxPoolItem& rItem // zu setzender Status-Wert >+ const SfxPoolItem& rItem // Status value to be set > ) > { > if ( nRegLevel ) >@@ -623,22 +619,22 @@ void SfxBindings::SetState > } > else > { >- // Status d"urfen nur angenommen werden, wenn alle Slot-Pointer gesetzt sind >+ // Status may be accepted only if all slot-pointers are set > if ( pImp->bMsgDirty ) > UpdateSlotServer_Impl(); > >- // falls der Slot gebunden ist, updaten >+ //update if the slot bound > DBG_ASSERT( SfxItemPool::IsSlot( rItem.Which() ), > "cannot set items with which-id" ); > SfxStateCache* pCache = GetStateCache( rItem.Which() ); > if ( pCache ) > { >- // Status updaten >+ // Update Status > if ( !pCache->IsControllerDirty() ) > pCache->Invalidate(sal_False); > pCache->SetState( SFX_ITEM_AVAILABLE, &rItem ); > >- //! nicht implementiert: Updates von EnumSlots via MasterSlots >+ //! Not implemented: Updates from EnumSlots via master slots > } > } > } >@@ -656,13 +652,11 @@ SfxStateCache* SfxBindings::GetAnyStateCache_Impl( sal_uInt16 nId ) > > SfxStateCache* SfxBindings::GetStateCache > ( >- sal_uInt16 nId /* Slot-Id, deren SfxStatusCache gefunden >- werden soll */, >- sal_uInt16* pPos /* 0 bzw. Position, ab der die Bindings >- bin"ar durchsucht werden sollen. Liefert >- die Position zur"uck, an der nId gefunden >- wurde, bzw. an der es einfef"ugt werden >- w"urde. */ >+ sal_uInt16 nId /* Slot-Id, which SfxStatusCache is to be found */ >+ sal_uInt16* pPos /* NULL for instance the position from which the >+ bindings are to be searched binary. Returns the >+ position back for where the nId was found, >+ or where it was inserted. */ > ) > { > DBG_MEMTEST(); >@@ -685,11 +679,8 @@ SfxStateCache* SfxBindings::GetStateCache > > void SfxBindings::InvalidateAll > ( >- sal_Bool bWithMsg /* sal_True >- Slot-Server als ung"ultig markieren >- >- sal_False >- Slot-Server bleiben g"ultig */ >+ sal_Bool bWithMsg /* sal_True Mark Slot Server as invalid >+ sal_False Slot Server remains valid */ > ) > { > DBG_PROFSTART(SfxBindingsInvalidateAll); >@@ -700,7 +691,7 @@ void SfxBindings::InvalidateAll > if ( pImp->pSubBindings ) > pImp->pSubBindings->InvalidateAll( bWithMsg ); > >- // ist schon alles dirty gesetzt oder downing => nicht zu tun >+ // everything is already set dirty or downing => nothing to do > if ( !pDispatcher || > ( pImp->bAllDirty && ( !bWithMsg || pImp->bAllMsgDirty ) ) || > SFX_APP()->IsDowning() ) >@@ -739,8 +730,8 @@ void SfxBindings::InvalidateAll > > void SfxBindings::Invalidate > ( >- const sal_uInt16* pIds /* numerisch sortiertes 0-terminiertes Array >- von Slot-Ids (einzel, nicht als Paare!) */ >+ const sal_uInt16* pIds /* numerically sorted NULL-terminated array of >+ slot IDs (individual, not as a couple!) */ > ) > { > DBG_PROFSTART(SfxBindingsInvalidateAll); >@@ -762,27 +753,27 @@ void SfxBindings::Invalidate > if ( pImp->pSubBindings ) > pImp->pSubBindings->Invalidate( pIds ); > >- // ist schon alles dirty gesetzt oder downing => nicht zu tun >+ // everything is already set dirty or downing => nothing to do > if ( !pDispatcher || pImp->bAllDirty || SFX_APP()->IsDowning() ) > return; > >- // in immer kleiner werdenden Berichen bin"ar suchen >+ // Search binary in always smaller areas > for ( sal_uInt16 n = GetSlotPos(*pIds); > *pIds && n < pImp->pCaches->Count(); > n = GetSlotPos(*pIds, n) ) > { >- // falls SID "uberhaupt gebunden ist, den Cache invalidieren >+ // If SID is ever bound, then invalidate the cache > SfxStateCache *pCache = pImp->pCaches->GetObject(n); > if ( pCache->GetId() == *pIds ) > pCache->Invalidate(sal_False); > >- // n"achste SID >+ // Next SID > if ( !*++pIds ) > break; > DBG_ASSERT( *pIds > *(pIds-1), "pIds unsorted" ); > } > >- // falls nicht gelockt, Update-Timer starten >+ // if not enticed to start update timer > pImp->nMsgPos = 0; > if ( !nRegLevel ) > { >@@ -800,17 +791,14 @@ void SfxBindings::Invalidate > > void SfxBindings::InvalidateShell > ( >- const SfxShell& rSh /* Die <SfxShell>, deren Slot-Ids >- invalidiert werden sollen. */, >- >+ const SfxShell& rSh /* <SfxShell>, which Slot-Ids should be >+ invalidated */ > sal_Bool bDeep /* sal_True >- auch die, von der SfxShell >- ererbten Slot-Ids werden invalidert >+ also inherited slot IDs of SfxShell are invalidert > > sal_False >- die ererbten und nicht "uberladenen >- Slot-Ids werden invalidiert */ >- //! MI: z. Zt. immer bDeep >+ the inherited and not overloaded Slot-Ids were >+ invalidiert */ > ) > { > DBG_ASSERT( !pImp->bInUpdate, "SfxBindings::Invalidate while in update" ); >@@ -824,19 +812,19 @@ void SfxBindings::InvalidateShell > DBG_PROFSTART(SfxBindingsInvalidateAll); > DBG_MEMTEST(); > >- // Jetzt schon flushen, wird in GetShellLevel(rSh) sowieso gemacht; wichtig, >- // damit pImp->bAll(Msg)Dirty korrekt gesetzt ist >+ // flush now already, it is done in GetShellLevel (rsh) anyway, >+ // important so that is set correctly: pimp-> ball(Msg)Dirty > pDispatcher->Flush(); > > if ( !pDispatcher || > ( pImp->bAllDirty && pImp->bAllMsgDirty ) || > SFX_APP()->IsDowning() ) > { >- // Wenn sowieso demn"achst alle Server geholt werden >+ // if the next one is anyway, then all the servers are collected > return; > } > >- // Level finden >+ // Find Level > sal_uInt16 nLevel = pDispatcher->GetShellLevel(rSh); > if ( nLevel != USHRT_MAX ) > { >@@ -866,7 +854,7 @@ void SfxBindings::InvalidateShell > > void SfxBindings::Invalidate > ( >- sal_uInt16 nId // zu invalidierende Slot-Id >+ sal_uInt16 nId // Status value to be set > ) > { > DBG_MEMTEST(); >@@ -904,9 +892,9 @@ void SfxBindings::Invalidate > > void SfxBindings::Invalidate > ( >- sal_uInt16 nId, // zu invalidierende Slot-Id >- sal_Bool bWithItem, // StateCache clearen ? >- sal_Bool bWithMsg // SlotServer neu holen ? >+ sal_uInt16 nId, // Status value to be set >+ sal_Bool bWithItem, // Clear StateCache? >+ sal_Bool bWithMsg // Get new SlotServer? > ) > { > DBG_MEMTEST(); >@@ -995,7 +983,7 @@ sal_uInt16 SfxBindings::GetSlotPos( sal_uInt16 nId, sal_uInt16 nStartSearchAt ) > while ( !bFound && nLow <= nHigh ) > { > nMid = (nLow + nHigh) >> 1; >- DBG_ASSERT( nMid < pImp->pCaches->Count(), "bsearch ist buggy" ); >+ DBG_ASSERT( nMid < pImp->pCaches->Count(), "bsearch is buggy" ); > int nDiff = (int) nId - (int) ( ((*pImp->pCaches)[nMid])->GetId() ); > if ( nDiff < 0) > { if ( nMid == 0 ) >@@ -1271,7 +1259,8 @@ void SfxBindings::Execute_Impl( SfxRequest& aReq, const SfxSlot* pSlot, SfxShell > > if ( SFX_KIND_ENUM == pSlot->GetKind() ) > { >- // bei Enum-Slots muss der Master mit dem Wert des Enums executet werden >+ // for Enum-Slots, the Master has to be excecuted with the value >+ // of the enums Wert > const SfxSlot *pRealSlot = pShell->GetInterface()->GetRealSlot(pSlot); > const sal_uInt16 nSlotId = pRealSlot->GetSlotId(); > aReq.SetSlot( nSlotId ); >@@ -1280,12 +1269,12 @@ void SfxBindings::Execute_Impl( SfxRequest& aReq, const SfxSlot* pSlot, SfxShell > } > else if ( SFX_KIND_ATTR == pSlot->GetKind() ) > { >- // bei Attr-Slots muss der Which-Wert gemapped werden >+ // Which value has to be mapped for Attribute slots > const sal_uInt16 nSlotId = pSlot->GetSlotId(); > aReq.SetSlot( nSlotId ); > if ( pSlot->IsMode(SFX_SLOT_TOGGLE) ) > { >- // an togglebare-Attribs (Bools) wird der Wert angeheangt >+ // The value is attached to a toggleable attribute (Bools) > sal_uInt16 nWhich = pSlot->GetWhich(rPool); > SfxItemSet aSet(rPool, nWhich, nWhich, 0); > SfxStateFunc aFunc = pSlot->GetStateFnc(); >@@ -1305,7 +1294,7 @@ void SfxBindings::Execute_Impl( SfxRequest& aReq, const SfxSlot* pSlot, SfxShell > { > if ( pOldItem->ISA(SfxBoolItem) ) > { >- // wir koennen Bools toggeln >+ // we can toggle Bools > sal_Bool bOldValue = ((const SfxBoolItem *)pOldItem)->GetValue(); > SfxBoolItem *pNewItem = (SfxBoolItem*) (pOldItem->Clone()); > pNewItem->SetValue( !bOldValue ); >@@ -1315,7 +1304,7 @@ void SfxBindings::Execute_Impl( SfxRequest& aReq, const SfxSlot* pSlot, SfxShell > else if ( pOldItem->ISA(SfxEnumItemInterface) && > ((SfxEnumItemInterface *)pOldItem)->HasBoolValue()) > { >- // und Enums mit Bool-Interface >+ // and Enums with Bool-Interface > SfxEnumItemInterface *pNewItem = > (SfxEnumItemInterface*) (pOldItem->Clone()); > pNewItem->SetBoolValue(!((SfxEnumItemInterface *)pOldItem)->GetBoolValue()); >@@ -1328,21 +1317,21 @@ void SfxBindings::Execute_Impl( SfxRequest& aReq, const SfxSlot* pSlot, SfxShell > } > else if ( SFX_ITEM_DONTCARE == eState ) > { >- // ein Status-Item per Factory erzeugen >+ // Create one Status-Item for each Factory > SfxPoolItem *pNewItem = pSlot->GetType()->CreateItem(); >- DBG_ASSERT( pNewItem, "Toggle an Slot ohne ItemFactory" ); >+ DBG_ASSERT( pNewItem, "Toggle to slot without ItemFactory" ); > pNewItem->SetWhich( nWhich ); > > if ( pNewItem->ISA(SfxBoolItem) ) > { >- // wir koennen Bools toggeln >+ // we can toggle Bools > ((SfxBoolItem*)pNewItem)->SetValue( sal_True ); > aReq.AppendItem( *pNewItem ); > } > else if ( pNewItem->ISA(SfxEnumItemInterface) && > ((SfxEnumItemInterface *)pNewItem)->HasBoolValue()) > { >- // und Enums mit Bool-Interface >+ // and Enums with Bool-Interface > ((SfxEnumItemInterface*)pNewItem)->SetBoolValue(sal_True); > aReq.AppendItem( *pNewItem ); > } >@@ -1370,7 +1359,7 @@ void SfxBindings::UpdateSlotServer_Impl() > DBG_MEMTEST(); > DBG_ASSERT( pImp->pCaches != 0, "SfxBindings not initialized" ); > >- // synchronisieren >+ // synchronize > pDispatcher->Flush(); > // pDispatcher->Update_Impl(); > >@@ -1409,9 +1398,9 @@ int __cdecl CmpUS_Impl(const void *p1, const void *p2) > int CmpUS_Impl(const void *p1, const void *p2) > #endif > >-/* [Beschreibung] >+/* [Description] > >- Interne Vergleichsfunktion fuer qsort. >+ Internal Comparison function for qsort. > */ > > { >@@ -1422,16 +1411,16 @@ int CmpUS_Impl(const void *p1, const void *p2) > > SfxItemSet* SfxBindings::CreateSet_Impl > ( >- SfxStateCache*& pCache, // in: Status-Cache von nId >- const SfxSlot*& pRealSlot, // out: RealSlot zu nId >- const SfxSlotServer** pMsgServer, // out: Slot-Server zu nId >- SfxFoundCacheArr_Impl& rFound // out: Liste der Caches der Siblings >+ SfxStateCache*& pCache, // in: Status-Cache from nId >+ const SfxSlot*& pRealSlot, // out: RealSlot to nId >+ const SfxSlotServer** pMsgServer, // out: Slot-Server to nId >+ SfxFoundCacheArr_Impl& rFound // out: List of Caches for Siblings > ) > { > DBG_MEMTEST(); > DBG_ASSERT( pImp->pCaches != 0, "SfxBindings not initialized" ); > >- DBG_ASSERT( !pImp->bMsgDirty, "CreateSet_Impl mit dirty MessageServer" ); >+ DBG_ASSERT( !pImp->bMsgDirty, "CreateSet_Impl with dirty MessageServer" ); > > const SfxSlotServer* pMsgSvr = pCache->GetSlotServer(*pDispatcher, pImp->xProv); > if(!pMsgSvr || !pDispatcher) >@@ -1443,30 +1432,30 @@ SfxItemSet* SfxBindings::CreateSet_Impl > > sal_uInt16 nShellLevel = pMsgSvr->GetShellLevel(); > SfxShell *pShell = pDispatcher->GetShell( nShellLevel ); >- if ( !pShell ) // seltener GPF beim Browsen durch Update aus Inet-Notify >+ if ( !pShell ) // rare GPF when browsing through update from Inet-Notify > return 0; > > SfxItemPool &rPool = pShell->GetPool(); > >- // hole die Status-Methode, von der pCache bedient wird >+ // get the status method, which is served by the pCache > SfxStateFunc pFnc = 0; > const SfxInterface *pInterface = pShell->GetInterface(); > if ( SFX_KIND_ENUM == pMsgSvr->GetSlot()->GetKind() ) > { > pRealSlot = pInterface->GetRealSlot(pMsgSvr->GetSlot()); > pCache = GetStateCache( pRealSlot->GetSlotId() ); >-// DBG_ASSERT( pCache, "Kein Slotcache fuer den Masterslot gefunden!" ); >+// DBG_ASSERT( pCache, "No slot cache found for the master slot!" ); > } > else > pRealSlot = pMsgSvr->GetSlot(); > > // >- // Achtung: pCache darf auch NULL sein !!! >+ // Note: pCache can be NULL! > // > > pFnc = pRealSlot->GetStateFnc(); > >- // der RealSlot ist immer drin >+ // the RealSlot is always on > const SfxFoundCache_Impl *pFound = new SfxFoundCache_Impl( > pRealSlot->GetSlotId(), pRealSlot->GetWhich(rPool), pRealSlot, pCache ); > rFound.Insert( pFound ); >@@ -1475,24 +1464,23 @@ SfxItemSet* SfxBindings::CreateSet_Impl > if ( !SfxMacroConfig::IsMacroSlot( nSlot ) && !(nSlot >= SID_VERB_START && nSlot <= SID_VERB_END) ) > { > pInterface = pInterface->GetRealInterfaceForSlot( pRealSlot ); >- DBG_ASSERT (pInterface,"Slot in angegebener Shell nicht gefunden!"); >+ DBG_ASSERT (pInterface,"Slot in the given shell is not found"); > } > >- // Durchsuche die Bindings nach den von derselben Funktion bedienten Slots. >- // Daf"ur kommen nur Slots in Frage, die es im gefundenen Interface gibt. >+ // Search through the bindings for slots served by the same function. This , // will only affect slots which are present in the found interface. > >- // Die Position des Statecaches im StateCache-Array >+ // The position of the Statecaches in StateCache-Array > sal_uInt16 nCachePos = pImp->nMsgPos; > const SfxSlot *pSibling = pRealSlot->GetNextSlot(); > >- // Die Slots eines Interfaces sind im Kreis verkettet >+ // the Slots odf a interfaces ar linked in a circle > while ( pSibling > pRealSlot ) > { > SfxStateFunc pSiblingFnc=0; > SfxStateCache *pSiblingCache = > GetStateCache( pSibling->GetSlotId(), &nCachePos ); > >- // Ist der Slot "uberhaupt gecached ? >+ // Is the slot cached ? > if ( pSiblingCache ) > { > const SfxSlotServer *pServ = pSiblingCache->GetSlotServer(*pDispatcher, pImp->xProv); >@@ -1500,34 +1488,34 @@ SfxItemSet* SfxBindings::CreateSet_Impl > pSiblingFnc = pServ->GetSlot()->GetStateFnc(); > } > >- // Mu\s der Slot "uberhaupt upgedatet werden ? >+ // Does the slot have to be updated at all? > bool bInsert = pSiblingCache && pSiblingCache->IsControllerDirty(); > >- // Bugfix #26161#: Es reicht nicht, nach der selben Shell zu fragen !! >+ // Bugfix #26161#: It is not enough to ask for the same shell!! > bool bSameMethod = pSiblingCache && pFnc == pSiblingFnc; > >- // Wenn der Slot ein nicht-dirty MasterSlot ist, dann ist vielleicht >- // einer seiner Slaves dirty ? Dann wird der Masterslot doch eingef"ugt. >+ // If the slot is a non-dirty master slot, then maybe one of his slaves >+ // is dirty? Then the master slot is still inserted. > if ( !bInsert && bSameMethod && pSibling->GetLinkedSlot() ) > { >- // auch Slave-Slots auf Binding pru"fen >+ // Also check slave slots for Binding > const SfxSlot* pFirstSlave = pSibling->GetLinkedSlot(); > for ( const SfxSlot *pSlaveSlot = pFirstSlave; > !bInsert; > pSlaveSlot = pSlaveSlot->GetNextSlot()) > { >- // Die Slaves zeigen auf ihren Master >+ // the slaves points to its master > DBG_ASSERT(pSlaveSlot->GetLinkedSlot() == pSibling, >- "Falsche Master/Slave-Beziehung!"); >+ "Wrong Master/Slave relationship!"); > > sal_uInt16 nCurMsgPos = pImp->nMsgPos; > const SfxStateCache *pSlaveCache = > GetStateCache( pSlaveSlot->GetSlotId(), &nCurMsgPos ); > >- // Ist der Slave-Slot gecached und dirty ? >+ // Is the slave slot chached and dirty ? > bInsert = pSlaveCache && pSlaveCache->IsControllerDirty(); > >- // Slaves sind untereinander im Kreis verkettet >+ // Slaves are chained together in a circle > if (pSlaveSlot->GetNextSlot() == pFirstSlave) > break; > } >@@ -1545,20 +1533,20 @@ SfxItemSet* SfxBindings::CreateSet_Impl > pSibling = pSibling->GetNextSlot(); > } > >- // aus den Ranges ein Set erzeugen >+ // Create a Set from the ranges > sal_uInt16 *pRanges = new sal_uInt16[rFound.Count() * 2 + 1]; > int j = 0; > USHORT i = 0; > while ( i < rFound.Count() ) > { > pRanges[j++] = rFound[i]->nWhichId; >- // aufeinanderfolgende Zahlen >+ // consecutive numbers > for ( ; i < rFound.Count()-1; ++i ) > if ( rFound[i]->nWhichId+1 != rFound[i+1]->nWhichId ) > break; > pRanges[j++] = rFound[i++]->nWhichId; > } >- pRanges[j] = 0; // terminierende NULL >+ pRanges[j] = 0; // terminating NULL > SfxItemSet *pSet = new SfxItemSet(rPool, pRanges); > delete [] pRanges; > DBG_PROFSTOP(SfxBindingsCreateSet); >@@ -1569,7 +1557,7 @@ SfxItemSet* SfxBindings::CreateSet_Impl > > void SfxBindings::UpdateControllers_Impl > ( >- const SfxInterface* pIF, // das diese Id momentan bedienende Interface >+ const SfxInterface* pIF, // Id of the current serving Interface > const SfxFoundCache_Impl* pFound, // Cache, Slot, Which etc. > const SfxPoolItem* pItem, // item to send to controller > SfxItemState eState // state of item >@@ -1583,18 +1571,18 @@ void SfxBindings::UpdateControllers_Impl > const SfxSlot* pSlot = pFound->pSlot; > DBG_ASSERT( !pCache || !pSlot || pCache->GetId() == pSlot->GetSlotId(), "SID mismatch" ); > >- // insofern gebunden, die Controller f"uer den Slot selbst updaten >+ // bound until now, the Controller to update the Slot. > if ( pCache && pCache->IsControllerDirty() ) > { > if ( SFX_ITEM_DONTCARE == eState ) > { >- // uneindeuting >+ // ambiguous > pCache->SetState( SFX_ITEM_DONTCARE, (SfxPoolItem *)-1 ); > } > else if ( SFX_ITEM_DEFAULT == eState && > pFound->nWhichId > SFX_WHICH_MAX ) > { >- // kein Status oder Default aber ohne Pool >+ // no Status or Default but without Pool > SfxVoidItem aVoid(0); > pCache->SetState( SFX_ITEM_UNKNOWN, &aVoid ); > } >@@ -1606,8 +1594,8 @@ void SfxBindings::UpdateControllers_Impl > > DBG_PROFSTOP(SfxBindingsUpdateCtrl1); > >- // insofern vorhanden und gebunden, die Controller f"uer Slave-Slots >- // (Enum-Werte) des Slots updaten >+ // Update the slots for so far available and bound Controllers for >+ // Slave-Slots (Enum-value) > DBG_PROFSTART(SfxBindingsUpdateCtrl2); > DBG_ASSERT( !pSlot || 0 == pSlot->GetLinkedSlot() || !pItem || > pItem->ISA(SfxEnumItemInterface), >@@ -1615,7 +1603,7 @@ void SfxBindings::UpdateControllers_Impl > const SfxSlot *pFirstSlave = pSlot ? pSlot->GetLinkedSlot() : 0; > if ( pIF && pFirstSlave) > { >- // Items auf EnumItem casten >+ // Items cast on EnumItem > const SfxEnumItemInterface *pEnumItem = > PTR_CAST(SfxEnumItemInterface,pItem); > if ( eState == SFX_ITEM_AVAILABLE && !pEnumItem ) >@@ -1623,14 +1611,14 @@ void SfxBindings::UpdateControllers_Impl > else > eState = SfxControllerItem::GetItemState( pEnumItem ); > >- // "uber alle Slaves-Slots iterieren >+ // Iterate over all Slaves-Slots > for ( const SfxSlot *pSlave = pFirstSlave; pSlave; pSlave = pSlave->GetNextSlot() ) > { >- DBG_ASSERT(pSlave, "Falsche SlaveSlot-Verkettung!"); >+ DBG_ASSERT(pSlave, "Wrong SlaveSlot binding!"); > DBG_ASSERT(SFX_KIND_ENUM == pSlave->GetKind(),"non enum slaves aren't allowed"); > DBG_ASSERT(pSlave->GetMasterSlotId() == pSlot->GetSlotId(),"falscher MasterSlot!"); > >- // ist die Funktion gebunden? >+ // Binding exist for function ? > SfxStateCache *pEnumCache = GetStateCache( pSlave->GetSlotId() ); > if ( pEnumCache ) > { >@@ -1655,14 +1643,14 @@ void SfxBindings::UpdateControllers_Impl > } > else if ( SFX_ITEM_AVAILABLE == eState ) > { >- // enum-Wert ermitteln >+ // Determine enum value > sal_uInt16 nValue = pEnumItem->GetEnumValue(); > SfxBoolItem aBool( pFound->nWhichId, pSlave->GetValue() == nValue ); > pEnumCache->SetState(SFX_ITEM_AVAILABLE, &aBool); > } > else > { >- // uneindeuting >+ // ambiguous > pEnumCache->SetState( SFX_ITEM_DONTCARE, (SfxPoolItem *)-1 ); > } > } >@@ -1681,8 +1669,8 @@ void SfxBindings::UpdateControllers_Impl > IMPL_LINK( SfxBindings, NextJob_Impl, Timer *, pTimer ) > { > #ifdef DBG_UTIL >- // on Windows very often C++ Exceptions (GPF etc.) are caught by MSVCRT or another MS library >- // try to get them here >+ // on Windows very often C++ Exceptions (GPF etc.) are caught by MSVCRT >+ // or another MS library try to get them here > try > { > #endif >@@ -1720,7 +1708,7 @@ IMPL_LINK( SfxBindings, NextJob_Impl, Timer *, pTimer ) > return sal_True; > } > >- // gfs. alle Server aktualisieren / geschieht in eigener Zeitscheibe >+ // if possible Update all server / happens in its own time slice > if ( pImp->bMsgDirty ) > { > UpdateSlotServer_Impl(); >@@ -1753,8 +1741,6 @@ IMPL_LINK( SfxBindings, NextJob_Impl, Timer *, pTimer ) > sal_Bool bSkip = sal_False; > if ( pImp->bFirstRound ) > { >- // Falls beim Update eine Shell vorgezogen werden soll, >- // kommt in einer ersten Update-Runde nur diese dran > const SfxSlotServer *pMsgServer = > pCache->GetSlotServer(*pDispatcher, pImp->xProv); > if ( pMsgServer && >@@ -1778,8 +1764,9 @@ IMPL_LINK( SfxBindings, NextJob_Impl, Timer *, pTimer ) > bJobDone = pImp->nMsgPos >= nCount; > if ( bJobDone && pImp->bFirstRound ) > { >- // Update der bevorzugten Shell ist gelaufen, nun d"urfen >- // auch die anderen >+ >+ // Update of the preferred shell has been done, now may >+ // also the others shells be updated > bJobDone = sal_False; > pImp->bFirstRound = sal_False; > pImp->nMsgPos = 0; >@@ -1814,7 +1801,7 @@ IMPL_LINK( SfxBindings, NextJob_Impl, Timer *, pTimer ) > else > pImp->aTimer.Stop(); > >- // Update-Runde ist beendet >+ // Update round is finished > pImp->bInNextJob = sal_False; > Broadcast(SfxSimpleHint(SFX_HINT_UPDATEDONE)); > DBG_PROFSTOP(SfxBindingsNextJob_Impl); >@@ -1858,15 +1845,15 @@ sal_uInt16 SfxBindings::EnterRegistrations(const char *pFile, int nLine) > DbgTrace( aMsg.GetBuffer() ); > #endif > >- // Wenn Bindings gelockt werden, auch SubBindings locken >+ // When bindings are locked, also lock sub bindings. > if ( pImp->pSubBindings ) > { > pImp->pSubBindings->ENTERREGISTRATIONS(); > >- // Dieses EnterRegistrations ist f"ur die SubBindings kein "echtes" >+ // These EnterRegistrations are not "real" for the SubBindings > pImp->pSubBindings->pImp->nOwnRegLevel--; > >- // Bindings synchronisieren >+ // Synchronize Bindings > pImp->pSubBindings->nRegLevel = nRegLevel + pImp->pSubBindings->pImp->nOwnRegLevel + 1; > } > >@@ -1882,7 +1869,7 @@ sal_uInt16 SfxBindings::EnterRegistrations(const char *pFile, int nLine) > pImp->nCachedFunc1 = 0; > pImp->nCachedFunc2 = 0; > >- // merken, ob ganze Caches verschwunden sind >+ // Mark if the all of the Caches have dissapered. > pImp->bCtrlReleased = sal_False; > } > >@@ -1899,14 +1886,14 @@ void SfxBindings::LeaveRegistrations( sal_uInt16 nLevel, const char *pFile, int > DBG_ASSERT( nRegLevel, "Leave without Enter" ); > DBG_ASSERT( nLevel == USHRT_MAX || nLevel == nRegLevel, "wrong Leave" ); > >- // Nur wenn die SubBindings noch von den SuperBindings gelockt sind, diesen Lock entfernen >- // ( d.h. wenn es mehr Locks als "echte" Locks dort gibt ) >+ // Only when the SubBindings are still locked by the Superbindings, >+ // remove this lock (i.e. if there are more locks than "real" ones) > if ( pImp->pSubBindings && pImp->pSubBindings->nRegLevel > pImp->pSubBindings->pImp->nOwnRegLevel ) > { >- // Bindings synchronisieren >+ // Synchronize Bindings > pImp->pSubBindings->nRegLevel = nRegLevel + pImp->pSubBindings->pImp->nOwnRegLevel; > >- // Dieses LeaveRegistrations ist f"ur die SubBindings kein "echtes" >+ // This LeaveRegistrations is not "real" for SubBindings > pImp->pSubBindings->pImp->nOwnRegLevel++; > pImp->pSubBindings->LEAVEREGISTRATIONS(); > } >@@ -1929,25 +1916,25 @@ void SfxBindings::LeaveRegistrations( sal_uInt16 nLevel, const char *pFile, int > #ifndef slow > SfxViewFrame* pFrame = pDispatcher->GetFrame(); > >- // ggf unbenutzte Caches entfernen bzw. PlugInInfo aufbereiten >+ // If possible remove unused Caches, for example prepare PlugInInfo > if ( pImp->bCtrlReleased ) > { > for ( sal_uInt16 nCache = pImp->pCaches->Count(); nCache > 0; --nCache ) > { >- // Cache via ::com::sun::star::sdbcx::Index besorgen >+ // Get Cache via ::com::sun::star::sdbcx::Index > SfxStateCache *pCache = pImp->pCaches->GetObject(nCache-1); > >- // kein Controller mehr interessiert >+ // No interested Controller present > if ( pCache->GetItemLink() == 0 && !pCache->GetInternalController() ) > { >- // Cache entfernen. Safety: first remove and then delete >+ // Remove Cache. Safety: first remove and then delete > SfxStateCache* pSfxStateCache = (*pImp->pCaches)[nCache-1]; > pImp->pCaches->Remove(nCache-1, 1); > delete pSfxStateCache; > } > else > { >- // neue Controller mit den alten Items benachrichtigen >+ // new controller to notify the old items > //!pCache->SetCachedState(); > } > } >@@ -1994,7 +1981,7 @@ const SfxSlot* SfxBindings::GetSlot(sal_uInt16 nSlotId) > DBG_MEMTEST(); > DBG_ASSERT( pImp->pCaches != 0, "SfxBindings not initialized" ); > >- // syncronisieren >+ // synchronizing > pDispatcher->Flush(); > if ( pImp->bMsgDirty ) > UpdateSlotServer_Impl(); >@@ -2038,7 +2025,7 @@ void SfxBindings::SetDispatcher( SfxDispatcher *pDisp ) > { > if ( pImp->pSubBindings && pImp->pSubBindings->pDispatcher != pOldDispat ) > { >- DBG_ERROR( "SubBindings vor Aktivieren schon gesetzt!" ); >+ DBG_ERROR( "SubBindings already set before activating!" ); > pImp->pSubBindings->ENTERREGISTRATIONS(); > } > LEAVEREGISTRATIONS(); >@@ -2048,7 +2035,7 @@ void SfxBindings::SetDispatcher( SfxDispatcher *pDisp ) > ENTERREGISTRATIONS(); > if ( pImp->pSubBindings && pImp->pSubBindings->pDispatcher != pOldDispat ) > { >- DBG_ERROR( "SubBindings im Deaktivieren immer noch gesetzt!" ); >+ DBG_ERROR( "SubBindings still set even when deactivating!" ); > pImp->pSubBindings->LEAVEREGISTRATIONS(); > } > } >@@ -2086,10 +2073,10 @@ void SfxBindings::StartUpdate_Impl( sal_Bool bComplete ) > pImp->pSubBindings->StartUpdate_Impl( bComplete ); > > if ( !bComplete ) >- // Update darf unterbrochen werden >+ // Update may be interrupted > NextJob_Impl(&pImp->aTimer); > else >- // alle Slots am St"uck updaten >+ // Update all slots in a row > NextJob_Impl(0); > } > >@@ -2190,14 +2177,14 @@ SfxItemState SfxBindings::QueryState( sal_uInt16 nSlot, SfxPoolItem* &rpState ) > } > } > >- // Dann am Dispatcher testen; da die von dort zur"uckgegebenen Items immer >- // DELETE_ON_IDLE sind, mu\s eine Kopie davon gezogen werden, um einen >- // Eigent"umer"ubergang zu erm"oglichen >+ // Then test at the dispatcher to check if the returned items from >+ // there are always DELETE_ON_IDLE, a copy of it has to be made in >+ // order to allow for transition of ownership. > const SfxPoolItem *pItem = NULL; > SfxItemState eState = pDispatcher->QueryState( nSlot, pItem ); > if ( eState == SFX_ITEM_SET ) > { >- DBG_ASSERT( pItem, "SFX_ITEM_SET aber kein Item!" ); >+ DBG_ASSERT( pItem, "SFX_ITEM_SET but no item!" ); > if ( pItem ) > rpState = pItem->Clone(); > } >diff --git a/sfx2/source/control/ctrlitem.cxx b/sfx2/source/control/ctrlitem.cxx >index 34de0d9..1e1cf4e 100644 >--- a/sfx2/source/control/ctrlitem.cxx >+++ b/sfx2/source/control/ctrlitem.cxx >@@ -46,11 +46,11 @@ DBG_NAME(SfxControllerItem); > > void SfxControllerItem::CheckConfigure_Impl( ULONG nType ) > { >- // echter Slot? (also kein Separator etc.) >+ // Real Slot? (i.e. no Separator etc.) > if ( !nId ) > return; > >- // ist die Id "uberhaupt in 'nType' konfigurierbar? >+ // is the ID configurable at all in 'nType'? > const SfxSlot *pSlot = SFX_SLOTPOOL().GetSlot(nId); > DBG_ASSERTWARNING( pSlot, "SfxControllerItem: binding not existing slot" ); > if ( pSlot && !pSlot->IsMode(nType) ) >@@ -64,7 +64,6 @@ void SfxControllerItem::CheckConfigure_Impl( ULONG nType ) > #endif > > //-------------------------------------------------------------------- >- > // returns the next registered SfxControllerItem with the same id > > SfxControllerItem* SfxControllerItem::GetItemLink() >@@ -75,7 +74,6 @@ SfxControllerItem* SfxControllerItem::GetItemLink() > } > > //-------------------------------------------------------------------- >- > // returns TRUE if this binding is really bound to a function > > BOOL SfxControllerItem::IsBound() const >@@ -86,23 +84,21 @@ BOOL SfxControllerItem::IsBound() const > } > > //-------------------------------------------------------------------- >- > // returns the associated function-id or 0 if none > > // USHORT SfxControllerItem::GetId() const; > > //==================================================================== >- > // registeres with the id at the bindings > > void SfxControllerItem::Bind( USHORT nNewId, SfxBindings *pBindinx ) > { > DBG_MEMTEST(); > DBG_CHKTHIS(SfxControllerItem, 0); >- DBG_ASSERT(pBindings || pBindinx, "Keine Bindings"); >+ DBG_ASSERT(pBindings || pBindinx, "No Bindings"); > > if ( IsBound() ) { >- DBG_ASSERT(pBindings, "Keine Bindings"); >+ DBG_ASSERT(pBindings, "No Bindings"); > pBindings->Release(*this); > } > >@@ -118,10 +114,10 @@ void SfxControllerItem::BindInternal_Impl( USHORT nNewId, SfxBindings *pBindinx > { > DBG_MEMTEST(); > DBG_CHKTHIS(SfxControllerItem, 0); >- DBG_ASSERT(pBindings || pBindinx, "Keine Bindings"); >+ DBG_ASSERT(pBindings || pBindinx, "No Bindings"); > > if ( IsBound() ) { >- DBG_ASSERT(pBindings, "Keine Bindings"); >+ DBG_ASSERT(pBindings, "No Bindings"); > pBindings->Release(*this); > } > >@@ -138,14 +134,14 @@ void SfxControllerItem::BindInternal_Impl( USHORT nNewId, SfxBindings *pBindinx > > void SfxControllerItem::UnBind() > >-/* [Beschreibung] >+/* [Description] > >- "ost die Verbindung dieses SfxControllerItems mit der SfxBindings-Instanz, >- an der es zur Zeit gebunden ist. Ab diesem Zeitpunkt erh"alt es keine >- Statusbenachrichtigungen (<SfxControllerItem::StateChented()>) mehr. >+ Unbinds the connection of this SfxControllerItems with the SfxBindings >+ instance with which it to time is bound. From this time on it does not >+ receive any status notifications (<SfxControllerItem::StateChented()>) >+ anymore. > >- >- [Querverweise] >+ [Cross-reference] > > <SfxControllerItem::ReBind()> > <SfxControllerItem::ClearCache()> >@@ -153,7 +149,7 @@ void SfxControllerItem::UnBind() > { > DBG_MEMTEST(); > DBG_CHKTHIS(SfxControllerItem, 0); >- DBG_ASSERT(pBindings, "Keine Bindings"); >+ DBG_ASSERT(pBindings, "No Bindings"); > DBG_ASSERT( IsBound(), "unbindings unbound SfxControllerItem" ); > > pBindings->Release(*this); >@@ -164,14 +160,13 @@ void SfxControllerItem::UnBind() > > void SfxControllerItem::ReBind() > >-/* [Beschreibung] >- >- Binded dieses SfxControllerItem wieder an die SfxBindings-Instanz, >- an der es zuletzt gebunden war. Ab diesem Zeitpunkt erh"alt es wieder >- Statusbenachrichtigungen (<SfxControllerItem::StateChented()>). >+/* [Description] > >+ Binds this SfxControllerItem with the SfxBindings instance again, >+ with which it was last bound. From this time on it does receive status >+ notifications (<SfxControllerItem::StateChented()>) again. > >- [Querverweise] >+ [Cross-reference] > > <SfxControllerItem::UnBind()> > <SfxControllerItem::ClearCache()> >@@ -180,7 +175,7 @@ void SfxControllerItem::ReBind() > { > DBG_MEMTEST(); > DBG_CHKTHIS(SfxControllerItem, 0); >- DBG_ASSERT(pBindings, "Keine Bindings"); >+ DBG_ASSERT(pBindings, "No Bindings"); > DBG_ASSERT( !IsBound(), "bindings rebound SfxControllerItem" ); > > pBindings->Register(*this); >@@ -190,11 +185,11 @@ DBG_CHKTHIS(SfxControllerItem, 0); > > void SfxControllerItem::UpdateSlot() > >-/* [Beschreibung] >+/* [Description] > >- Holt den Status 'hart' neu. >+ Get the Status again. > >- [Querverweise] >+ [Cross-reference] > > <SfxControllerItem::ClearCache()> > */ >@@ -202,7 +197,7 @@ void SfxControllerItem::UpdateSlot() > { > DBG_MEMTEST(); > DBG_CHKTHIS(SfxControllerItem, 0); >- DBG_ASSERT(pBindings, "Keine Bindings"); >+ DBG_ASSERT(pBindings, "No Bindings"); > > pBindings->Update( GetId() ); > } >@@ -211,24 +206,20 @@ void SfxControllerItem::UpdateSlot() > > void SfxControllerItem::ClearCache() > >-/* [Beschreibung] >- >- "oscht den Status-Cache f"ur dieses SfxControllerItem. D.h. beim >- n"achsten Status-Update wird das <SfxPoolItem> auf jeden Fall geschickt, >- auch wenn zuvor dasselbe geschickt wurde. Dies wird ben"otigt, wenn >- ein Controller umgeschaltet werden kann und sich diesen Status >- selbst merkt. >+/* [Description] > >+ Clears the cache status for this SfxControllerItem. That is by the next >+ status update is the <SfxPoolItem> sent in any case, even if the same was >+ sent before. This is needed if a controller can be switched on and note >+ that status themselves. > >- [Beispiel] >+ [Example] > >- Der Kombi-Controller f"ur das Einstellen des Fl"achentyps und der >- konkreten Auspr"agung (Farbe blau oder Schraffur X) kann im Typ >- umgestellt werden, wird jedoch dann bei der n"achsten Selektion >- wieder benachrichtigt, auch wenn es dieselben Daten sind. >+ The combined controller for adjusting the surface type and the concrete >+ expression (blue color, or hatching X) can be changed in type, but is then >+ notified of the next selection again, even if it the same data. > >- >- [Querverweise] >+ [Cross-reference] > > <SfxControllerItem::UnBind()> > <SfxControllerItem::ReBind()> >@@ -238,13 +229,12 @@ void SfxControllerItem::ClearCache() > { > DBG_MEMTEST(); > DBG_CHKTHIS(SfxControllerItem, 0); >- DBG_ASSERT(pBindings, "Keine Bindings"); >+ DBG_ASSERT(pBindings, "No Bindings"); > > pBindings->ClearCache_Impl( GetId() ); > } > > //-------------------------------------------------------------------- >- > // replaces the successor in the list of bindings of the same id > > SfxControllerItem* SfxControllerItem::ChangeItemLink( SfxControllerItem* pNewLink ) >@@ -257,7 +247,6 @@ SfxControllerItem* SfxControllerItem::ChangeItemLink( SfxControllerItem* pNewLin > } > > //-------------------------------------------------------------------- >- > // changes the id of unbound functions (e.g. for sub-menu-ids) > > void SfxControllerItem::SetId( USHORT nItemId ) >@@ -270,7 +259,7 @@ void SfxControllerItem::SetId( USHORT nItemId ) > > //-------------------------------------------------------------------- > >-// creates a atomic item for a controller without registration >+// creates a atomic item for a controller without registration. > > SfxControllerItem::SfxControllerItem(): > nId(0), >@@ -282,7 +271,6 @@ SfxControllerItem::SfxControllerItem(): > } > > //-------------------------------------------------------------------- >- > // creates a representation of the function nId and registeres it > > SfxControllerItem::SfxControllerItem( USHORT nID, SfxBindings &rBindings ): >@@ -296,7 +284,6 @@ SfxControllerItem::SfxControllerItem( USHORT nID, SfxBindings &rBindings ): > } > > //-------------------------------------------------------------------- >- > // unregisteres the item in the bindings > > SfxControllerItem::~SfxControllerItem() >@@ -311,27 +298,29 @@ SfxControllerItem::~SfxControllerItem() > > void SfxControllerItem::StateChanged > ( >- USHORT , // <SID> des ausl"osenden Slot >- SfxItemState , // <SfxItemState> von 'pState' >- const SfxPoolItem* // Slot-Status, ggf. 0 oder IsInvalidItem() >+ USHORT, // <SID> of the triggering slot >+ SfxItemState, // <SfxItemState> of 'pState' >+ const SfxPoolItem* // Slot-Status, NULL or IsInvalidItem() > ) > >-/* [Beschreibung] >+/* [Description] > >- Diese virtuelle Methode wird vom SFx gerufen, um <SfxControllerItem>s >- dar"uber zu benachrichtigen, da\s sich der Status des Slots 'nSID' >- ge"andert hat. Der neue Wert sowie der von diesem Wert ermittelte >- Status wird als 'pState' bzw. 'eState' mitgegeben. >+ This virtual method is called by the SFx to inform the <SfxControllerItem>s >+ is about that state of the slots 'NSID' has changed. The new value and the >+ value determined by this status is given as 'pState' or 'eState'. > >- Der Status eines Slots kann sich "andern, wenn z.B. das MDI-Fenster >- gewechselt wird oder der Slot explizit mit <SfxBindings::Invalidate()> >- invalidiert wurde. >+ The status of a slot may change, for example when the MDI window is >+ switched or when the slot was invalidated explicitly with >+ <SfxBindings::Invalidate()>. > > Achtung! Die Methode wird nicht gerufen, wenn der Slot ung"ultig wurde, > danach jedoch wieder denselben Wert angenommen hat. > >- Diese Basisklasse braucht nicht gerufen zu werden, weitere Zwischenstufen >- jedoch (z.B. <SfxToolboxControl>) sollten gerufen werden. >+ Beware! The method is not called when the slot is invalid, however >+ has again assumed the same value. >+ >+ This base class need not be called, further interim steps however >+ (eg <SfxToolboxControl> ) should be called. > */ > > { >@@ -351,9 +340,9 @@ void SfxControllerItem::DeleteFloatingWindow() > > void SfxStatusForwarder::StateChanged > ( >- USHORT nSID, // <SID> des ausl"osenden Slot >- SfxItemState eState, // <SfxItemState> von 'pState' >- const SfxPoolItem* pState // Slot-Status, ggf. 0 oder IsInvalidItem() >+ USHORT nSID, // <SID> of the triggering slot >+ SfxItemState eState, // <SfxItemState> of 'pState' >+ const SfxPoolItem* pState // Slot-Status, NULL or IsInvalidItem() > ) > > { >@@ -374,37 +363,35 @@ SfxStatusForwarder::SfxStatusForwarder( > > SfxItemState SfxControllerItem::GetItemState > ( >- const SfxPoolItem* pState /* Pointer auf das <SfxPoolItem>, dessen >- Status erfragt werden soll. */ >+ const SfxPoolItem* pState /* Pointer to <SfxPoolItem>, which >+ Status should be queried. */ > ) > >-/* [Beschreibung] >+/* [Description] > >- Statische Methode zum Ermitteln des Status des SfxPoolItem-Pointers, >- in der Methode <SfxControllerItem::StateChanged(const SfxPoolItem*)> >- zu verwenden. >+ Static method to determine the status of the SfxPoolItem-Pointers, to be >+ used in the method <SfxControllerItem::StateChanged(const SfxPoolItem*)> > >- [R"uckgabewert] >+ [Return value] > > SfxItemState SFX_ITEM_UNKNOWN >- Enabled, aber keine weitere Statusinformation >- verf"ugbar. Typisch f"ur <Slot>s, die allenfalls >- zeitweise disabled sind, aber ihre Darstellung sonst >- nicht "andern. >+ Enabled, but no further status information available. >+ Typical for <Slot>s, which anyway are sometimes >+ disabled, but otherwise do not change their appearance. > > SFX_ITEM_DISABLED >- Disabled und keine weiter Statusinformation >- verf"ugbar. Alle anderen ggf. angezeigten Werte sollten >- auf den Default zur"uckgesetzt werden. >+ Disabled and no further status information available. >+ All other values that may appear should be reset to >+ default. > > SFX_ITEM_DONTCARE >- Enabled aber es waren nur uneindeutige Werte >- verf"ugbar (also keine, die abgefragt werden k"onnen). >+ Enabled but there were only ambiguous values available >+ (i.e. non that can be queried). > > SFX_ITEM_AVAILABLE >- Enabled und mit verf"ugbarem Wert, der von 'pState' >- erfragbar ist. Der Typ ist dabei im gesamten >- Programm eindeutig und durch den Slot festgelegt. >+ Enabled and with available values, which are queried >+ by 'pState'. The Type is thus clearly defined in the >+ entire Program and specified through the Slot. > */ > > { >@@ -421,10 +408,10 @@ SfxItemState SfxControllerItem::GetItemState > > SfxMapUnit SfxControllerItem::GetCoreMetric() const > >-/* [Beschreibung] >+/* [Description] > >- Holt vom zust"andigen Pool die Ma\seinheit ab, in der das Status-Item >- vorliegt. >+ Gets the measurement unit from the competent pool, in which the Status >+ item exist. > */ > > { >@@ -462,5 +449,4 @@ SfxMapUnit SfxControllerItem::GetCoreMetric() const > #pragma optimize("g",off) > #endif > >- > /* vim:set shiftwidth=4 softtabstop=4 expandtab: */ >diff --git a/sfx2/source/control/dispatch.cxx b/sfx2/source/control/dispatch.cxx >index 4adc4e4..0d5f773 100644 >--- a/sfx2/source/control/dispatch.cxx >+++ b/sfx2/source/control/dispatch.cxx >@@ -41,7 +41,7 @@ > #include <svtools/ttprops.hxx> > #include <stdio.h> > #include <stdarg.h> >-#include <stdlib.h> // wg. bsearch >+#include <stdlib.h> // due to bsearch > > #define _SVSTDARR_ULONGS > #include <svl/svstdarr.hxx> >@@ -49,7 +49,7 @@ > #include <com/sun/star/frame/XLayoutManager.hpp> > #include <com/sun/star/beans/XPropertySet.hpp> > >-// wg. nAutoPageID >+// due to nAutoPageID > #include "appdata.hxx" > #include "sfxhelp.hxx" > #include <sfx2/dispatch.hxx> >@@ -121,8 +121,8 @@ IMPL_OBJSTACK(SfxToDoStack_Impl, SfxToDo_Impl); > > struct SfxObjectBars_Impl > { >- sal_uInt32 nResId; // Resource - und ConfigId der Toolbox >- sal_uInt16 nMode; // spezielle Sichtbarkeitsflags >+ sal_uInt32 nResId; // Resource - and ConfigId of the Toolbox >+ sal_uInt16 nMode; // special visibility flags > String aName; > SfxInterface* pIFace; > >@@ -136,35 +136,36 @@ struct SfxObjectBars_Impl > struct SfxDispatcher_Impl > { > SfxRequestPtrArray aReqArr; >- const SfxSlotServer* pCachedServ1; // zuletzt gerufene Message >- const SfxSlotServer* pCachedServ2; // vorletzt gerufene Message >- SfxShellStack_Impl aStack; // aktive Funktionalitaet >- Timer aTimer; // fuers flushen >- SfxToDoStack_Impl aToDoStack; // nicht abgearb. Push/Pop >- SfxViewFrame* pFrame; // 0 oder zugeh"or. Frame >- SfxDispatcher* pParent; // z.B. AppDispatcher, ggf. 0 >- SfxHintPosterRef xPoster; // asynchrones Execute >- sal_Bool bFlushing; // sal_True waehrend Flush //? >- sal_Bool bUpdated; // Update_Impl gelaufen >- sal_Bool bLocked; // kein Execute >- sal_Bool bInvalidateOnUnlock;// da fragte jemand >- sal_Bool bActive; // nicht verwechseln mit gesetzt! >- sal_Bool* pInCallAliveFlag; // dem Stack den Dtor anzeigen >+ const SfxSlotServer* pCachedServ1; // last called message >+ const SfxSlotServer* pCachedServ2; // penultimate called Message >+ SfxShellStack_Impl aStack; // active functionality >+ Timer aTimer; // for Flush >+ SfxToDoStack_Impl aToDoStack; // not processed Push/Pop >+ SfxViewFrame* pFrame; // NULL or associated Frame >+ SfxDispatcher* pParent; // AppDispatcher, NULL if possible >+ SfxHintPosterRef xPoster; // Execute asynchronous >+ sal_Bool bFlushing; // sal_True during Flush //? >+ sal_Bool bUpdated; // Update_Impl has run >+ sal_Bool bLocked; // No Execute >+ sal_Bool bInvalidateOnUnlock; // because someone asked >+ sal_Bool bActive; // not to be confused with set! >+ sal_Bool* pInCallAliveFlag; // view the Destructor Stack > SfxObjectBars_Impl aObjBars[SFX_OBJECTBAR_MAX]; > SfxObjectBars_Impl aFixedObjBars[SFX_OBJECTBAR_MAX]; > SvULongs aChildWins; > sal_uInt16 nActionLevel; // in EnterAction > sal_uInt32 nEventId; // EventId UserEvent >- sal_Bool bUILocked; // Update abgeklemmt (!zappeln) >- sal_Bool bNoUI; // UI nur vom Parent Dispatcher >- sal_Bool bReadOnly; // Dokument ist ReadOnly >- sal_Bool bQuiet; // nur parent dispatcher verwenden >- sal_Bool bModal; // nur Slots vom Parent-Dispatcher >- >- sal_Bool bFilterEnabling; // sal_True=filter enabled slots, 2==ReadOnlyDoc uebersteuert >- sal_uInt16 nFilterCount; // Anzahl der SIDs in pFilterSIDs >- const sal_uInt16* pFilterSIDs; // sortiertes Array von SIDs >- sal_uInt16 nStandardMode; // ExecuteMode f. PlugInDispatcher >+ sal_Bool bUILocked; // Update disconnected (no flicker) >+ sal_Bool bNoUI; // UI only from Parent Dispatcher >+ sal_Bool bReadOnly; // Document is ReadOnly >+ sal_Bool bQuiet; // Only use parent dispatcher >+ sal_Bool bModal; // Only slots from parent dispatcher >+ >+ sal_Bool bFilterEnabling; // sal_True=filter enabled slots, >+ // 2==ReadOnlyDoc overturned >+ sal_uInt16 nFilterCount; // Number of SIDs in pFilterSIDs >+ const sal_uInt16* pFilterSIDs; // sorted Array of SIDs >+ sal_uInt16 nStandardMode; // ExecuteMode from PlugInDispatcher > SvUShorts* pDisableList; > sal_uInt32 nDisableFlags; > }; >@@ -180,18 +181,17 @@ struct SfxDispatcher_Impl > //==================================================================== > sal_Bool SfxDispatcher::IsLocked( sal_uInt16 ) const > >-/* [Beschreibung] >+/* [Description] > >- Mit dieser Methode kann festgestellt werden, ob der SfxDispatcher >- gesperrt oder freigegeben ist. Ein gesperrter SfxDispatcher >- f"uhrt keine <SfxRequest>s mehr aus und liefert keine >- Status-Informationen mehr. Er verh"alt sich so als w"aren alle >- Slots disabled. >+ With this method it can be determined whether the SfxDispatcher is >+ locked or unlocked. A locked SfxDispatcher does not perform <SfxRequest>s >+ and no longer provides any status information. It behaves as if all the >+ slots are disabled. > >- Der Dispatcher gilt auch als gesperrt, wenn alle Dispatcher >- gelockt sind (<SfxApplication::LockDispatcher()>) oder der zugeh"orige >- Top-Frame im modal-mode ist und der angegebene Slot Frame-spezifisch >- (also nicht von der Application) bedient wird. >+ The dispatcher is also marked as blocked, if all Dispatcher are locked >+ (<SfxApplication::LockDispatcher()>) or the associated top frame is in the >+ modal-mode and if the specified slot are handled as frame-specific >+ (ie, not served by the application). > */ > > { >@@ -201,19 +201,15 @@ sal_Bool SfxDispatcher::IsLocked( sal_uInt16 ) const > //-------------------------------------------------------------------- > sal_Bool SfxDispatcher::IsAppDispatcher() const > >-/* [Beschreibung] >+/* [Description] > >- Mit dieser Methode l"a\st sich festellen, ob der SfxDispacher der >- Applikations-Dispatcher ist. >+ With this method it can be determined if the SfxDispacher is the >+ applications dispatcher. > >+ [Return value] > >- [R"uckgabewert] >- >- sal_Bool sal_True >- Es ist der Applikations-Dispatcher. >- >- sal_False >- Es ist ein Dispatcher eines SfxViewFrame. >+ sal_Bool sal_True it is the application dispatcher. >+ sal_Fals it is a SfxViewFrame dispatcher. > */ > > { >@@ -223,21 +219,21 @@ sal_Bool SfxDispatcher::IsAppDispatcher() const > //-------------------------------------------------------------------- > int SfxDispatcher::Call_Impl( SfxShell& rShell, const SfxSlot &rSlot, SfxRequest &rReq, sal_Bool bRecord ) > >-/* [Beschreibung] >+/* [Description] > >- Hilfsfunktion zum pr"ufen, ob ein Slot executed werden darf und >- der Execution selbst. >+ Helper function to check whether a slot can be executed and >+ check the execution itself > */ > > { > SFX_STACK(SfxDispatcher::Call_Impl); > >- // darf der Slot gerufen werden (i.S.v. enabled) >+ // The slot may be called (meaning enabled) > if ( rSlot.IsMode(SFX_SLOT_FASTCALL) || rShell.CanExecuteSlot_Impl(rSlot) ) > { > if ( GetFrame() ) > { >- // ggf. Recording anwerfen >+ // Recording may start > com::sun::star::uno::Reference< com::sun::star::frame::XFrame > xFrame( > GetFrame()->GetFrame().GetFrameInterface(), > com::sun::star::uno::UNO_QUERY); >@@ -259,14 +255,13 @@ int SfxDispatcher::Call_Impl( SfxShell& rShell, const SfxSlot &rSlot, SfxRequest > rReq.Record_Impl( rShell, rSlot, xRecorder, GetFrame() ); > } > } >- >- // Alles holen, was gebraucht wird, da der Slot den Execute evtl. nicht >- // "uberlebt, falls es ein 'Pseudoslot' f"ur Macros oder Verben ist >+ // Get all that is needed, because the slot may not have survived the >+ // Execute if it is a 'pseudo slot' for macros or verbs. > sal_Bool bAutoUpdate = rSlot.IsMode(SFX_SLOT_AUTOUPDATE); > >- // API-Call-Klammerung und Document-Lock w"ahrend des Calls >+ // API-call parentheses and document-lock during the calls > { >- // 'this' mu\s im Dtor bescheid sagen >+ // 'this' must respond in the Destructor > sal_Bool bThisDispatcherAlive = sal_True; > sal_Bool *pOldInCallAliveFlag = pImp->pInCallAliveFlag; > pImp->pInCallAliveFlag = &bThisDispatcherAlive; >@@ -280,14 +275,14 @@ int SfxDispatcher::Call_Impl( SfxShell& rShell, const SfxSlot &rSlot, SfxRequest > SfxExecFunc pFunc = rSlot.GetExecFnc(); > rShell.CallExec( pFunc, rReq ); > >- // falls 'this' noch lebt >+ // If 'this' is still alive > if ( bThisDispatcherAlive ) > pImp->pInCallAliveFlag = pOldInCallAliveFlag; > else > { > if ( pOldInCallAliveFlag ) > { >- // auch verschachtelte Stack-Frames sch"utzen >+ // also protect nested stack frames > *pOldInCallAliveFlag = sal_False; > } > >@@ -300,14 +295,14 @@ int SfxDispatcher::Call_Impl( SfxShell& rShell, const SfxSlot &rSlot, SfxRequest > { > SfxBindings *pBindings = GetBindings(); > >- // bei AutoUpdate sofort updaten; "Pseudoslots" d"urfen nicht >- // Autoupdate sein! >+ // When AutoUpdate update immediately; "Pseudoslots" must not be >+ // Autoupdate! > if ( bAutoUpdate && pBindings ) > { > const SfxSlot* pSlave = rSlot.GetLinkedSlot(); > if (pSlave) > { >- // bei Enum-Slots irgendeinen gebundenen Slave-Slot nehmen >+ // When enum slots take any bound slave slot > while (!pBindings->IsBound(pSlave->GetSlotId()) && pSlave != &rSlot ) > pSlave = pSlave->GetLinkedSlot(); > pBindings->Invalidate(pSlave->GetSlotId()); >@@ -378,11 +373,10 @@ SfxDispatcher::SfxDispatcher( SfxDispatcher* pParent ) > > SfxDispatcher::SfxDispatcher( SfxViewFrame *pViewFrame ) > >-/* [Beschreibung] >+/* [Description] > >- Der Konstruktor der Klasse SfxDispatcher legt einen leeren Stack >- von <SfxShell>-Pointern an. Er ist initial nicht gelockt und gilt als >- geflusht. >+ The constructor of the SfxDispatcher class places a stack of empty >+ <SfxShell> pointers. It is not initially locked and is considered flushed. > */ > > { >@@ -402,11 +396,11 @@ SfxDispatcher::SfxDispatcher( SfxViewFrame *pViewFrame ) > //==================================================================== > SfxDispatcher::~SfxDispatcher() > >-/* [Beschreibung] >+/* [Description] > >- Der Destruktor der Klasse SfxDispatcher darf nicht gerufen werden, >- wenn die SfxDispatcher-Instanz aktiv ist. Es d"urfen sich allerdings >- noch <SfxShell>-Pointer auf dem Stack befinden. >+ The destructor of the SfxDispatcher class should not be called when the >+ SfxDispatcher instance is active. It may, however, still be a <SfxShell> >+ pointer on the stack. > */ > > { >@@ -417,27 +411,26 @@ SfxDispatcher::~SfxDispatcher() > DBG_ASSERT( !pImp->bActive, "deleting active Dispatcher" ); > #endif > >- // Damit in LeaveRegistrations kein Timer per Reschedule in PlugComm >- // zuschlaegt >+ // So that no timer by Reschedule in PlugComm strikes the LeaveRegistrations > pImp->aTimer.Stop(); > pImp->xPoster->SetEventHdl( Link() ); > >- // die Stack-Varialblem in Call_Impl benachrichtigen >+ // Notify the stack varialbles in Call_Impl > if ( pImp->pInCallAliveFlag ) > *pImp->pInCallAliveFlag = sal_False; > >- // Bindings und App besorgen >+ // Get bindings and application > SfxApplication *pSfxApp = SFX_APP(); > SfxBindings* pBindings = GetBindings(); > > // if (pImp->nEventId) > // pSfxApp->RemoveEventHdl(pImp->nEventId); > >- // wenn noch nicht flushed, die Bindings wiederbeleben >+ // When not flushed, revive the bindings > if ( pBindings && !pSfxApp->IsDowning() && !bFlushed ) > pBindings->DLEAVEREGISTRATIONS(); > >- // ggf. bei den Bindings abmelden >+ // may unregister the bindings > while ( pBindings ) > { > if ( pBindings->GetDispatcher_Impl() == this) >@@ -451,27 +444,27 @@ SfxDispatcher::~SfxDispatcher() > //==================================================================== > void SfxDispatcher::Pop > ( >- SfxShell& rShell, /* Die vom Stack zu nehmende SfxShell-Instanz. */ >+ SfxShell& rShell, /* the stack to take the SfxShell instance. */ > > sal_uInt16 nMode /* SFX_SHELL_POP_UNTIL >- Es werden auch alle "uber 'rShell' liegenenden >- SfxShell's vom Stack genommen. >+ Also all 'rShell' of SfxShells are taken from the >+ stack. > > SFX_SHELL_POP_DELETE >- Alle tats"achlich vom Stack genommenen >- SfxShells werden gel"oscht. >+ All SfxShells actually taken from the stack >+ will be deleted. > > SFX_SHELL_PUSH (InPlace use only) >- Die Shell wird gepusht. */ >+ The Shell is pushed. */ > ) >-/* [Beschreibung] >- >- Mit dieser Methode wird eine oder mehrere <SfxShell> vom SfxDispatcher >- gepoppt. Die SfxShell wird zun"achst zum poppen vermerkt und >- es wird ein Timer aufgesetzt. Erst bei Ablauf des Timers wird >- tats"achlich gepoppt (<SfxDispatcher::Flush()>) und die <SfxBindings> >- werden invalidiert. W"ahrend der Timer l"auft gleichen sich >- entgegengesetzte Push und Pop Befehle mit derselben SfxShell aus. >+/* [Description] >+ >+ With this method, one or more <SfxShell> are poped from the SfxDispatcher. >+ The SfxShell is marked for popping and a timer is set up. Only when the >+ timer has reached the end, the pop is actually performed >+ ( <SfxDispatcher::Flush()> ) and the <SfxBindings> is invalidated. >+ While the timer is running the opposing push and pop commands on one >+ SfxShell cancel each other out. > */ > > { >@@ -501,10 +494,10 @@ void SfxDispatcher::Pop > DbgTrace( aMsg.GetBuffer() ); > #endif > >- // gleiche Shell wie on-Top des ToDo-Stacks? >+ // same shell as on top of the to-do stack? > if ( pImp->aToDoStack.Count() && pImp->aToDoStack.Top().pCluster == &rShell ) > { >- // inverse Actions heben sich auf >+ // cancel inverse actions > if ( pImp->aToDoStack.Top().bPush != bPush ) > pImp->aToDoStack.Pop(); > else >@@ -515,7 +508,7 @@ void SfxDispatcher::Pop > } > else > { >- // ::com::sun::star::chaos::Action merken >+ // Remember ::com::sun::star::chaos::Action > pImp->aToDoStack.Push( SfxToDo_Impl(bPush, bDelete, bUntil, rShell) ); > if ( bFlushed ) > { >@@ -523,7 +516,7 @@ void SfxDispatcher::Pop > bFlushed = sal_False; > pImp->bUpdated = sal_False; > >- // Bindings schlafen legen >+ // Put bindings to sleep > SfxBindings* pBindings = GetBindings(); > if ( pBindings ) > pBindings->DENTERREGISTRATIONS(); >@@ -533,29 +526,28 @@ void SfxDispatcher::Pop > if ( !pSfxApp->IsDowning() && pImp->aToDoStack.Count() ) > { > //! if (SFX_APP()->AnyInput(INPUT_KEYBOARD | INPUT_MOUSE) ) >- //! AnyInput haut nicht hin; hier muss noch ein Kriterium gefunden >- //! werden. Solange wieder immer mit Timer. >- >+ //! AnyInput does not work, here a criterion has yet to found. >+ //! As long as time after time with a timer. > if (sal_True) > { >- // Kein sofortiges Update gewuenscht >+ // No immediate update is requested > pImp->aTimer.SetTimeout(SFX_FLUSH_TIMEOUT); > pImp->aTimer.SetTimeoutHdl( LINK(this, SfxDispatcher, EventHdl_Impl ) ); > pImp->aTimer.Start(); > } > else > { >- // Schnellstmoegliches Update (sollte Normalfall sein) >+ // Upgrade as quickly as possible(should be the normal case) > pImp->aTimer.Stop(); > GetpApp()->PostUserEvent(pImp->nEventId, (void*)0); > } > } > else > { >- // doch nichts zu tun >+ // but to do nothing > pImp->aTimer.Stop(); > >- // ggf. Bindings wieder aufwecken >+ // Bindings may wake up again > if ( !pImp->aToDoStack.Count() ) > { > SfxBindings* pBindings = GetBindings(); >@@ -569,13 +561,13 @@ void SfxDispatcher::Pop > > IMPL_LINK_INLINE_START( SfxDispatcher, EventHdl_Impl, void *, pvoid ) > >-/* [Beschreibung] >+/* [Description] > >- Dieser Handler wird nach <SfxDispatcher::Invalidate()> oder Bewegungen >- auf dem Stack (<SfxDispatcher::Push()> und <SfxDispatcher::Pop()) gerufen. >+ This handler is called after <SfxDispatcher::Invalidate()> or after >+ changes on the stack (<SfxDispatcher::Push()> and <SfxDispatcher::Pop()) > >- Er flusht den Stack, falls er dirty ist, f"uhrt also die ausstehenden >- Push und Pop Befehle tats"achlich aus. >+ It flushes the Stack, if it is dirty, thus it actually excecutes the >+ pending Push and Pop commands. > */ > > { >@@ -594,14 +586,14 @@ IMPL_LINK_INLINE_END( SfxDispatcher, EventHdl_Impl, void *, pvoid ) > //-------------------------------------------------------------------- > sal_Bool SfxDispatcher::CheckVirtualStack( const SfxShell& rShell, sal_Bool bDeep ) > >-/* [Beschreibung] >+/* [Description] > >- Mit dieser Methode kann gepr"uft werden, ob sich die <SfxShell> rShell >- auf dem Stack befindet, wenn er geflusht w"are. Dabei wird der >- SfxDispatcher jedoch nicht tats"achlich geflusht. >+ With this method it can be tested whether the <SfxShell> rShell is on the >+ stack, when it was flushed. This way the SfxDispatcher is not actually >+ flushed. > >- Diese Methode ist u.a. dazu gedacht, Assertions zu erm"oglichen, ohne >- als Seiteneffekt den SfxDispathcer flushen zu m"ussen. >+ This method is intended among other things to make assertions possible >+ without the side effect of having to flush the SfxDispathcer. > */ > > { >@@ -638,21 +630,19 @@ sal_Bool SfxDispatcher::CheckVirtualStack( const SfxShell& rShell, sal_Bool bDee > //-------------------------------------------------------------------- > sal_uInt16 SfxDispatcher::GetShellLevel( const SfxShell& rShell ) > >-/* [Beschreibung] >- >- Ermittelt die Position einer SfxShell im Stack des Dispatchers. >- Dazu wird dieser ggf. zuvor geflusht. >+/* [Description] > >+ Determines the position of a given SfxShell in the stack of the dispatcher. >+ If possible this is flushed before. > >- [Rueckgabewert] >+ [Return value] > > sal_uInt16 == USRT_MAX >- Die SfxShell befindet sich nicht auf >- diesem SfxDispatcher. >+ The SfxShell is not on this SfxDispatcher. > > < USHRT_MAX >- Position der SfxShell auf dem Dispatcher >- von oben mit 0 beginnend gez"ahlt. >+ Position of the SfxShell on the Dispatcher >+ from the top count stating with 0. > */ > > { >@@ -677,14 +667,14 @@ sal_uInt16 SfxDispatcher::GetShellLevel( const SfxShell& rShell ) > //-------------------------------------------------------------------- > SfxShell *SfxDispatcher::GetShell(sal_uInt16 nIdx) const > >-/* [Beschreibung] >+/* [Description] > >- Liefert einen Pointer auf die <SfxShell>, welche sich an der Position >- nIdx (von oben, letzt-gepushte liegt bei 0) auf dem Stack befindet. >+ Returns a pointer to the <SfxShell> which is at the position nIdx >+ (from the top, last pushed is 0) on the stack. > >- Dabei wird der SfxDispatcher nicht geflusht. >+ Thus the SfxDispatcher is not flushed. > >- Ist der Stack nicht tief genug, wird ein 0-Pointer zur"uckgegeben. >+ Is the stack not deep enough a NULL-Pointer is returned. > */ > > { >@@ -701,15 +691,15 @@ SfxShell *SfxDispatcher::GetShell(sal_uInt16 nIdx) const > //-------------------------------------------------------------------- > SfxBindings* SfxDispatcher::GetBindings() const > >-/* [Beschreibung] >+/* [Description] > >- Diese Methode liefert einen Pointer auf die <SfxBindings> Instanz >- zur"uck, an die der SfxDispatcher gerade gebunden ist. Ein SfxDispatcher >- ist nur dann an SfxBindings gebunden, wenn er <UI-aktiv> ist. Ist >- er nicht UI-aktiv, wird ein 0-Pointer zur"uckgegeben. >+ This method returns a pointer to the <SfxBinding> Instance on which the >+ SfxDispatcher is curretly bound. A SfxDispatcher is only bound to >+ the SfxBindings when it is <UI-aktiv>. If it is not UI-active, >+ a NULL-pointer is returned. > >- Der zur"uckgegebene Pointer ist nur im <unmittelbaren Kontext> des >- Methodenaufrufs g"ultig. >+ The returned pointer is only valid in the immediate context of the method >+ call. > */ > > { >@@ -722,11 +712,11 @@ SfxBindings* SfxDispatcher::GetBindings() const > //-------------------------------------------------------------------- > SfxViewFrame* SfxDispatcher::GetFrame() const > >-/* [Beschreibung] >+/* [Description] > >- Liefert einen Pointer auf die <SfxViewFrame> Instanz, der dieser >- SfxDispatcher geh"ort. Falls es sich um den Applikations-Dispatcher >- handelt, wird ein 0-Pointer zur"uckgegeben. >+ Returns a pointer to the <SfxViewFrame> instance, which belongs to >+ this SfxDispatcher. If it is about the application dispatcher, >+ a NULL-pointer is returned. > */ > > { >@@ -737,18 +727,18 @@ SfxViewFrame* SfxDispatcher::GetFrame() const > //-------------------------------------------------------------------- > void SfxDispatcher::DoActivate_Impl( sal_Bool bMDI, SfxViewFrame* /* pOld */ ) > >-/* [Beschreibung] >+/* [Description] > >- Diese Methode steuert das Aktivieren eines Dispatchers. >+ This method controls the activation of a dispatcher. > >- Da der Applikations-Dispatcher immer aktiv ist, entweder als >- Unterdispatcher des <SfxViewFrame>-Dispatchers oder selbst, wird >- er nie als ganzes Aktiviert, sondern nur seine einzelnen <SfxShell>s >- bei <SfxDispatcher::Push(SfxShell&)>. >+ Since the application dispatcher is always active, either as a sub >+ dispatcher of the <SfxViewFrame> dispatcher or as itself, it is never >+ activated as a whole, instead only its individual <SfxShell>s at >+ <SfxDispatcher::Push(SfxShell&)>. > >- Beim Aktivieren eines SfxDispatchers wird an allen auf seinem >- Stack befindlichen SfxShells, beginnend mit der untersten, der Handler >- <SfxShell::Activate(sal_Bool)> gerufen. >+ When activating a SfxDispatcher all of the SfxShells located on its stack >+ are called with the handler <SfxShell::Activate(sal_Bool)>, starting with >+ the lowest. > */ > > { >@@ -760,7 +750,7 @@ void SfxDispatcher::DoActivate_Impl( sal_Bool bMDI, SfxViewFrame* /* pOld */ ) > ByteString sTemp("Activate Dispatcher "); > sTemp += ByteString::CreateFromInt64( (sal_uIntPtr) this ); > DBG_TRACE(sTemp.GetBuffer()); >- DBG_ASSERT( !pImp->bActive, "Activate-Fehler" ); >+ DBG_ASSERT( !pImp->bActive, "Activation error" ); > #endif > pImp->bActive = sal_True; > pImp->bUpdated = sal_False; >@@ -803,14 +793,14 @@ void SfxDispatcher::DoActivate_Impl( sal_Bool bMDI, SfxViewFrame* /* pOld */ ) > { > if (sal_True) > { >- // Kein sofortiges Update gewuenscht >+ // No immediate update is requested > pImp->aTimer.SetTimeout(SFX_FLUSH_TIMEOUT); > pImp->aTimer.SetTimeoutHdl( LINK(this, SfxDispatcher, EventHdl_Impl ) ); > pImp->aTimer.Start(); > } > else > { >- // Schnellstmoegliches Update (sollte Normalfall sein) >+ // Upgrade as quickly as possible(should be the normal case) > pImp->aTimer.Stop(); > GetpApp()->PostUserEvent(pImp->nEventId, (void*)0); > } >@@ -826,18 +816,18 @@ void SfxDispatcher::DoParentActivate_Impl() > //-------------------------------------------------------------------- > void SfxDispatcher::DoDeactivate_Impl( sal_Bool bMDI, SfxViewFrame* pNew ) > >-/* [Beschreibung] >+/* [Description] > >- Diese Methode steuert das Deaktivieren eines Dispatchers. >+ This method controls the deactivation of a dispatcher. > >- Da der Applikations-Dispatcher immer aktiv ist, entweder als >- Unterdispatcher des <SfxViewFrame>-Dispatchers oder selbst, wird >- er nie als ganzes Deaktiviert, sondern nur seine einzelnen <SfxShell>s >- bei <SfxDispatcher::Pop(SfxShell&)>. >+ Since the application dispatcher is always active, either as a sub >+ dispatcher of the <SfxViewFrame> dispatcher or as itself, it is never >+ deactivated as a whole, instead only its individual <SfxShell>s at >+ <SfxDispatcher::Pop(SfxShell&)>. > >- Beim Deaktivieren eines SfxDispatchers wird an allen auf seinem >- Stack befindlichen SfxShells, beginnend mit der obersten, der Handler >- <SfxShell::Deactivate(sal_Bool)> gerufen. >+ When deactivating a SfxDispatcher all of the SfxShells located on its stack >+ are called with the handler <SfxShell::Deactivate(sal_Bool)>, starting with >+ the lowest. > */ > > { >@@ -849,7 +839,7 @@ void SfxDispatcher::DoDeactivate_Impl( sal_Bool bMDI, SfxViewFrame* pNew ) > if ( bMDI ) > { > DBG_TRACE(ByteString("Deactivate Dispatcher ").Append(ByteString::CreateFromInt64( (sal_uIntPtr) this )).GetBuffer()); >- DBG_ASSERT( pImp->bActive, "Deactivate-Fehler" ); >+ DBG_ASSERT( pImp->bActive, "Deactivate error" ); > pImp->bActive = sal_False; > > if ( pImp->pFrame && !(pImp->pFrame->GetObjectShell()->IsInPlaceActive() ) ) >@@ -916,30 +906,28 @@ void SfxDispatcher::DoParentDeactivate_Impl() > //-------------------------------------------------------------------- > int SfxDispatcher::GetShellAndSlot_Impl > ( >- sal_uInt16 nSlot, // die zu suchende Slot-Id >- SfxShell** ppShell, // die SfxShell, welche nSlot z.Zt. bedient >- const SfxSlot** ppSlot, // der SfxSlot, welcher nSlot z.Zt. bedient >+ sal_uInt16 nSlot, // the searchable Slot-Id >+ SfxShell** ppShell, // the SfxShell, which are currently handled >+ // the nSlot >+ const SfxSlot** ppSlot, // the SfxSlot, which are currently handled >+ // the nSlot > sal_Bool bOwnShellsOnly, >- sal_Bool bModal, // trotz ModalMode >+ sal_Bool bModal, // ModalMode > sal_Bool bRealSlot > ) > >-/* [Beschreibung] >- >- Diese Methode sucht im SfxDispatcher nach der <SfxShell>, von der >- die Slot-Id nSlot zur Zeit bedient wird. Dazu wird der Dispatcher >- zuvor geflusht. >+/* [Description] > >+ This method searches in SfxDispatcher after <SfxShell> , from the Slot Id >+ nSlot currently being handled. For this, the dispatcher is first flushed. > >- [R"uckgabewert] >+ [Return value] > > int sal_True >- Die SfxShell wurde gefunden, ppShell und ppSlot >- sind g"ultig. >+ The SfxShell was found, ppShell and ppSlot are valid. > >- sal_True >- Die SfxShell wurde nicht gefunden, ppShell und ppSlot >- sind ung"ultig. >+ sal_False >+ The SfxShell was not found, ppShell and ppSlot are invalid. > */ > > { >@@ -999,16 +987,17 @@ struct Executer : public SfxHint > //-------------------------------------------------------------------- > void SfxDispatcher::_Execute > ( >- SfxShell& rShell, // zu rufende <SfxShell> >- const SfxSlot& rSlot, // zu rufender <SfxSlot> >- SfxRequest& rReq, // auszuf"uhrende Funktion (Id und optional Parameter) >- SfxCallMode eCallMode // synchron, asynchron oder wie beim Slot angegeben >+ SfxShell& rShell, // to the calling <SfxShell> >+ const SfxSlot& rSlot, // to the calling <SfxSlot> >+ SfxRequest& rReq, // function to be performed >+ // (Id and optional parameters) >+ SfxCallMode eCallMode // Synchronously, asynchronously or as shown in >+ // the slot > ) > >-/* [Beschreibung] >+/* [Description] > >- Diese Methode f"uhrt einen Request "uber einen gecachten <Slot-Server> >- aus. >+ This method performs a request for a cached <Slot-Server>. > */ > > { >@@ -1053,14 +1042,14 @@ void SfxDispatcher::_Execute > //-------------------------------------------------------------------- > void MappedPut_Impl( SfxAllItemSet &rSet, const SfxPoolItem &rItem ) > >-/* [Beschreibung] >+/* [Description] > >- Hilfsfunktion zum putten von rItem unter der im Pool des Item-Sets >- rSet geltenden Which-Id. >+ Helper function to put from rItem below the Which-ID in the pool of the >+ Item Sets rSet. > */ > > { >- // mit ggf. gemappter Which-Id putten >+ // Put with mapped Which-Id if possible > const SfxItemPool *pPool = rSet.GetPool(); > sal_uInt16 nWhich = rItem.Which(); > #ifdef TF_POOLABLE >@@ -1084,7 +1073,7 @@ sal_uInt16 SfxDispatcher::ExecuteFunction( sal_uInt16 nSlot, SfxPoolItem **pArgs > if ( !nMode ) > nMode = pImp->nStandardMode; > >- // via Bindings/Interceptor? (dann ist der Returnwert nicht exakt) >+ // through Bindings/Interceptor? (then the return value is not exact) > sal_Bool bViaBindings = SFX_USE_BINDINGS == ( nMode & SFX_USE_BINDINGS ); > nMode &= ~sal_uInt16(SFX_USE_BINDINGS); > if ( bViaBindings && GetBindings() ) >@@ -1092,7 +1081,7 @@ sal_uInt16 SfxDispatcher::ExecuteFunction( sal_uInt16 nSlot, SfxPoolItem **pArgs > ? EXECUTE_POSSIBLE > : EXECUTE_NO; > >- // sonst via Dispatcher >+ // otherwise through the Dispatcher > if ( IsLocked(nSlot) ) > return 0; > SfxShell *pShell = 0; >@@ -1101,7 +1090,7 @@ sal_uInt16 SfxDispatcher::ExecuteFunction( sal_uInt16 nSlot, SfxPoolItem **pArgs > const SfxSlot *pSlot = 0; > if ( GetShellAndSlot_Impl( nSlot, &pShell, &pSlot, sal_False, sal_False ) ) > { >- // Ausf"uhrbarkeit vorher testen >+ // Feasibility test before > if ( pSlot->IsMode( SFX_SLOT_FASTCALL ) || > pShell->CanExecuteSlot_Impl( *pSlot ) ) > nRet = EXECUTE_POSSIBLE; >@@ -1141,7 +1130,7 @@ sal_uInt16 SfxDispatcher::ExecuteFunction( sal_uInt16 nSlot, const SfxItemSet& r > > /* > // at the moment not implemented >- // via Bindings/Interceptor? (dann ist der Returnwert nicht exakt) >+ // through Bindings/Interceptor? (then the return value is not exact) > sal_Bool bViaBindings = SFX_USE_BINDINGS == ( nMode & SFX_USE_BINDINGS ); > nMode &= ~sal_uInt16(SFX_USE_BINDINGS); > if ( bViaBindings && GetBindings() ) >@@ -1149,7 +1138,7 @@ sal_uInt16 SfxDispatcher::ExecuteFunction( sal_uInt16 nSlot, const SfxItemSet& r > ? EXECUTE_POSSIBLE > : EXECUTE_NO; > */ >- // sonst via Dispatcher >+ // otherwise through the Dispatcher > if ( IsLocked(nSlot) ) > return 0; > SfxShell *pShell = 0; >@@ -1158,7 +1147,7 @@ sal_uInt16 SfxDispatcher::ExecuteFunction( sal_uInt16 nSlot, const SfxItemSet& r > const SfxSlot *pSlot = 0; > if ( GetShellAndSlot_Impl( nSlot, &pShell, &pSlot, sal_False, sal_False ) ) > { >- // Ausf"uhrbarkeit vorher testen >+ // Feasibility test before > if ( pSlot->IsMode( SFX_SLOT_FASTCALL ) || > pShell->CanExecuteSlot_Impl( *pSlot ) ) > nRet = EXECUTE_POSSIBLE; >@@ -1188,7 +1177,7 @@ sal_uInt16 SfxDispatcher::GetSlotId( const String& rCommand ) > > const SfxSlot* SfxDispatcher::GetSlot( const String& rCommand ) > { >- // Anzahl der Shells auf den verkettenten Dispatchern z"ahlen >+ // Count the number of Shells on the linked Dispatcher > Flush(); > sal_uInt16 nTotCount = pImp->aStack.Count(); > if ( pImp->pParent ) >@@ -1320,27 +1309,26 @@ const SfxPoolItem* SfxDispatcher::Execute( > //-------------------------------------------------------------------- > const SfxPoolItem* SfxDispatcher::Execute > ( >- sal_uInt16 nSlot, // die Id der auszufuehrenden Funktion >- SfxCallMode eCall, // SFX_CALLMODE_SYNCRHON, ..._ASYNCHRON oder ..._SLOT >- const SfxPoolItem **pArgs, // 0-terminiertes C-Array von Parametern >+ sal_uInt16 nSlot, // the Id of the executing function >+ SfxCallMode eCall, // SFX_CALLMODE_SYNCRHON, ..._ASYNCHRON >+ // or ..._SLOT >+ const SfxPoolItem **pArgs, // Zero teminated C-Array of Parameters > sal_uInt16 nModi, >- const SfxPoolItem **pInternalArgs // 0-terminiertes C-Array von Parametern >+ const SfxPoolItem **pInternalArgs // Zero terminated C-Array of Parameters > ) > >-/* [Beschreibung] >- >- Methode zum Ausf"uhren eines <SfxSlot>s "uber die Slot-Id. >+/* [Description] > >+ Method to excecute a <SfxSlot>s over the Slot-Id. > >- [R"uckgabewert] >+ [Return value] > >- const SfxPoolItem* Pointer auf ein bis zum n"achsten Durchlauf >- der Message-Loop g"ultiges SfxPoolItem, >- welches den R"uckgabewert enth"alt. >+ const SfxPoolItem* Pointer to the SfxPoolItem valid to the next run >+ though the Message-Loop, which contains the return >+ value. > >- Oder ein 0-Pointer, wenn die Funktion nicht >- ausgef"uhrt wurde (z.B. Abbruch durch den >- Benutzer). >+ Or a NULL-Pointer, when the function was not >+ executed (for example canceled by the user). > */ > > { >@@ -1380,25 +1368,23 @@ const SfxPoolItem* SfxDispatcher::Execute > //-------------------------------------------------------------------- > const SfxPoolItem* SfxDispatcher::Execute > ( >- sal_uInt16 nSlot, // die Id der auszufuehrenden Funktion >- SfxCallMode eCall, // SFX_CALLMODE_SYNCRHON, ..._ASYNCHRON oder ..._SLOT >- const SfxItemSet &rArgs // <SfxItemSet> mit Parametern >+ sal_uInt16 nSlot, // the Id of the executing function >+ SfxCallMode eCall, // SFX_CALLMODE_SYNCRHON, ..._ASYNCHRON or ..._SLOT >+ const SfxItemSet &rArgs // <SfxItemSet> with the parameters > ) > >-/* [Beschreibung] >+/* [Description] > >- Methode zum Ausf"uhren eines <SfxSlot>s "uber die Slot-Id. >+ Method to excecute a <SfxSlot>s over the Slot-Id. > >+ [Return value] > >- [R"uckgabewert] >+ const SfxPoolItem* Pointer to the SfxPoolItem valid to the next run >+ though the Message-Loop, which contains the return >+ value. > >- const SfxPoolItem* Pointer auf ein bis zum n"achsten Durchlauf >- der Message-Loop g"ultiges SfxPoolItem, >- welches den R"uckgabewert enth"alt. >- >- Oder ein 0-Pointer, wenn die Funktion nicht >- ausgef"uhrt wurde (z.B. Abbruch durch den >- Benutzer). >+ Or a NULL-Pointer, when the function was not >+ executed (for example canceled by the user). > */ > > { >@@ -1439,26 +1425,25 @@ const SfxPoolItem* SfxDispatcher::Execute > //-------------------------------------------------------------------- > const SfxPoolItem* SfxDispatcher::_Execute > ( >- sal_uInt16 nSlot, // die Id der auszufuehrenden Funktion >- SfxCallMode eCall, // SFX_CALLMODE_SYNCRHON, ..._ASYNCHRON oder ..._SLOT >- va_list pVarArgs, // Parameterliste ab 2. Parameter >- const SfxPoolItem* pArg1 // erster Parameter >+ sal_uInt16 nSlot, // the Id of the executing function >+ SfxCallMode eCall, // SFX_CALLMODE_SYNCRHON, ..._ASYNCHRON or >+ //..._SLOT >+ va_list pVarArgs, // Parameter list from the 2nd parameter >+ const SfxPoolItem* pArg1 // First parameter > ) > >-/* [Beschreibung] >- >- Methode zum Ausf"uhren eines <SfxSlot>s "uber die Slot-Id. >+/* [Description] > >+ Method to excecute a <SfxSlot>s over the Slot-Id. > >- [R"uckgabewert] >+ [Return value] > >- const SfxPoolItem* Pointer auf ein bis zum n"achsten Durchlauf >- der Message-Loop g"ultiges SfxPoolItem, >- welches den R"uckgabewert enth"alt. >+ const SfxPoolItem* Pointer to the SfxPoolItem valid to the next run >+ though the Message-Loop, which contains the return >+ value. > >- Oder ein 0-Pointer, wenn die Funktion nicht >- ausgef"uhrt wurde (z.B. Abbruch durch den >- Benutzer). >+ Or a NULL-Pointer, when the function was not >+ executed (for example canceled by the user). > */ > > { >@@ -1487,35 +1472,32 @@ const SfxPoolItem* SfxDispatcher::_Execute > //-------------------------------------------------------------------- > const SfxPoolItem* SfxDispatcher::Execute > ( >- sal_uInt16 nSlot, // die Id der auszufuehrenden Funktion >- SfxCallMode eCall, // SFX_CALLMODE_SYNCRHON, ..._ASYNCHRON oder ..._SLOT >- const SfxPoolItem* pArg1, // erster Parameter >- ... // 0-terminiertes Liste Parametern >+ sal_uInt16 nSlot, // the Id of the executing function >+ SfxCallMode eCall, // SFX_CALLMODE_SYNCRHON, ..._ASYNCHRON or >+ // ..._SLOT >+ const SfxPoolItem* pArg1, // First parameter >+ ... // Zero terminated list of parameters > ) > >-/* [Beschreibung] >- >- Methode zum Ausf"uhren eines <SfxSlot>s "uber die Slot-Id. >- >- >- [Anmerkung] >+/* [Description] > >- Die Parameter werden kopiert, k"onnen daher als Adresse von >- Stack-Objekten "ubergeben werden. >+ Method to excecute a <SfxSlot>s over the Slot-Id. > >+ [Note] > >- [R"uckgabewert] >+ The parameters are copied, can therefore be passed on as the address >+ of stack objects. > >- const SfxPoolItem* Pointer auf ein bis zum n"achsten Durchlauf >- der Message-Loop g"ultiges SfxPoolItem, >- welches den R"uckgabewert enth"alt. >+ [Return value] > >- Oder ein 0-Pointer, wenn die Funktion nicht >- ausgef"uhrt wurde (z.B. Abbruch durch den >- Benutzer). >+ const SfxPoolItem* Pointer to the SfxPoolItem valid to the next run >+ though the Message-Loop, which contains the return >+ value. > >+ Or a NULL-Pointer, when the function was not >+ executed (for example canceled by the user). > >- [Beispiel] >+ [Example] > > pDispatcher->Execute( SID_OPENDOCUMENT, SFX_CALLMODE_SYNCHRON, > &SfxStringItem( SID_FILE_NAME, "\\tmp\\temp.sdd" ), >@@ -1554,9 +1536,9 @@ const SfxPoolItem* SfxDispatcher::Execute > > IMPL_LINK( SfxDispatcher, PostMsgHandler, SfxRequest*, pReq ) > >-/* [Beschreibung] >+/* [Description] > >- Hilfsmethode zum Empfangen der asynchron auszuf"uhrenden <SfxRequest>s. >+ Helper method to receive the asynchronously executed <SfxRequest>s. > */ > > { >@@ -1564,7 +1546,7 @@ IMPL_LINK( SfxDispatcher, PostMsgHandler, SfxRequest*, pReq ) > DBG_ASSERT( !pImp->bFlushing, "recursive call to dispatcher" ); > SFX_STACK(SfxDispatcher::PostMsgHandler); > >- // ist auch der Pool noch nicht gestorben? >+ // Has also the Pool not yet died? > // SfxRequest* pReq = pExec->pRequest; > if ( !pReq->IsCancelled() ) > { >@@ -1582,11 +1564,11 @@ IMPL_LINK( SfxDispatcher, PostMsgHandler, SfxRequest*, pReq ) > DBG( SfxApplication *pSfxApp = SFX_APP() ); > DBG( pSfxApp->EnterAsynchronCall_Impl() ); > >- // Wenn pSlot ein "Pseudoslot" f"ur Macros oder Verben ist, kann >- // er im Call_Impl zerst"ort werden, also nicht mehr benutzen! >+ // When the pSlot is a "Pseudoslot" for macros or Verbs, it can >+ // be destroyed in the Call_Impl, thus do not use it anymore! > pReq->SetSynchronCall( sal_False ); >- Call_Impl( *pSh, *pSlot, *pReq, pReq->AllowsRecording() ); //! woher bRecord? >-// Call_Impl( *pShell, *pExec->pSlot, *pReq, sal_True ); //! woher bRecord? >+ Call_Impl( *pSh, *pSlot, *pReq, pReq->AllowsRecording() ); //! why bRecord? >+// Call_Impl( *pShell, *pExec->pSlot, *pReq, sal_True ); //! why bRecord? > DBG( pSfxApp->LeaveAsynchronCall_Impl() ); > } > >@@ -1824,7 +1806,7 @@ sal_uInt32 SfxDispatcher::_Update_Impl( sal_Bool bUIActive, sal_Bool bIsMDIApp, > if ( bReadOnlyShell && !( nPos & SFX_VISIBILITY_READONLYDOC ) ) > continue; > >- // check wether toolbar needs activation of a special feature >+ // check weather toolbar needs activation of a special feature > sal_uInt32 nFeature = pIFace->GetObjectBarFeature(nNo); > if ( nFeature && !pShell->HasUIFeature( nFeature ) ) > continue; >@@ -1951,9 +1933,9 @@ sal_uInt32 SfxDispatcher::_Update_Impl( sal_Bool bUIActive, sal_Bool bIsMDIApp, > //-------------------------------------------------------------------- > void SfxDispatcher::FlushImpl() > >-/* [Beschreibung] >+/* [Description] > >- Hilfsmethode zum Ausf"uhren der ausstehenden Push- und Pop-Befehle. >+ Helper method to execute the outstanding push and pop commands. > */ > > { >@@ -1993,7 +1975,7 @@ void SfxDispatcher::FlushImpl() > > SfxApplication *pSfxApp = SFX_APP(); > >- // in der 1. Runde den echten Stack 'um'bauen >+ // Re-build the true stack in the first round > SfxToDoStack_Impl aToDoCopy; > sal_Bool bModify = sal_False; > short nToDo; >@@ -2004,18 +1986,18 @@ void SfxDispatcher::FlushImpl() > SfxToDo_Impl aToDo( pImp->aToDoStack.Top(nToDo) ); > if ( aToDo.bPush ) > { >- // tats"aechlich pushen >+ // Actually push > DBG_ASSERT( !pImp->aStack.Contains( aToDo.pCluster ), > "pushed SfxShell already on stack" ); > pImp->aStack.Push( aToDo.pCluster ); > aToDo.pCluster->SetDisableFlags( pImp->nDisableFlags ); > >- // die bewegte Shell merken >+ // Mark the moved shell > aToDoCopy.Push( aToDo ); > } > else > { >- // tats"aechlich poppen >+ // Actually pop > SfxShell* pPopped = 0; > bool bFound = false; > do >@@ -2025,7 +2007,7 @@ void SfxDispatcher::FlushImpl() > pPopped->SetDisableFlags( 0 ); > bFound = pPopped == aToDo.pCluster; > >- // die bewegte Shell merken >+ // Mark the moved Shell > aToDoCopy.Push( SfxToDo_Impl( sal_False, aToDo.bDelete, sal_False, *pPopped) ); > } > while ( aToDo.bUntil && !bFound ); >@@ -2036,7 +2018,7 @@ void SfxDispatcher::FlushImpl() > pImp->aToDoStack.Clear(); > } > >- // ggf. Bindings invalidieren >+ // Invalidate bindings, if possible > if ( !pSfxApp->IsDowning() ) > { > if ( bModify ) >@@ -2049,11 +2031,11 @@ void SfxDispatcher::FlushImpl() > } > > pImp->bFlushing = sal_False; >- pImp->bUpdated = sal_False; // nicht nur bei bModify, falls Doc/Template-Config >+ pImp->bUpdated = sal_False; // not only when bModify, if Doc/Template-Config > bFlushed = sal_True; > DBG_TRACE("Successfully flushed dispatcher!"); > >- // in der 2. Runde die Shells aktivieren und ggf. l"oschen >+ // Activate the Shells and possible delete them in the 2nd round > for ( nToDo = aToDoCopy.Count()-1; nToDo >= 0; --nToDo ) > { > SfxToDo_Impl aToDo( aToDoCopy.Top(nToDo) ); >@@ -2075,9 +2057,10 @@ void SfxDispatcher::FlushImpl() > if( bAwakeBindings ) > aToDoCopy.Clear(); > >- // Wenn bei Activate/Deactivate/Delete weitere Stackbewegungen erfolgt sind : >+ // If more changes have occured on the stach when >+ // Activate/Deactivate/Delete: > if (!bFlushed) >- // falls jemand Push/Pop gerufen hat, wurde auch EnterReg gerufen! >+ // If Push/Pop hs been called by someone, theb also EnterReg was called! > FlushImpl(); > > if( bAwakeBindings && GetBindings() ) >@@ -2096,53 +2079,52 @@ void SfxDispatcher::FlushImpl() > //-------------------------------------------------------------------- > void SfxDispatcher::SetSlotFilter > ( >- HACK(hier muss mal ein enum rein) >+ HACK(must include an enum here) > sal_Bool bEnable, /* sal_True: >- nur angegebene Slots enablen, >- alle anderen disablen >+ only enable specified slots, >+ disable all other > > sal_False: >- die angegebenen Slots disablen, >- alle anderen zun"achst enablen >+ disable specified slots, >+ first enable all other > */ >- sal_uInt16 nCount, // Anzahl der SIDs im folgenden Array >- const sal_uInt16* pSIDs // sortiertes Array von 'nCount' SIDs >+ sal_uInt16 nCount, // Number of SIDs in the following Array >+ const sal_uInt16* pSIDs // sorted Array of 'nCount' SIDs > ) > >-/* [Beschreibung] >+/* [Description] > >- Mit dieser Methode wird ein Filter gesetzt, mit dem gezielt Slots >- enabled bzw. disabled werden k"onnen. Das "ubergebene Array mu\s >- bis zum Dtor bzw. n"achsten <SetSlotFilter()> erhalten bleiben, es >- wird nicht vom Dispatcher gel"oscht, es kann daher static sein. >+ With this method a filter set, the target slots can be enabled or disabled. >+ The passed array must be retained until the destructor or the next >+ <SetSlotFilter()>, it is not deleted from the dispatcher, so it can thus be >+ static. > >- In ReadOnly-Dokumenten kann man mit 'bEnable==2' quasi das ReadOnlyDoc >- Flag von Slots "ubersteuern, dieser werden also wieder gefunden. Auf >- andere Slots hat das dann keine Auswirkung. >+ In read-only documents the quasi ReadOnlyDoc Flag of slots can be >+ overturned by the use of 'bEnable == 2', so this will be displayed again. >+ On the other slots it has no effect. > >+ [Example] > >- [Beispiel] >- >- gezieltes disablen der Slots 1, 2 und 3: >+ Targeted disabling of Slots 1, 2 and 3: > > static sal_uInt16 const pSIDs[] = { 1, 2, 3 }; > pDisp->SetSlotFilter( sal_False, sizeof(pSIDs)/sizeof(sal_uInt16), pSIDs ); > >- nur die Slots 5, 6 und 7 zulassen: >+ only permit Slots 5, 6 and 7: > > static sal_uInt16 const pSIDs[] = { 5, 6, 7 }; > pDisp->SetSlotFilter( sal_True, sizeof(pSIDs)/sizeof(sal_uInt16), pSIDs ); > >- Filter ausschalten: >+ Turn-off Filter: > > pDisp->SetSlotFilter(); > */ > > { > #ifdef DBG_UTIL >- // Array "uberpr"ufen >+ // Check Array > for ( sal_uInt16 n = 1; n < nCount; ++n ) >- DBG_ASSERT( pSIDs[n] > pSIDs[n-1], "SetSlotFilter: SIDs not sortet" ); >+ DBG_ASSERT( pSIDs[n] > pSIDs[n-1], "SetSlotFilter: SIDs not sorted" ); > #endif > > if ( pImp->pFilterSIDs ) >@@ -2176,59 +2158,59 @@ SfxCompareSIDs_Impl( const void* pSmaller, const void* pBigger ) > //-------------------------------------------------------------------- > sal_Bool SfxDispatcher::IsSlotEnabledByFilter_Impl( sal_uInt16 nSID ) const > >-/* [Beschreibung] >+/* [Description] > >- Sucht 'nSID' in dem mit <SetSlotFilter()> gesetzten Filter und >- liefert sal_True, falls die SID erlaubt ist, bzw. sal_False, falls sie >- durch den Filter disabled ist. >+ Searches for 'nSID' in the Filter set by <SetSlotFilter()> and >+ returns sal_True, if the SIDis allowed, or sal_False, if it is >+ disabled by the Filter. > >- [R"uckgabewert] >+ [Return value] > sal_Bool 0 => disabled > 1 => enabled > 2 => enabled even if ReadOnlyDoc > */ > > { >- // kein Filter? >+ // no filter? > if ( 0 == pImp->nFilterCount ) >- // => alle SIDs erlaubt >+ // => all SIDs allowed > return sal_True; > >- // suchen >+ // search > sal_Bool bFound = 0 != bsearch( &nSID, pImp->pFilterSIDs, pImp->nFilterCount, > sizeof(sal_uInt16), SfxCompareSIDs_Impl ); > > // even if ReadOnlyDoc > if ( 2 == pImp->bFilterEnabling ) > return bFound ? 2 : 1; >- // sonst je nach Negativ/Positiv Filter >+ // Otherwise after Negative/Positive Filter > return pImp->bFilterEnabling ? bFound : !bFound; > } > > //-------------------------------------------------------------------- > sal_Bool SfxDispatcher::_TryIntercept_Impl > ( >- sal_uInt16 nSlot, // zu suchende Slot-Id >- SfxSlotServer& rServer, // zu f"uellende <SfxSlotServer>-Instanz >+ sal_uInt16 nSlot, // Slot-Id to search for >+ SfxSlotServer& rServer, // <SfxSlotServer>-Instance to fill > sal_Bool bSelf > ) > { >- // Eventuell geh"ort der parent auch zu einer Komponente >+ // Maybe the parent is also belongs to a component > SfxDispatcher *pParent = pImp->pParent; > sal_uInt16 nLevels = pImp->aStack.Count(); > while ( pParent && pParent->pImp->pFrame ) > { > if ( pParent->pImp->pFrame->GetFrame().HasComponent() ) > { >- // Components d"urfen intercepten >+ // Components may be intercepted > if ( pParent->_TryIntercept_Impl( nSlot, rServer, sal_True ) ) > { >- // Die eigenen Shells zum Shelllevel hinzuz"ahlen >+ // The own shells are added to the Shell Level > rServer.SetShellLevel( rServer.GetShellLevel() + nLevels ); > return sal_True; > } > else >- // Keine weitere Interception >+ // No further Interception > break; > } > else >@@ -2239,7 +2221,7 @@ sal_Bool SfxDispatcher::_TryIntercept_Impl > > if ( bSelf ) > { >- // Die ComponentViewShell befragen >+ // Query the ComponentViewShell > Flush(); > SfxShell *pObjShell = GetShell(0); > SfxInterface *pIFace = pObjShell->GetInterface(); >@@ -2263,36 +2245,35 @@ sal_Bool SfxDispatcher::_TryIntercept_Impl > > sal_Bool SfxDispatcher::_FindServer > ( >- sal_uInt16 nSlot, // zu suchende Slot-Id >- SfxSlotServer& rServer, // zu f"uellnde <SfxSlotServer>-Instanz >- sal_Bool bModal // trotz ModalMode >+ sal_uInt16 nSlot, // Slot-Id to search for >+ SfxSlotServer& rServer, // <SfxSlotServer>-Instance to fill >+ sal_Bool bModal // Dispite ModalMode > ) > >-/* [Beschreibung] >+/* [Description] > >- Diese Hilfsmethode sucht den <Slot-Server>, der nSlot zur Zeit bedient. >- Als Ergebnis wird rServer entsprechend gef"ullt. >+ This helper method searches for the <Slot-Server> which currently serves >+ the nSlot. As the result, rServe is filled accordingly. > >- Falls bekannt, kann das SfxInterface mitgegeben werden, von welchem >- nSlot momentan bedient wird. >+ If known the SfxInterface which is currently served by nSlot can be >+ passed along. > >- Vor der Suche nach nSlot wird der SfxDispatcher geflusht. >+ The SfxDispatcher is flushed while searching for nSlot. > >+ [Return value] > >- [R"uckgabewert] > > sal_Bool sal_True >- Der Slot wurde gefunden, rServer ist g"ultig. >+ The Slot was found, rServer is valid. > > sal_False >- Der Slot wird momentan nicht bedient, rServer >- ist ung"ultig. >+ The Slot is currently not served, rServer is invalid. > */ > > { > SFX_STACK(SfxDispatcher::_FindServer); > >- // Dispatcher gelockt? (SID_HELP_PI trotzdem durchlassen) >+ // Dispatcher locked? (nevertheless let SID_HELP_PI through) > SfxApplication *pSfxApp = SFX_APP(); > if ( IsLocked(nSlot) ) > { >@@ -2300,7 +2281,7 @@ sal_Bool SfxDispatcher::_FindServer > return sal_False; > } > >- // Anzahl der Shells auf den verkettenten Dispatchern z"ahlen >+ // Count the number of Shells in the linked dispatchers. > Flush(); > sal_uInt16 nTotCount = pImp->aStack.Count(); > if ( pImp->pParent ) >@@ -2313,7 +2294,7 @@ sal_Bool SfxDispatcher::_FindServer > } > } > >- // Makro-Slot? >+ // Macro-Slot? > if ( SfxMacroConfig::IsMacroSlot( nSlot ) ) > { > const SfxMacroInfo* pInfo = pSfxApp->GetMacroConfig()->GetMacroInfo(nSlot); >@@ -2351,7 +2332,7 @@ sal_Bool SfxDispatcher::_FindServer > } > } > >- // SID gegen gesetzten Filter pr"ufen >+ // SID check against set filter > sal_uInt16 nSlotEnableMode=0; > if ( pImp->pFrame ) > { >@@ -2360,7 +2341,7 @@ sal_Bool SfxDispatcher::_FindServer > return sal_False; > } > >- // im Quiet-Mode nur Parent-Dispatcher >+ // In Quiet-Mode only Parent-Dispatcher > if ( pImp->bQuiet ) > { > if ( pImp->pParent ) >@@ -2378,7 +2359,8 @@ sal_Bool SfxDispatcher::_FindServer > // ( pImp->pFrame && pImp->pFrame->GetObjectShell() ); > // pImp->pFrame->GetObjectShell()->IsLoading() ); > >- // durch alle Shells der verketteten Dispatchern von oben nach unten suchen >+ // search through all the shells of the chained dispatchers >+ // from top to bottom > #ifdef DBG_UTILx > String aStack( "Stack:" ); > #endif >@@ -2397,26 +2379,26 @@ sal_Bool SfxDispatcher::_FindServer > > if ( pSlot ) > { >- // Slot geh"ort zum Container? >+ // Slot belongs to Container? > bool bIsContainerSlot = pSlot->IsMode(SFX_SLOT_CONTAINER); > bool bIsInPlace = pImp->pFrame && pImp->pFrame->GetObjectShell()->IsInPlaceActive(); > >- // Shell geh"ort zum Server? >- // AppDispatcher oder IPFrame-Dispatcher >+ // Shell belongs to Server? >+ // AppDispatcher or IPFrame-Dispatcher > bool bIsServerShell = !pImp->pFrame || bIsInPlace; > >- // Nat"urlich sind ServerShell-Slots auch ausf"uhrbar, wenn sie auf >- // einem Container-Dispatcher ohne IPClient ausgef"uhrt werden sollen. >+ // Of course ShellServer-Slots are also executable even when it is >+ // excecuted on a container dispatcher without a IPClient. > if ( !bIsServerShell ) > { > SfxViewShell *pViewSh = pImp->pFrame->GetViewShell(); > bIsServerShell = !pViewSh || !pViewSh->GetUIActiveClient(); > } > >- // Shell geh"ort zum Container? >- // AppDispatcher oder kein IPFrameDispatcher >+ // Shell belongs to Container? >+ // AppDispatcher or no IPFrameDispatcher > bool bIsContainerShell = !pImp->pFrame || !bIsInPlace; >- // Shell und Slot passen zusammen >+ // Shell and Slot match > if ( !( ( bIsContainerSlot && bIsContainerShell ) || > ( !bIsContainerSlot && bIsServerShell ) ) ) > pSlot = 0; >@@ -2470,7 +2452,7 @@ sal_Bool SfxDispatcher::HasSlot_Impl( sal_uInt16 nSlot ) > } > > if ( SfxMacroConfig::IsMacroSlot( nSlot ) ) >- // Makro-Slot? >+ // Macro-Slot? > return sal_True; > else if (nSlot >= SID_VERB_START && nSlot <= SID_VERB_END) > { >@@ -2485,7 +2467,7 @@ sal_Bool SfxDispatcher::HasSlot_Impl( sal_uInt16 nSlot ) > } > } > >- // SID gegen gesetzten Filter pr"ufen >+ // SID check against set filter > sal_uInt16 nSlotEnableMode=0; > if ( pImp->pFrame ) > { >@@ -2494,7 +2476,7 @@ sal_Bool SfxDispatcher::HasSlot_Impl( sal_uInt16 nSlot ) > return sal_False; > } > >- // im Quiet-Mode nur Parent-Dispatcher >+ // In Quiet-Mode only Parent-Dispatcher > if ( pImp->bQuiet ) > return sal_False; > >@@ -2515,27 +2497,27 @@ sal_Bool SfxDispatcher::HasSlot_Impl( sal_uInt16 nSlot ) > > if ( pSlot ) > { >- // Slot geh"ort zum Container? >+ // Slot belongs to Container? > bool bIsContainerSlot = pSlot->IsMode(SFX_SLOT_CONTAINER); > bool bIsInPlace = pImp->pFrame && pImp->pFrame->GetObjectShell()->IsInPlaceActive(); > >- // Shell geh"ort zum Server? >- // AppDispatcher oder IPFrame-Dispatcher >+ // Shell belongs to Server? >+ // AppDispatcher or IPFrame-Dispatcher > bool bIsServerShell = !pImp->pFrame || bIsInPlace; > >- // Nat"urlich sind ServerShell-Slots auch ausf"uhrbar, wenn sie auf >- // einem Container-Dispatcher ohne IPClient ausgef"uhrt werden sollen. >+ // Of course ShellServer-Slots are also executable even when it is >+ // excecuted on a container dispatcher without a IPClient > if ( !bIsServerShell ) > { > SfxViewShell *pViewSh = pImp->pFrame->GetViewShell(); > bIsServerShell = !pViewSh || !pViewSh->GetUIActiveClient(); > } > >- // Shell geh"ort zum Container? >- // AppDispatcher oder kein IPFrameDispatcher >+ // Shell belongs to Container? >+ // AppDispatcher or no IPFrameDispatcher > bool bIsContainerShell = !pImp->pFrame || !bIsInPlace; > >- // Shell und Slot passen zusammen >+ // Shell and Slot match > if ( !( ( bIsContainerSlot && bIsContainerShell ) || > ( !bIsContainerSlot && bIsServerShell ) ) ) > pSlot = 0; >@@ -2551,23 +2533,21 @@ sal_Bool SfxDispatcher::HasSlot_Impl( sal_uInt16 nSlot ) > return sal_False; > } > >- >- > //-------------------------------------------------------------------- > sal_Bool SfxDispatcher::_FillState > ( >- const SfxSlotServer& rSvr, // abzufragende <Slot-Server> >- SfxItemSet& rState, // zu f"ullendes <SfxItemSet> >- const SfxSlot* pRealSlot // ggf. der tats"achliche Slot >+ const SfxSlotServer& rSvr, // <Slot-Server> to query >+ SfxItemSet& rState, // <SfxItemSet> to be filled >+ const SfxSlot* pRealSlot // The actual Slot if possible > ) > >-/* [Beschreibung] >+/* [Description] > >- Hilfsmethode zum Abfragen des Status des <Slot-Server>s rSvr. >- In rState m"ussen die gew"unschten Slots-Ids (teilweise in Which-Ids >- des betreffenden Pools umgewandelt) vorhanden sein. >+ Helper method to obtain the status of the <Slot-Server>s rSvr. >+ The required slots IDs (partly converted to Which-IDs of the pool) >+ must be present in rstate. > >- Der SfxDispatcher wird vor der Abfrage geflusht. >+ The SfxDispatcher is flushed before the query. > */ > > { >@@ -2590,9 +2570,9 @@ sal_Bool SfxDispatcher::_FillState > return FALSE; > // Flush(); > >- // Objekt ermitteln und Message an diesem Objekt aufrufen >+ // Determine the object and call the Message of this object > SfxShell *pSh = GetShell(rSvr.GetShellLevel()); >- DBG_ASSERT(pSh, "ObjektShell nicht gefunden"); >+ DBG_ASSERT(pSh, "ObjektShell not found"); > > SfxStateFunc pFunc; > >@@ -2603,7 +2583,7 @@ sal_Bool SfxDispatcher::_FillState > > pSh->CallState( pFunc, rState ); > #ifdef DBG_UTIL >- // pr"ufen, ob IDL (SlotMap) und aktuelle Items "ubereinstimmen >+ // To examine the conformity of IDL (SlotMap) and current Items > if ( DbgIsAssertWarning() && rState.Count() ) > { > SfxInterface *pIF = pSh->GetInterface(); >@@ -2638,10 +2618,9 @@ sal_Bool SfxDispatcher::_FillState > //-------------------------------------------------------------------- > const SfxPoolItem* SfxDispatcher::_Execute( const SfxSlotServer &rSvr ) > >-/* [Beschreibung] >+/* [Description] > >- Diese Methode f"uhrt einen Request "uber einen gecachten <Slot-Server> >- aus. >+ This method performs a request for a cached <Slot-Server>. > */ > > { >@@ -2658,7 +2637,7 @@ const SfxPoolItem* SfxDispatcher::_Execute( const SfxSlotServer &rSvr ) > SFX_APP()->GetMacroConfig()->RegisterSlotId( nSlot ); > > if ( pSlot->IsMode(SFX_SLOT_ASYNCHRON) ) >- //! ignoriert rSvr >+ //! ignore rSvr > { > SfxShell *pShell = GetShell( rSvr.GetShellLevel() ); > SfxDispatcher *pDispat = this; >@@ -2681,10 +2660,10 @@ const SfxPoolItem* SfxDispatcher::_Execute( const SfxSlotServer &rSvr ) > } > else > { >- // Objekt ermitteln und Message an diesem Objekt aufrufen >+ // Determine the object and call the Message of this object > SfxShell *pSh = GetShell(rSvr.GetShellLevel()); > SfxRequest aReq( pSlot->GetSlotId(), SFX_CALLMODE_RECORD, pSh->GetPool() ); >- if ( Call_Impl( *pSh, *pSlot, aReq, sal_True ) ) // von Bindings immer recorden >+ if ( Call_Impl( *pSh, *pSlot, aReq, sal_True ) ) // Bindings always recording > return aReq.GetReturnValue(); > } > } >@@ -2789,12 +2768,11 @@ void SfxDispatcher::ExecutePopup( const ResId &rId, Window *pWin, const Point *p > //-------------------------------------------------------------------- > void SfxDispatcher::Lock( sal_Bool bLock ) > >-/* [Beschreibung] >+/* [Description] > >- Mit dieser Methode kann der SfxDispatcher gesperrt und freigegeben >- werden. Ein gesperrter SfxDispatcher f"uhrt keine <SfxRequest>s mehr >- aus und liefert keine Status-Informationen mehr. Er verh"alt sich >- so als w"aren alle Slots disabled. >+ With this method the SfxDispatcher can be locked and released. A locked >+ SfxDispatcher does not perform <SfxRequest>s and does no longer provide >+ status information. It behaves as if all the slots were disabled. > */ > > { >@@ -2825,10 +2803,10 @@ sal_uInt32 SfxDispatcher::GetObjectBarId( sal_uInt16 nPos ) const > //-------------------------------------------------------------------- > void SfxDispatcher::ResetObjectBars_Impl() > >-/* [Beschreibung] >+/* [Description] > >- Mit dieser Methode werden alle Objectbar-Anforderungen, die dieser >- Dispatcher an das AppWindow hat, beseitigt. >+ With this method all Objectbar requirements which this Dispatcher >+ imposes on the AppWindow are eliminated. > */ > { > for (sal_uInt16 n=0; n<SFX_OBJECTBAR_MAX; n++) >@@ -2848,7 +2826,7 @@ void SfxDispatcher::DebugOutput_Impl() const > if (bFlushed) > DBG_TRACE("Flushed"); > if (pImp->bUpdated) >- DBG_TRACE("Updated"); >+ DBG_TRACE("updated"); > > for ( sal_uInt16 nShell = pImp->aStack.Count(); nShell > 0; --nShell ) > { >@@ -2916,10 +2894,10 @@ sal_Bool SfxDispatcher::GetReadOnly_Impl() const > //------------------------------------------------------------------------- > void SfxDispatcher::SetQuietMode_Impl( sal_Bool bOn ) > >-/* [Beschreibung] >+/* [Description] > >- Bei 'bOn' stellt sich dieser Dispatcher quasi tot und leitet alles >- an den Parent-Dispatcher weiter. >+ With 'bOn' the Dispatcher is quasi dead and transfers everything to the >+ Parent-Dispatcher. > */ > > { >@@ -2932,9 +2910,9 @@ void SfxDispatcher::SetQuietMode_Impl( sal_Bool bOn ) > //------------------------------------------------------------------------- > void SfxDispatcher::SetModalMode_Impl( sal_Bool bOn ) > >-/* [Beschreibung] >+/* [Description] > >- Bei 'bOn' werden nur noch Slots des Parent-Dispatchers gefunden. >+ With 'Bon' only slots of the parent dispatcher are found. > */ > > { >@@ -3013,8 +2991,8 @@ sal_Bool SfxDispatcher::IsReadOnlyShell_Impl( sal_uInt16 nShell ) const > return sal_True; > } > >-// Ein dirty trick, um an die Methoden der private base class von >-// SfxShellStack_Impl heranzukommen >+// A dirty trick, to get hold of the methods of the private base class >+// SfxShellStack_Impl > class StackAccess_Impl : public SfxShellStack_Implarr_ > {}; > >@@ -3022,7 +3000,7 @@ void SfxDispatcher::InsertShell_Impl( SfxShell& rShell, sal_uInt16 nPos ) > { > Flush(); > >- // Der cast geht, weil SfxShellStack_Impl keine eigenen member hat >+ // The cast is because SfxShellStack_Impl member has non of its own > ((StackAccess_Impl*) (&pImp->aStack))->Insert( nPos, &rShell ); > rShell.SetDisableFlags( pImp->nDisableFlags ); > rShell.DoActivate_Impl(pImp->pFrame, sal_True); >@@ -3040,7 +3018,7 @@ void SfxDispatcher::RemoveShell_Impl( SfxShell& rShell ) > { > Flush(); > >- // Der cast geht, weil SfxShellStack_Impl keine eigenen member hat >+ // The cast is because SfxShellStack_Impl member has non of its own > StackAccess_Impl& rStack = *((StackAccess_Impl*) (&pImp->aStack)); > sal_uInt16 nCount = rStack.Count(); > for ( sal_uInt16 n=0; n<nCount; ++n ) >@@ -3068,8 +3046,9 @@ sal_Bool SfxDispatcher::IsAllowed > sal_uInt16 nSlot > ) const > /* >- [Beschreibung] >- Die Methode prueft, ob der Zugriff auf diese Schnittstelle erlaubt ist. >+ [Description] >+ >+ The method checks whether the access is allowed on this interface. > */ > { > if ( !pImp->pDisableList ) >@@ -3077,7 +3056,7 @@ sal_Bool SfxDispatcher::IsAllowed > return sal_True; > } > >- // BinSearch in der DisableListe >+ // BinSearch in the disable list > SvUShorts& rList = *pImp->pDisableList; > sal_uInt16 nCount = rList.Count(); > sal_uInt16 nLow = 0, nMid = 0, nHigh; >@@ -3087,7 +3066,7 @@ sal_Bool SfxDispatcher::IsAllowed > while ( !bFound && nLow <= nHigh ) > { > nMid = (nLow + nHigh) >> 1; >- DBG_ASSERT( nMid < nCount, "bsearch ist buggy" ); >+ DBG_ASSERT( nMid < nCount, "bsearch is buggy" ); > > int nDiff = (int) nSlot - (int) rList[nMid]; > if ( nDiff < 0) >@@ -3107,7 +3086,7 @@ sal_Bool SfxDispatcher::IsAllowed > } > > #ifdef _DEBUG >- // Slot in der Liste gefunden ? >+ // Slot found in the List? > sal_uInt16 nPos = bFound ? nMid : nLow; > > DBG_ASSERT( nPos <= nCount, "" ); >diff --git a/sfx2/source/control/macrconf.cxx b/sfx2/source/control/macrconf.cxx >index ad08518..fc1c745 100644 >--- a/sfx2/source/control/macrconf.cxx >+++ b/sfx2/source/control/macrconf.cxx >@@ -179,7 +179,7 @@ SfxMacroInfo::SfxMacroInfo( const String& rURL ) : > if ( aTmp.GetTokenCount('/') > 3 ) > { > // 'macro:///lib.mod.proc(args)' => Macro via App-BASIC-Mgr >- // 'macro://[docname|.]/lib.mod.proc(args)' => Macro via zugehoerigen Doc-BASIC-Mgr >+ // 'macro://[docname|.]/lib.mod.proc(args)' => Macro via included Doc-BASIC-Mgr > if ( aTmp.CompareToAscii("///", 3 ) != COMPARE_EQUAL ) > bAppBasic = FALSE; > aTmp = rURL.GetToken( 3, '/' ); >@@ -299,14 +299,16 @@ String SfxMacroInfo::GetQualifiedName() const > aMacroName += '.'; > } > >- // Wg. ::com::sun::star::script::JavaScript kein Zerlegen des Strings mehr >+ // due to ::com::sun::star::script::JavaScript >+ // no more disassembly of the string > aMacroName += aMethodName; > return aMacroName; > } > > String SfxMacroInfo::GetFullQualifiedName() const > { >- // Liefert nur Unsinn, wenn f"ur ein ::com::sun::star::script::JavaScript aufgerufen ! >+ // Returns only nonsense, when called for a >+ // ::com::sun::star::script::JavaScript ! > String aRet; > if ( bAppBasic ) > aRet = SFX_APP()->GetName(); >@@ -321,7 +323,7 @@ String SfxMacroInfo::GetURL() const > return aMethodName; > > // 'macro:///lib.mod.proc(args)' => Macro via App-BASIC-Mgr >- // 'macro://[docname|.]/lib.mod.proc(args)' => Macro via zugehoerigen Doc-BASIC-Mgr >+ // 'macro://[docname|.]/lib.mod.proc(args)' => Macro via included Doc-BASIC-Mgr > // 'macro://obj.method(args)' => Object via App-BASIC-Mgr > String aURL( String::CreateFromAscii("macro://") ); > if ( !bAppBasic ) >@@ -436,17 +438,18 @@ SFX_EXEC_STUB( SfxApplication, MacroExec_Impl ) > > sal_uInt16 SfxMacroConfig::GetSlotId(SfxMacroInfoPtr pInfo) > { >- sal_uInt16 nCount = pImp->aArr.Count(); // Macro suchen >+ sal_uInt16 nCount = pImp->aArr.Count(); // Search for Macro > sal_uInt16 i; > for (i=0; i<nCount; i++) > if ((*(pImp->aArr)[i]) == (*pInfo)) > break; > > if (i == nCount) >- { // Macro noch unbekannt >+ { >+ // Macro still unknown > nCount = aIdArray.Count(); > sal_uInt16 n; >- for (n=0; n<nCount; n++) // freie SlotId suchen >+ for (n=0; n<nCount; n++) // Seearch for free SlotId > if (aIdArray[n] > SID_MACRO_START + n) > break; > >@@ -479,7 +482,7 @@ sal_uInt16 SfxMacroConfig::GetSlotId(SfxMacroInfoPtr pInfo) > else > pNewSlot->pNextSlot = pNewSlot; > >- // Macro uebernehmen >+ // Take over Macro > SfxMacroInfoPtr pNewInfo = new SfxMacroInfo(*pInfo); > pNewInfo->nSlotId = SID_MACRO_START + n; > pImp->aArr.Insert(pNewInfo,n); >@@ -500,7 +503,7 @@ sal_uInt16 SfxMacroConfig::GetSlotId(SfxMacroInfoPtr pInfo) > > void SfxMacroConfig::ReleaseSlotId(sal_uInt16 nId) > { >- DBG_ASSERT( IsMacroSlot( nId ), "SlotId ist kein Macro!"); >+ DBG_ASSERT( IsMacroSlot( nId ), "SlotId is no Macro!"); > > sal_uInt16 nCount = pImp->aArr.Count(); > for (sal_uInt16 i=0; i<nCount; i++) >@@ -511,23 +514,23 @@ void SfxMacroConfig::ReleaseSlotId(sal_uInt16 nId) > pInfo->nRefCnt--; > if (pInfo->nRefCnt == 0) > { >- // Slot wird nicht mehr referenziert, also holen >+ // Slot is no longer referenced, so get > SfxSlot *pSlot = pInfo->pSlot; > >- // Slot aus der Verkettung rausnehmen >+ // Take out Slot from the concatenation > while (pSlot->pNextSlot != pInfo->pSlot) > pSlot = (SfxSlot*) pSlot->pNextSlot; > pSlot->pNextSlot = pInfo->pSlot->pNextSlot; > >- // Slot selbst kurz schlie\sen >+ // Slot close itself briefly > pSlot = pInfo->pSlot; > pSlot->pNextSlot = pSlot; > >- // MacroInfo aus Array entfernen, damit sie kein Unheil >- // anrichten kann >+ // Remove Macro info from array so that it can not cause >+ // any harm > pImp->aArr.Remove(i); > >- // SlotId wieder freigeben >+ // Release SlotId again > sal_uInt16 nIdCount = aIdArray.Count(); > for (sal_uInt16 n=0; n<nIdCount; n++) > { >@@ -538,9 +541,9 @@ void SfxMacroConfig::ReleaseSlotId(sal_uInt16 nId) > } > } > >- // Sofern nicht die Applikation heruntergefahren wird, mu\s >- // der Slot asynchron gel"oscht werden, falls er in seinem >- // eigenen Execute abgeschossen wird! >+ // Unless the application is not shut down, then >+ // the Slot has to be deleted asynchronously if cancelled in >+ // its own Execute! > if ( !SFX_APP()->Get_Impl()->bInQuit ) > pImp->nEventId = Application::PostUserEvent( LINK(this, SfxMacroConfig, EventHdl_Impl), pInfo ); > else >@@ -550,14 +553,14 @@ void SfxMacroConfig::ReleaseSlotId(sal_uInt16 nId) > } > } > >- DBG_ERROR("Macro-SlotId nicht gefunden!"); >+ DBG_ERROR("Macro-SlotId is not found!"); > } > > //========================================================================== > > void SfxMacroConfig::RegisterSlotId(sal_uInt16 nId) > { >- DBG_ASSERT( IsMacroSlot( nId ), "SlotId ist kein Macro!"); >+ DBG_ASSERT( IsMacroSlot( nId ), "SlotId is no Macro!"); > > sal_uInt16 nCount = pImp->aArr.Count(); > for (sal_uInt16 i=0; i<nCount; i++) >@@ -569,7 +572,7 @@ void SfxMacroConfig::RegisterSlotId(sal_uInt16 nId) > } > } > >- DBG_ERROR("Macro-SlotId nicht gefunden!"); >+ DBG_ERROR("Macro-SlotId is not found!"); > } > > //========================================================================== >@@ -608,7 +611,7 @@ sal_Bool SfxMacroConfig::ExecuteMacro( sal_uInt16 nId, const String& rArgs ) con > SvxMacro aMacro( pInfo->GetQualifiedName(), pInfo->GetBasicName(), STARBASIC ); > sal_Bool bRet = ExecuteMacro( pSh, &aMacro, rArgs ); > >- // Release, da im Dispatcher-Execute ein Register gemacht wurde >+ // Release, because a register was created in the dispatcher Execute > ((SfxMacroConfig*)this)->ReleaseSlotId( nId ); > return bRet; > } >@@ -617,11 +620,11 @@ sal_Bool SfxMacroConfig::ExecuteMacro( SfxObjectShell *pSh, const SvxMacro* pMac > { > SfxApplication *pApp = SFX_APP(); > >- // Name des Macros oder Scripts bzw. ScriptCode >+ // Name of the Macros or Scripts (ScriptCode) > String aCode( pMacro->GetMacName() ); > ErrCode nErr = ERRCODE_NONE; > >- // Ist es ein Basic-Macro ? >+ // Is it a Basic-Macro ? > ScriptType eSType = pMacro->GetScriptType(); > sal_Bool bIsBasic = eSType == STARBASIC; > sal_Bool bIsStarScript = ( eSType == EXTENDED_STYPE && pMacro->GetLibName().SearchAscii( "StarScript" ) != STRING_NOTFOUND ); >@@ -633,10 +636,10 @@ sal_Bool SfxMacroConfig::ExecuteMacro( SfxObjectShell *pSh, const SvxMacro* pMac > BasicManager *pAppMgr = SFX_APP()->GetBasicManager(); > if( bIsBasic ) > { >- // BasicManager von Document? >+ // BasicManager of the Document? > BasicManager *pMgr = pSh ? pSh->GetBasicManager() : NULL; > >- // Da leider der Name zwischendurch h"aufig gewechselt hat ... >+ // As the name has unfortunately been changed often ... > if( SFX_APP()->GetName() == pMacro->GetLibName() || > pMacro->GetLibName().EqualsAscii("StarDesktop") ) > pMgr = pAppMgr; >@@ -676,16 +679,16 @@ sal_Bool SfxMacroConfig::CheckMacro( SfxObjectShell *pSh, const SvxMacro* pMacro > { > SfxApplication *pApp = SFX_APP(); > >- // Name des Macros oder Scripts bzw. ScriptCode >+ // Name of Macros or Scripts (ScriptCode) > String aCode( pMacro->GetMacName() ); > ErrCode nErr = ERRCODE_NONE; > >- // BasicManager von Document oder Application >+ // BasicManager of Document or Application > pApp->EnterBasicCall(); > BasicManager *pAppMgr = SFX_APP()->GetBasicManager(); > BasicManager *pMgr = pSh ? pSh->GetBasicManager() : NULL; > >- // Da leider der Name zwischendurch h"aufig gewechselt hat ... >+ // As the name has unfortunately been changed often ... > if( SFX_APP()->GetName() == pMacro->GetLibName() || > pMacro->GetLibName().EqualsAscii("StarDesktop") ) > pMgr = pAppMgr; >@@ -706,14 +709,15 @@ sal_Bool SfxMacroConfig::CheckMacro( sal_uInt16 nId ) const > if ( !pInfo ) > return sal_False; > >- // Basic nur initialisieren, wenn default nicht ::com::sun::star::script::JavaScript; dann mu\s >- // in IsBasic() sowieso das Basic angelegt werden >+ // only initialize Basic, when default is not >+ // ::com::sun::star::script::JavaScript; then the Basic has to be created >+ // anyway in IsBasic() > SfxObjectShell* pSh = SfxObjectShell::Current(); > > SfxApplication *pApp = SFX_APP(); > pApp->EnterBasicCall(); > >- // BasicManager von Document oder Application >+ // BasicManager of Document or Application > BasicManager *pAppMgr = SFX_APP()->GetBasicManager(); > BasicManager *pMgr = pSh ? pSh->GetBasicManager() : NULL; > >diff --git a/sfx2/source/control/macro.cxx b/sfx2/source/control/macro.cxx >index 33eba4d..aaf58b7 100644 >--- a/sfx2/source/control/macro.cxx >+++ b/sfx2/source/control/macro.cxx >@@ -46,72 +46,70 @@ SV_IMPL_PTRARR( SfxStatements_Impl, SfxMacroStatement* ); > > struct SfxMacro_Impl > >-/* [Beschreibung] >+/* [Description] > >- Implementations-Struktur der Klasse <SfxMacro>. >+ Implementation structure for the <SfxMacro> class. > */ > > { >- SfxMacroMode eMode; /* Zweck der <SfxMacro>-Instanz, >- Bedeutung siehe enum <SfxMacroMode> */ >- SfxStatements_Impl aList; /* Liste von aufgezeichneten Statements */ >+ SfxMacroMode eMode; /* purpose of the <SfxMacro> instance, >+ for meaning see enum <SfxMacroMode> */ >+ SfxStatements_Impl aList; /* List of recorded Statements */ > }; > > //==================================================================== > > SfxMacroStatement::SfxMacroStatement > ( >- const SfxShell& /*rShell*/, // <SfxShell>, die den Request ausf"uhrte >- const String& /*rTarget*/, // Name des Zielobjektes vor der Ausf"urhung >- BOOL /*bAbsolute*/, // obsolet >- const SfxSlot& rSlot, // der <SfxSlot>, der das Statement abspielen kann >- BOOL bRequestDone, // wurde der Request tats"achlich ausgef"uhrt >+ const SfxShell& /*rShell*/, // <SfxShell> which excexutes the Request >+ const String& /*rTarget*/, // Name of the target object for the >+ // excecution >+ BOOL /*bAbsolute*/, // obsolete >+ const SfxSlot& rSlot, // the <SfxSlot>, which can read the >+ // statement >+ BOOL bRequestDone, // Was the Request really excecuted > ::com::sun::star::uno::Sequence < ::com::sun::star::beans::PropertyValue >& rArgs > ) > >-/* [Beschreibung] >+/* [Description] > >- Dieser Konstruktor der Klasse SfxMacroStatement erzeugt ein Statement, >- bei dem ein Objekt angesprochen wird, welches durch 'rShell' angegeben >- ist. Dabei erfolgt die Addressierung je nach 'bAbsolute' absolut, >- also z.B. als '[mydoc.sdc]' oder relativ, also z.B. 'ActiveDocument'. >+ This constructor of the SfxMacroStatement class generates a statement in >+ which an object is brought up, which is given by 'rShell'. Thus It is >+ addressing the always after 'bAbsolute' absolute, for example, as '[mydoc.sdc]', >+ or relative, that is 'active document'. > >- Je nach Art der Subklasse von 'rShell' ergeben sich folgende >- Ausdr"ucke: >+ Depending on the subclass of 'rShell', the following terms: > >- | absolut relativ >+ | absolute relative > ----------------------------------------------------------------------- > SfxApplication' | 'StarCalc' 'Application' > SfxViewFrame' | '[mydoc.sdc:1]' 'ActiveWindow' > SfxViewShell' | '[mydoc.sdc:1]' 'AvtiveWindow' > SfxObjectShell' | '[mydoc.sdc]' 'ActiveDocument' >- sonstige (Sub-Shells) | '[mydoc.sdc:1]' 'ActiveWindow' >+ Other (Sub-Shells) | '[mydoc.sdc:1]' 'ActiveWindow' > >- Dabei sind 'StarCalc' stellvertretend fuer den Namen der Applikation >- (Application::GetAppName()const). In der absoluten Fassung k"onnte >- die Selektion auch deskriptiv z.B. als 'CellSelection("A5-D8")') >- angesprochen werden, dazu mu\ jedoch vom Anwendungsprogrammierer der >- Konstruktor <SfxMacroStatement::SfxMacroStatement(const String&, >- const SfxSlot&,BOOL,SfxArguments*)> verwendet werden. >+ Thus 'StarCalc' is a proxy for the name of the application >+ (Application::GetAppName()const). In the absolute sense of the selection >+ could be addressed as descriptive as in 'cell selection ("A5-D8")'), to do this >+ the application programmer must however use the constructor >+ <SfxMacroStatement::SfxMacroStatement(const String&, >+ const SfxSlot&,BOOL,SfxArguments*)>. > >- F"ur das so bezeichnete Objekt wird dann je nach Typ des Slots >- eine Zuweisung an eines seiner Properties oder der Aufruf einer seiner >- Methoden ausgedr"uckt. >+ For the so-called object is then, depending on the type of slots, >+ expressed as an assignment to one of its properties or calling its methods. > >+ [Example] > >- [Beispiele] >- >- absolut: >+ absolute: > SCalc3.OpenDocument( "\docs\mydoc.sdd", "StarDraw Presentation", 0, 0 ) > [mydoc.sdd].Activate() > [mydoc.sdd:1].SwitchToView( 2 ) > [mydoc.sdc:1:1].CellSelection( "A5-D8" ).LineColor = 192357 > >- relativ: >+ relative: > ActiveWindow.LineColor = 192357 > >- >- [Querverweise] >+ [Cross-reference] > > <SfxMacroStatement::SfxMacroStatement(const String&,const SfxSlot&,BOOL,SfxArguments*)> > <SfxMacroStatement::SfxMacroStatement(const String&)> >@@ -122,13 +120,13 @@ SfxMacroStatement::SfxMacroStatement > bDone( bRequestDone ), > pDummy( 0 ) > { >- // Workaround Recording nicht exportierter Slots (#25386#) >+ // Workaround Recording non exported Slots (#25386#) > if ( !rSlot.pName ) > return; > > aStatement = DEFINE_CONST_UNICODE("Selection"); > >- // an diesen Objekt-Ausdruck den Methoden-/Property-Namen und Parameter >+ // to these object expression of the Method-/Property-Name and parameters > GenerateNameAndArgs_Impl( SfxRequest::GetRecordingMacro(), rSlot, bRequestDone, aArgs); > } > >@@ -136,16 +134,16 @@ SfxMacroStatement::SfxMacroStatement > > SfxMacroStatement::SfxMacroStatement > ( >- const String& rTarget, // Objekt, was beim Playing angesprochen wird >- const SfxSlot& rSlot, // der <SfxSlot>, der das Statement abspielen kann >- BOOL bRequestDone, // wurde der Request tats"achlich ausgef"uhrt >+ const String& rTarget, // The Object which is addressed while playing >+ const SfxSlot& rSlot, // The <SfxSlot>, which can playback the statement >+ BOOL bRequestDone, // was the Request actually performed > ::com::sun::star::uno::Sequence < ::com::sun::star::beans::PropertyValue >& rArgs > ) > >-/* [Beschreibung] >+/* [Description] > > >- [Querverweise] >+ [Cross-reference] > > <SfxMacroStatement::SfxMacroStatement(const String&)> > <SfxMacroStatement::SfxMacroStatement(const SfxShell&,BOOL,const SfxSlot&,BOOL,SfxArguments*)> >@@ -165,19 +163,18 @@ SfxMacroStatement::SfxMacroStatement > > SfxMacroStatement::SfxMacroStatement > ( >- const String& rStatement // manuell erzeugte(s) Statement(s) >+ const String& rStatement // manually generated statement(s) > ) > >-/* [Beschreibung] >- >- Dieser Konstruktor erzeugt eine SfxMacroStatement-Instanz, deren >- Aufbau vollst"andig vom Applikationsentwickler bestimmt wird. Da der >- angegebene String auch mehrere mit CR/LF getrennte Statements >- enthalten darf, ist damit ein weitgehender Eingriff in das Aufzeichnen >- von BASIC-Makros m"oglich, um Spezialf"alle zu behandeln. >+/* [Description] > >+ This constructor creates a SfxMacroStatement instance, its structure is >+ determined completely by the application developer. Because the specified >+ string may contain several statements separated with CR/LF, which enables >+ a extensive in the recording of BASIC-macros, in order to handle special >+ cases. > >- [Querverweise] >+ [Cross-reference] > > <SfxMacroStatement::SfxMacroStatement(const String&,const SfxSlot&,BOOL,SfxArguments*)> > <SfxMacroStatement::SfxMacroStatement(const SfxShell&,BOOL,const SfxSlot&,BOOL,SfxArguments*)> >@@ -194,12 +191,12 @@ SfxMacroStatement::SfxMacroStatement > > SfxMacroStatement::SfxMacroStatement > ( >- const SfxMacroStatement& rOrig // Original, von dem kopiert wird >+ const SfxMacroStatement& rOrig // Original, from which it will be copied > ) > >-/* [Beschreibung] >+/* [Description] > >- Copy-Konstruktor der SfxMacroStatement-Klasse. >+ Copy constructor of the sSfxMacroStatement class. > */ > > : nSlotId( rOrig.nSlotId ), >@@ -214,10 +211,10 @@ SfxMacroStatement::SfxMacroStatement > > SfxMacroStatement::~SfxMacroStatement() > >-/* [Beschreibung] >+/* [Description] > >- Destruktor der Klasse SfxMacroStatement. Gibt die Liste der >- aktuellen Parameter frei. >+ Destructor of the SfxMacroStatement class. Frees the list of the >+ current parameters. > */ > > { >@@ -227,18 +224,17 @@ SfxMacroStatement::~SfxMacroStatement() > > void SfxMacroStatement::GenerateNameAndArgs_Impl > ( >- SfxMacro* /*pMacro*/, // darin wird aufgezeichnet >- const SfxSlot& rSlot, // der Slot, der das Statement abspielen kann >- BOOL bRequestDone, // TRUE=wurde ausgef"uhrt, FALSE=abgebrochen >+ SfxMacro* /*pMacro*/, // in this is recorded >+ const SfxSlot& rSlot, // the slot, which can playback the statement >+ BOOL bRequestDone, // TRUE=was executed, FALSE=cancelled > ::com::sun::star::uno::Sequence < ::com::sun::star::beans::PropertyValue >& /*rArgs*/ > ) > >-/* [Beschreibung] >+/* [Description] > >- Interne Hilfsmethode zum generieren des Funktions-/Property-Names >- sowie der Parameter. Diese Methode wird nur verwendet, wenn der >- Anwendungsprogrammierer keinen eigenen Source an den <SfxRequest> >- geh"angt hat. >+ Internal utility method for generating the functions-/property-names as >+ well as the parameter. This method is only used if the application >+ programmer has not attached his own source to the <SfxRequest>. > */ > > { >@@ -246,18 +242,18 @@ void SfxMacroStatement::GenerateNameAndArgs_Impl > && rSlot.pName[0] != '.' ) > aStatement += '.'; > >- // der Name des Slots ist der Name der Methode / des Properties >+ // The name of the slots is the name of the method or properties > aStatement += String::CreateFromAscii(rSlot.pName); > if ( rSlot.IsMode(SFX_SLOT_METHOD) ) > aStatement += DEFINE_CONST_UNICODE("( "); > else > aStatement += DEFINE_CONST_UNICODE(" = "); > >- // alle zusammengesuchten Parameter rausschreiben >+ // Print all required Parameters > if ( aArgs.getLength() ) > for ( USHORT nArg = 0; nArg < aArgs.getLength(); ++nArg ) > { >- // den Parameter textuell darstellen >+ // represent the parameters textually > String aArg; > ::com::sun::star::uno::Any& rValue = aArgs[nArg].Value; > ::com::sun::star::uno::Type pType = rValue.getValueType(); >@@ -284,7 +280,7 @@ void SfxMacroStatement::GenerateNameAndArgs_Impl > ::rtl::OUString sTemp; > rValue >>= sTemp; > >- // Anf"uhrungszeichen werden verdoppelt >+ // Quotation marks are doubled > XubString aRecordable( sTemp ); > USHORT nPos = 0; > while ( TRUE ) >@@ -295,12 +291,12 @@ void SfxMacroStatement::GenerateNameAndArgs_Impl > nPos += 2; > } > >- // nicht druckbare Zeichen werden als chr$(...) geschrieben >+ // non-printable characters are written as chr $(...) > bool bPrevReplaced = false; > for ( USHORT n = 0; n < aRecordable.Len(); ++n ) > { > sal_Unicode cChar = aRecordable.GetChar(n); >- if ( !( cChar>=32 && cChar!=127 ) ) // ALS ERSATZ FUER String::IsPrintable()! >+ if ( !( cChar>=32 && cChar!=127 ) ) // As replacement for String::IsPrintable()! > { > XubString aReplacement( DEFINE_CONST_UNICODE("+chr$(") ); > aReplacement += cChar; >@@ -325,7 +321,7 @@ void SfxMacroStatement::GenerateNameAndArgs_Impl > else > bPrevReplaced = false; > >- // Argument in Anf"uhrungszeichen >+ // Argument in quotation marks > aArg = '"'; > aArg += aRecordable; > aArg += '"'; >@@ -337,12 +333,12 @@ void SfxMacroStatement::GenerateNameAndArgs_Impl > pType == ::getVoidCppuType(), "Unknown Type in recorder!" ); > } > >- // den Parameter anh"angen >+ // Attach the parameter > aStatement += aArg; > aStatement += DEFINE_CONST_UNICODE(", "); > } > >- // Statement beeden >+ // End statement > if ( aArgs.getLength() ) > aStatement.Erase( aStatement.Len() - 2, 1 ); > else >@@ -351,7 +347,7 @@ void SfxMacroStatement::GenerateNameAndArgs_Impl > aStatement += ')'; > > if ( !bRequestDone ) >- // nicht als "Done()" gekennzeichnete Statements auskommentieren >+ // not comment out the "Done ()" marked statements > aStatement.InsertAscii( "rem ", 0 ); > } > >@@ -359,26 +355,25 @@ void SfxMacroStatement::GenerateNameAndArgs_Impl > > SfxMacro::SfxMacro > ( >- SfxMacroMode eMode // Zweck der Instanz, siehe <SfxMacroMode> >+ SfxMacroMode eMode // Purpose of the instance, see <SfxMacroMode> > ) > >-/* [Beschreibung] >+/* [Description] > >- Konstruktor der Klasse SfxMacro. Instanzen dieser Klasse werden im >- SFx zu zwei Zwecken ben"otigt: >+ Constructor of the SfxMacro class. Instances of this class are required >+ for two purposes in SFx: > >- 1. zum Aufzeichnen von Makros >- In diesem Fall wird der Konstruktor mit SFX_MACRO_RECORDINGABSOLUTE >- oder SFX_MACRO_RECORDINGRELATIVE aufgerufen. Es sollte sich um eine >- Instanz einer abgeleiteten Klasse handeln, um in der Ableitung >- die Information dar"uber unterzubringen, wo das Makro gespeichert >- werden soll. Ein solches Makro solle sich dann in seinem Destruktor >- an der vom Benutzer gew"ahlten Stelle speichern. >+ 1. for recording macros >+ In this cas is th constructor called with SFX_MACRO_RECORDINGABSOLUTE or >+ SFX_MACRO_RECORDINGRELATIVE. Should be an instance of a derived class, >+ in order to acommodate the derivation of information, where the macro >+ should be saved. Such a macro should, in its destructor, be saved at the >+ location specified by the user. > >- 2. zum Zuordnen von exisitierenden Makros >- In diesem Fall wird der Konstruktor mit SFX_MACRO_EXISTING aufgerufen. >- Eine solche Instanz wird z.B. ben"otigt, wenn Makros auf Events >- oder <SfxControllerItem>s konfiguriert werden sollen. >+ 2. Assignment of exisiting macros >+ In this case the constructor is called with SFX_MACRO_EXISTING. >+ Such a instance is for example needed when macros are to be configured for >+ events or <SfxControllerItem>s. > */ > > : pImp( new SfxMacro_Impl ) >@@ -391,15 +386,13 @@ SfxMacro::SfxMacro > > SfxMacro::~SfxMacro() > >-/* [Beschreibung] >+/* [Description] > >- Virtueller Destruktor der Klasse SfxMacro. Dieser sollte in den >- abgeleiteten Klassen "uberladen werden, um in den Modi >- SFX_MACRO_RECORDINGABSOLUTE und SFX_MACRO_RECORDINGRELATIVE den >- aufgezeichneten Source abzuspeichern. >+ Virtual Destructor of the SfxMacro class. This should be overloaded in >+ the derived classes to save the recorded source in the mode >+ SFX_MACRO_RECORDINGABSOLUTE and SFX_MACRO_RECORDINGRELATIVE. > >- >- [Querverweise] >+ [Cross-reference] > > <SfxMacro::GenerateSource()const> > */ >@@ -416,13 +409,12 @@ SfxMacro::~SfxMacro() > > SfxMacroMode SfxMacro::GetMode() const > >-/* [Beschreibung] >- >- Liefert den Modus, der besagt zu welchem Zweck das SfxMacro konstruiert >- wurde. >+/* [Description] > >+ Returns the mode, which indicates for what purpose this SfxMacro was >+ constructed. > >- [Querverweise] >+ [Cross-reference] > > enum <SfxMacroMode> > */ >@@ -435,21 +427,20 @@ SfxMacroMode SfxMacro::GetMode() const > > void SfxMacro::Record > ( >- SfxMacroStatement* pStatement // aufzuzeichnendes <SfxMacroStatement> >+ SfxMacroStatement* pStatement // the recordning <SfxMacroStatement> > ) > >-/* [Beschreibung] >- >- Diese Methode zeichnet das als Parameter "ubergeben Statement auf. >- Die Instanz auf die der "ubergebe Pointer zeigt, geht in das Eigentum >- des SfxMacro "uber. >+/* [Description] > >- Der Aufruf ist nur g"ultig, wenn es sich um ein SfxMacro handelt, >- welches mit SFX_MACRO_RECORDINGABSOLUTE oder SFX_MACRO_RECORDINGRELATIVE >- konstruiert wirde. >+ This method features the parameters passed on as a Statement. The >+ instance to which the pointer points is transfered to the ownership >+ of SfxMacro. > >+ The call is only valid if it is about a SfxMacro, which was constructed >+ with SFX_MACRO_RECORDINGRELATIVE or SFX_MACRO_RECORDINGABSOLUTE and is >+ available as an already recorded statement. > >- [Querverweise] >+ [Cross-reference] > > <SfxMacro::Replace(SfxMacroStatement*)> > <SfxMacro::Remove()> >@@ -465,35 +456,30 @@ void SfxMacro::Record > > void SfxMacro::Replace > ( >- SfxMacroStatement* pStatement // aufzuzeichnendes <SfxMacroStatement> >+ SfxMacroStatement* pStatement // the recording <SfxMacroStatement> > ) > >-/* [Beschreibung] >+/* [Description] > >- Diese Methode zeichnet das als Parameter "ubergeben Statement auf. >- Dabei wird das jeweils zuletzt aufgezeichnete Statement "uberschrieben. >- Die Instanz auf die der "ubergebe Pointer zeigt, geht in das Eigentum >- des SfxMacro "uber. >+ This method records the statement passed on as a parameter. This will >+ overwrite the last recorded statement. The instance to which the passed >+ pointer points is transfered to the ownership of the SfxMacro. > >- Mit dieser Methode ist es m"oglich, Statements zusammenzufassen. Z.B. >- anstelle f"unfmal hintereinander 'CursorLeft()' aufzurufen, k"onnte >- das zu 'CursorLeft(5)' zusammengefa\st werden. Oder anstelle ein Wort >- Buchstabe f"ur Buchstabe aufzubauen, k"onnte dies durch ein einziges >- Statement 'InsertString("Hallo")' ersetzt werden. >+ With this method it is possible to combine statements. For example, instead >+ of calling the 'CursorLeft()' five times could be summarized as >+ 'CursorLeft (5)'. Or rather than building a word letter by letter, this >+ could be done by a single statement 'InsertString("Hello")'. > >- Der Aufruf ist nur g"ultig, wenn es sich um ein SfxMacro handelt, >- welches mit SFX_MACRO_RECORDINGABSOLUTE oder SFX_MACRO_RECORDINGRELATIVE >- konstruiert wurde und bereits ein aufgezeichnetes Statement vorhanden >- ist. >+ The call is only valid if it is about a SfxMacro, which was constructed >+ with SFX_MACRO_RECORDINGRELATIVE or SFX_MACRO_RECORDINGABSOLUTE and is >+ available as an already recorded statement. > >+ [Note] > >- [Anmerkung] >+ This method is typically called from the execute methods of >+ <SfxSlot>s created by the application developers. > >- Diese Methode wird typischerweise aus den Execute-Methoden der >- <SfxSlot>s von den Applikationsentwicklern gerufen. >- >- >- [Querverweise] >+ [Cross-reference] > > <SfxMacro::Record(SfxMacroStatement*)> > <SfxMacro::Remove()> >@@ -511,30 +497,26 @@ void SfxMacro::Replace > > void SfxMacro::Remove() > >-/* [Beschreibung] >- >- Diese Methode l"oscht das zuletzt aufgezeichnete <SfxMacroStatement> >- und entfernt es aus dem Macro. >+/* [Description] > >- Mit dieser Methode ist es m"oglich, Statements zusammenzufassen. Z.B. >- anstelle f"unfmal hintereinander 'CursorLeft()' aufzurufen, k"onnte >- das zu 'CursorLeft(5)' zusammengefa\st werden. Oder anstelle ein Wort >- Buchstabe f"ur Buchstabe aufzubauen, k"onnte dies durch ein einziges >- Statement 'InsertString("Hallo")' ersetzt werden. >+ This method deletes the last recorded <SfxMacroStatement> and removes >+ it from the macro. > >- Der Aufruf ist nur g"ultig, wenn es sich um ein SfxMacro handelt, >- welches mit SFX_MACRO_RECORDINGABSOLUTE oder SFX_MACRO_RECORDINGRELATIVE >- konstruiert wurde und bereits ein aufgezeichnetes Statement vorhanden >- ist. >+ With this method it is possible to combine statements. For example, instead >+ of calling the 'CursorLeft()' five times could be summarized as >+ 'CursorLeft (5)'. Or rather than building a word letter by letter, this >+ could be done by a single statement 'InsertString("Hello")'. > >+ The call is only valid if it is about a SfxMacro, which was constructed >+ with SFX_MACRO_RECORDINGRELATIVE or SFX_MACRO_RECORDINGABSOLUTE and is >+ available as an already recorded statement. > >- [Anmerkung] >+ [Note] > >- Diese Methode wird typischerweise aus den Execute-Methoden der >- <SfxSlot>s von den Applikationsentwicklern gerufen. >+ This method is typically called from the the Execute methods of <SfxSlot>s >+ by the application developer. > >- >- [Querverweise] >+ [Cross-reference] > > <SfxMacro::Replace(SfxMacroStatement*)> > <SfxMacro::Record(SfxMacroStatement*)> >@@ -551,19 +533,17 @@ void SfxMacro::Remove() > > const SfxMacroStatement* SfxMacro::GetLastStatement() const > >-/* [Beschreibung] >- >- Mit dieser Methode kann auf das jeweils zuletzt aufgezeichnete Statement >- lesend zugegriffen werden. Zusammen mit der Methode >- <SfxMacro::Replace(SfxMacroStatement*)> ergibt sich dadurch die >- M"oglichkeit, Statements zusammenzufassen. >+/* [Description] > >- Der Aufruf ist nur g"ultig, wenn es sich um ein SfxMacro handelt, >- welches mit SFX_MACRO_RECORDINGABSOLUTE oder SFX_MACRO_RECORDINGRELATIVE >- konstruiert wurde. >+ This method enables read access to the last recorded statement. >+ Together with the method <SfxMacro::Replace(SfxMacroStatement*)> this opens >+ for the possibility to summarize statements. > >+ The call is only valid if it is about a SfxMacro, which was constructed >+ with SFX_MACRO_RECORDINGRELATIVE or SFX_MACRO_RECORDINGABSOLUTE and is >+ available as an already recorded statement. > >- [Querverweise] >+ [Cross-reference] > > <SfxMacro::Record(SfxMacroStatement*)> > <SfxMacro::Replace(SfxMacroStatement*)> >@@ -580,15 +560,14 @@ const SfxMacroStatement* SfxMacro::GetLastStatement() const > > String SfxMacro::GenerateSource() const > >-/* [Beschreibung] >- >- Diese Funktion generiert aus den, seit dem Konstruieren der Instanz >- bis zum Zeitpunkt des Aufrufs dieser Methode aufgezeichneten >- <SfxMacroStatement>s einen BASIC-Sourcecode, der die Statements, >- jedoch nicht den Header ('Sub X') und den Footer ('End Sub') enth"alt. >+/* [Description] > >+ This function generates BASIC source code that contains the statements, but >+ does not contain the header ('Sub X') and Footer ('End Sub') from recorded >+ <SfxMacroStatement> since the construction of the instance until the time >+ of calling this method. > >- [Querverweise] >+ [Cross-reference] > > <SfxMacro::Record(SfxMacroStatement*)> > <SfxMacro::Repeat(SfxMacroStatement*)> >diff --git a/sfx2/source/control/makefile.mk b/sfx2/source/control/makefile.mk >index 8679758..4dc271c 100644 >--- a/sfx2/source/control/makefile.mk >+++ b/sfx2/source/control/makefile.mk >@@ -36,7 +36,7 @@ ENABLE_EXCEPTIONS=TRUE > .INCLUDE : settings.mk > .INCLUDE : $(PRJ)$/util$/makefile.pmk > >-# w.g. compilerbugs >+# due to compilerbugs > .IF "$(GUI)"=="WNT" > .IF "$(COM)"!="GCC" > CFLAGS+=-Od >diff --git a/sfx2/source/control/minfitem.cxx b/sfx2/source/control/minfitem.cxx >index 5075a0b..2d0c53a 100644 >--- a/sfx2/source/control/minfitem.cxx >+++ b/sfx2/source/control/minfitem.cxx >@@ -57,7 +57,7 @@ SfxMacroInfoItem::SfxMacroInfoItem( > > // ----------------------------------------------------------------------- > >-// copy ctor >+// copy constructor > > SfxMacroInfoItem::SfxMacroInfoItem(const SfxMacroInfoItem& rCopy): > SfxPoolItem(rCopy), >diff --git a/sfx2/source/control/msgpool.cxx b/sfx2/source/control/msgpool.cxx >index a18341e..4240e3c 100644 >--- a/sfx2/source/control/msgpool.cxx >+++ b/sfx2/source/control/msgpool.cxx >@@ -31,7 +31,7 @@ > #include <tools/stream.hxx> > #include <rsc/rscsfx.hxx> > >-// wg. pSlotPool >+// due to pSlotPool > #include "appdata.hxx" > #include <sfx2/msgpool.hxx> > #include <sfx2/minarray.hxx> >@@ -98,7 +98,6 @@ SfxSlotPool::~SfxSlotPool() > } > > //==================================================================== >- > // registers the availability of the Interface of functions > > void SfxSlotPool::RegisterInterface( SfxInterface& rInterface ) >@@ -110,8 +109,8 @@ void SfxSlotPool::RegisterInterface( SfxInterface& rInterface ) > _pInterfaces = new SfxInterfaceArr_Impl; > _pInterfaces->Append(&rInterface); > >- // bei einem (einzelnen) Null-Slot abbrechen (aus syntaktischen Gr"unden >- // enthalten interfaces immer mindestens einen Slot) >+ // Stop at a (single) Null-slot (for syntactic reasons the interfaces >+ // always contain at least one slot) > if ( rInterface.Count() == 1 && !rInterface[0]->nSlotId ) > return; > >@@ -122,7 +121,7 @@ void SfxSlotPool::RegisterInterface( SfxInterface& rInterface ) > > if ( _pParentPool ) > { >- // Die Groups im parent Slotpool sind auch hier bekannt >+ // The Groups in parent Slotpool are also known here > SfxSlotGroupArr_Impl& rGroups = *_pParentPool->_pGroups; > for ( USHORT n=0; n<rGroups.Count(); n++ ) > _pGroups->Append( rGroups[n] ); >@@ -162,7 +161,6 @@ TypeId SfxSlotPool::GetSlotType( USHORT nId ) const > } > > //==================================================================== >- > // unregisters the availability of the Interface of functions > > void SfxSlotPool::ReleaseInterface( SfxInterface& rInterface ) >@@ -182,7 +180,7 @@ const SfxSlot* SfxSlotPool::GetSlot( USHORT nId ) > DBG_MEMTEST(); > DBG_ASSERT( _pInterfaces != 0, "no Interfaces registered" ); > >- // Zun"achst die eigenen Interfaces absuchen >+ // First, search their own interfaces > for ( USHORT nInterf = 0; nInterf < _pInterfaces->Count(); ++nInterf ) > { > const SfxSlot *pDef = _pInterfaces->GetObject(nInterf)->GetSlot(nId); >@@ -190,7 +188,7 @@ const SfxSlot* SfxSlotPool::GetSlot( USHORT nId ) > return pDef; > } > >- // Dann beim eventuell vorhandenen parent versuchen >+ // Then try any of the possible existing parent > return _pParentPool ? _pParentPool->GetSlot( nId ) : 0; > } > >@@ -209,15 +207,14 @@ String SfxSlotPool::SeekGroup( USHORT nNo ) > _nCurGroup = nNo; > if ( _pParentPool ) > { >- // Meistens stimmt die Reihenfolge der Ids "uberein >+ // In most cases, the order of the IDs agree > USHORT nParentCount = _pParentPool->_pGroups->Count(); > if ( nNo < nParentCount && (*_pGroups)[nNo] == (*_pParentPool->_pGroups)[nNo] ) > _pParentPool->_nCurGroup = nNo; > else > { >- // Ansonsten mu\s gesucht werden >- // Wenn die Gruppe im parent pool nicht gefunden wird, wird >- // _nCurGroup au\serhalb des g"ultigen Bereiches gesetzt >+ // Otherwise search. If the group is not found in the parent >+ // pool, _nCurGroup is set outside the valid range > USHORT i; > for ( i=1; i<nParentCount; i++ ) > if ( (*_pGroups)[nNo] == (*_pParentPool->_pGroups)[i] ) >@@ -230,7 +227,7 @@ String SfxSlotPool::SeekGroup( USHORT nNo ) > aResId.SetRT(RSC_STRING); > if ( !aResId.GetResMgr()->IsAvailable(aResId) ) > { >- DBG_ERROR( "GroupId-Name nicht im SFX definiert!" ); >+ DBG_ERROR( "GroupId-Name not defined in SFX!" ); > return String(); > } > >@@ -258,18 +255,18 @@ const SfxSlot* SfxSlotPool::SeekSlot( USHORT nStartInterface ) > DBG_MEMTEST(); > DBG_ASSERT( _pInterfaces != 0, "no Interfaces registered" ); > >- // Die Numerierung der interfaces startet beim parent pool >+ // The numbering starts at the interfaces of the parent pool > USHORT nFirstInterface = _pParentPool ? _pParentPool->_pInterfaces->Count() : 0; > >- // sind wir am Ende des Parent-Pools angekommen? >+ // have reached the end of the Parent-Pools? > if ( nStartInterface < nFirstInterface && > _pParentPool->_nCurGroup >= _pParentPool->_pGroups->Count() ) > nStartInterface = nFirstInterface; > >- // liegt das Interface noch im Parent-Pool? >+ // Is the Interface still in the Parent-Pool? > if ( nStartInterface < nFirstInterface ) > { >- DBG_ASSERT( _pParentPool, "Kein parent pool!" ); >+ DBG_ASSERT( _pParentPool, "No parent pool!" ); > _nCurInterface = nStartInterface; > return _pParentPool->SeekSlot( nStartInterface ); > } >@@ -295,7 +292,6 @@ const SfxSlot* SfxSlotPool::SeekSlot( USHORT nStartInterface ) > } > > //-------------------------------------------------------------------- >- > // skips to the next func in the current group > > const SfxSlot* SfxSlotPool::NextSlot() >@@ -303,7 +299,7 @@ const SfxSlot* SfxSlotPool::NextSlot() > DBG_MEMTEST(); > DBG_ASSERT( _pInterfaces != 0, "no Interfaces registered" ); > >- // Die Numerierung der interfaces startet beim parent pool >+ // The numbering starts at the interfaces of the parent pool > USHORT nFirstInterface = _pParentPool ? _pParentPool->_pInterfaces->Count() : 0; > > if ( _nCurInterface < nFirstInterface && _nCurGroup >= _pParentPool->_pGroups->Count() ) >@@ -311,13 +307,13 @@ const SfxSlot* SfxSlotPool::NextSlot() > > if ( _nCurInterface < nFirstInterface ) > { >- DBG_ASSERT( _pParentPool, "Kein parent pool!" ); >+ DBG_ASSERT( _pParentPool, "No parent pool!" ); > const SfxSlot *pSlot = _pParentPool->NextSlot(); > _nCurInterface = _pParentPool->_nCurInterface; > if ( pSlot ) > return pSlot; > if ( _nCurInterface == nFirstInterface ) >- // parent pool ist fertig >+ // parent pool is ready > return SeekSlot( nFirstInterface ); > } > >@@ -340,9 +336,7 @@ const SfxSlot* SfxSlotPool::NextSlot() > > > //-------------------------------------------------------------------- >- >-// SlotName erfragen, gfs. mit HilfeText >- >+// Query SlotName with help text > //-------------------------------------------------------------------- > > SfxInterface* SfxSlotPool::FirstInterface() >diff --git a/sfx2/source/control/objface.cxx b/sfx2/source/control/objface.cxx >index 9aa0ebe..d53d446 100644 >--- a/sfx2/source/control/objface.cxx >+++ b/sfx2/source/control/objface.cxx >@@ -130,7 +130,7 @@ static SfxObjectUI_Impl* CreateObjectBarUI_Impl( USHORT nPos, const ResId& rResI > //==================================================================== > > //==================================================================== >-// ctor, registeres a new unit >+// constuctor, registeres a new unit > > SfxInterface::SfxInterface( const char *pClassName, > const ResId& rNameResId, >@@ -182,9 +182,9 @@ void SfxInterface::SetSlotMap( SfxSlot& rSlotMap, USHORT nSlotCount ) > pIter->GetSlotId() != (pIter+1)->GetSlotId(), > "doppelte SID" ); > >- // jeder Master verweist auf seinen ersten Slave (ENUM), alle >- // Slaves auf ihren Master. >- // Slaves verweisen im Ring auf die anderen mit gleichem Master >+ // every master refers to his first slave (ENUM), >+ // all slaves refer to their master. >+ // Slaves refer in a circle to the other slaves with the same master > if ( pIter->GetKind() == SFX_KIND_ENUM ) > { > pIter->pLinkedSlot = GetSlot( pIter->nMasterSlotId ); >@@ -209,7 +209,8 @@ void SfxInterface::SetSlotMap( SfxSlot& rSlotMap, USHORT nSlotCount ) > } > else if ( 0 == pIter->GetNextSlot() ) > { >- // Slots verweisen im Ring auf den n"achten mit derselben Statusmethode >+ // Slots refering in circle to the next with the same >+ // Status method. > SfxSlot *pLastSlot = pIter; > for ( USHORT n = nIter; n < Count(); ++n ) > { >@@ -232,7 +233,7 @@ void SfxInterface::SetSlotMap( SfxSlot& rSlotMap, USHORT nSlotCount ) > { > > if ( pNext->GetSlotId() <= pIter->GetSlotId() ) >- DBG_ERROR ("Falsche Reihenfolge!"); >+ DBG_ERROR ("Wrong order!"); > > if ( pIter->GetKind() == SFX_KIND_ENUM ) > { >@@ -243,7 +244,7 @@ void SfxInterface::SetSlotMap( SfxSlot& rSlotMap, USHORT nSlotCount ) > { > if ( pSlave->pLinkedSlot != pMasterSlot ) > { >- ByteString aStr("Falsche Master/Slave-Verkettung : "); >+ ByteString aStr("Wrong Master/Slave- link: "); > aStr += ByteString::CreateFromInt32(pMasterSlot->GetSlotId()); > aStr += " , "; > aStr += ByteString::CreateFromInt32(pSlave->GetSlotId()); >@@ -252,7 +253,7 @@ void SfxInterface::SetSlotMap( SfxSlot& rSlotMap, USHORT nSlotCount ) > > if ( pSlave->nMasterSlotId != pMasterSlot->GetSlotId() ) > { >- ByteString aStr("Falsche Master/Slave-Ids : "); >+ ByteString aStr("Wrong Master/Slave-Ids: "); > aStr += ByteString::CreateFromInt32(pMasterSlot->GetSlotId()); > aStr += " , "; > aStr += ByteString::CreateFromInt32(pSlave->GetSlotId()); >@@ -269,7 +270,7 @@ void SfxInterface::SetSlotMap( SfxSlot& rSlotMap, USHORT nSlotCount ) > { > if ( pIter->pLinkedSlot->GetKind() != SFX_KIND_ENUM ) > { >- ByteString aStr("Slave ist kein enum : "); >+ ByteString aStr("Slave is no enum: "); > aStr += ByteString::CreateFromInt32(pIter->GetSlotId()); > aStr += " , "; > aStr += ByteString::CreateFromInt32(pIter->pLinkedSlot->GetSlotId()); >@@ -283,7 +284,7 @@ void SfxInterface::SetSlotMap( SfxSlot& rSlotMap, USHORT nSlotCount ) > pCurSlot = pCurSlot->pNextSlot; > if ( pCurSlot->GetStateFnc() != pIter->GetStateFnc() ) > { >- ByteString aStr("Verkettete Slots mit verschiedenen StateMethods : "); >+ ByteString aStr("Linked Slots with different State Methods : "); > aStr += ByteString::CreateFromInt32(pCurSlot->GetSlotId()); > aStr += " , "; > aStr += ByteString::CreateFromInt32(pIter->GetSlotId()); >@@ -299,11 +300,8 @@ void SfxInterface::SetSlotMap( SfxSlot& rSlotMap, USHORT nSlotCount ) > #endif > } > >- > //-------------------------------------------------------------------- > >- >- > SfxInterface::~SfxInterface() > { > SfxModule *pMod = pImpData->pModule; >@@ -323,7 +321,6 @@ SfxInterface::~SfxInterface() > > // searches for the specified func > >- > const SfxSlot* SfxInterface::GetSlot( USHORT nFuncId ) const > { > DBG_MEMTEST(); >@@ -359,7 +356,6 @@ const SfxSlot* SfxInterface::GetSlot( const String& rCommand ) const > > //-------------------------------------------------------------------- > >- > const SfxSlot* SfxInterface::GetRealSlot( const SfxSlot *pSlot ) const > { > DBG_MEMTEST(); >@@ -370,7 +366,7 @@ const SfxSlot* SfxInterface::GetRealSlot( const SfxSlot *pSlot ) const > { > if(pGenoType) > return pGenoType->GetRealSlot(pSlot); >- DBG_ERROR("fremder Slot"); >+ DBG_ERROR("unknown Slot"); > return 0; > } > >@@ -379,7 +375,6 @@ const SfxSlot* SfxInterface::GetRealSlot( const SfxSlot *pSlot ) const > > //-------------------------------------------------------------------- > >- > const SfxSlot* SfxInterface::GetRealSlot( USHORT nSlotId ) const > { > DBG_MEMTEST(); >@@ -391,7 +386,7 @@ const SfxSlot* SfxInterface::GetRealSlot( USHORT nSlotId ) const > { > if(pGenoType) > return pGenoType->GetRealSlot(nSlotId); >- DBG_ERROR("fremder Slot"); >+ DBG_ERROR("unkonown Slot"); > return 0; > } > >@@ -400,7 +395,6 @@ const SfxSlot* SfxInterface::GetRealSlot( USHORT nSlotId ) const > > //-------------------------------------------------------------------- > >- > void SfxInterface::RegisterPopupMenu( const ResId& rResId ) > { > DBG_CHKTHIS(SfxInterface, 0); >@@ -453,10 +447,10 @@ const ResId& SfxInterface::GetObjectBarResId( USHORT nNo ) const > BOOL bGenoType = (pGenoType != 0 && !pGenoType->HasName()); > if ( bGenoType ) > { >- // Gibt es Toolbars in der Superklasse ? >+ // Are there toolbars in the super class? > USHORT nBaseCount = pGenoType->GetObjectBarCount(); > if ( nNo < nBaseCount ) >- // Die der Superklasse kommen zuerst >+ // The Super class comes first > return pGenoType->GetObjectBarResId( nNo ); > else > nNo = nNo - nBaseCount; >@@ -464,7 +458,7 @@ const ResId& SfxInterface::GetObjectBarResId( USHORT nNo ) const > > #ifdef DBG_UTIL > USHORT nObjBarCount = pImpData->pObjectBars->Count(); >- DBG_ASSERT( nNo<nObjBarCount,"Objectbar ist unbekannt!" ); >+ DBG_ASSERT( nNo<nObjBarCount,"Objectbar is unknown!" ); > #endif > return (*pImpData->pObjectBars)[nNo]->aResId; > } >@@ -477,10 +471,10 @@ USHORT SfxInterface::GetObjectBarPos( USHORT nNo ) const > BOOL bGenoType = (pGenoType != 0 && !pGenoType->HasName()); > if ( bGenoType ) > { >- // Gibt es Toolbars in der Superklasse ? >+ // Are there toolbars in the super class? > USHORT nBaseCount = pGenoType->GetObjectBarCount(); > if ( nNo < nBaseCount ) >- // Die der Superklasse kommen zuerst >+ // The Super class comes first > return pGenoType->GetObjectBarPos( nNo ); > else > nNo = nNo - nBaseCount; >@@ -488,7 +482,7 @@ USHORT SfxInterface::GetObjectBarPos( USHORT nNo ) const > > #ifdef DBG_UTIL > USHORT nObjBarCount = pImpData->pObjectBars->Count(); >- DBG_ASSERT( nNo<nObjBarCount,"Objectbar ist unbekannt!" ); >+ DBG_ASSERT( nNo<nObjBarCount,"Objectbar is unknown!" ); > #endif > return (*pImpData->pObjectBars)[nNo]->nPos; > } >@@ -527,10 +521,10 @@ sal_uInt32 SfxInterface::GetChildWindowId (USHORT nNo) const > { > if ( pGenoType ) > { >- // Gibt es ChildWindows in der Superklasse ? >+ // Are there ChildWindows in der Superklasse? > USHORT nBaseCount = pGenoType->GetChildWindowCount(); > if ( nNo < nBaseCount ) >- // Die der Superklasse kommen zuerst >+ // The Super class comes first > return pGenoType->GetChildWindowId( nNo ); > else > nNo = nNo - nBaseCount; >@@ -538,7 +532,7 @@ sal_uInt32 SfxInterface::GetChildWindowId (USHORT nNo) const > > #ifdef DBG_UTIL > USHORT nCWCount = pImpData->pChildWindows->Count(); >- DBG_ASSERT( nNo<nCWCount,"ChildWindow ist unbekannt!" ); >+ DBG_ASSERT( nNo<nCWCount,"ChildWindow is unknown!" ); > #endif > sal_uInt32 nRet = (*pImpData->pChildWindows)[nNo]->aResId.GetId(); > if ( (*pImpData->pChildWindows)[nNo]->bContext ) >@@ -550,10 +544,10 @@ sal_uInt32 SfxInterface::GetChildWindowFeature (USHORT nNo) const > { > if ( pGenoType ) > { >- // Gibt es ChildWindows in der Superklasse ? >+ // Are there ChildWindows in der Superklasse? > USHORT nBaseCount = pGenoType->GetChildWindowCount(); > if ( nNo < nBaseCount ) >- // Die der Superklasse kommen zuerst >+ // The Super class comes first > return pGenoType->GetChildWindowFeature( nNo ); > else > nNo = nNo - nBaseCount; >@@ -561,7 +555,7 @@ sal_uInt32 SfxInterface::GetChildWindowFeature (USHORT nNo) const > > #ifdef DBG_UTIL > USHORT nCWCount = pImpData->pChildWindows->Count(); >- DBG_ASSERT( nNo<nCWCount,"ChildWindow ist unbekannt!" ); >+ DBG_ASSERT( nNo<nCWCount,"ChildWindow is unknown!" ); > #endif > return (*pImpData->pChildWindows)[nNo]->nFeature; > } >@@ -599,10 +593,10 @@ const String* SfxInterface::GetObjectBarName ( USHORT nNo ) const > BOOL bGenoType = (pGenoType != 0 && !pGenoType->HasName()); > if ( bGenoType ) > { >- // Gibt es Toolbars in der Superklasse ? >+ // Are there toolbars in the super class? > USHORT nBaseCount = pGenoType->GetObjectBarCount(); > if ( nNo < nBaseCount ) >- // Die der Superklasse kommen zuerst >+ // The Super class comes first > return pGenoType->GetObjectBarName( nNo ); > else > nNo = nNo - nBaseCount; >@@ -610,7 +604,7 @@ const String* SfxInterface::GetObjectBarName ( USHORT nNo ) const > > #ifdef DBG_UTIL > USHORT nObjBarCount = pImpData->pObjectBars->Count(); >- DBG_ASSERT( nNo<nObjBarCount,"Objectbar ist unbekannt!" ); >+ DBG_ASSERT( nNo<nObjBarCount,"Objectbar is unknown!" ); > #endif > return (*pImpData->pObjectBars)[nNo]->pName; > } >@@ -620,10 +614,10 @@ sal_uInt32 SfxInterface::GetObjectBarFeature ( USHORT nNo ) const > BOOL bGenoType = (pGenoType != 0 && !pGenoType->HasName()); > if ( bGenoType ) > { >- // Gibt es Toolbars in der Superklasse ? >+ // Are there toolbars in the super class? > USHORT nBaseCount = pGenoType->GetObjectBarCount(); > if ( nNo < nBaseCount ) >- // Die der Superklasse kommen zuerst >+ // The Super class comes first > return pGenoType->GetObjectBarFeature( nNo ); > else > nNo = nNo - nBaseCount; >@@ -631,7 +625,7 @@ sal_uInt32 SfxInterface::GetObjectBarFeature ( USHORT nNo ) const > > #ifdef DBG_UTIL > USHORT nObjBarCount = pImpData->pObjectBars->Count(); >- DBG_ASSERT( nNo<nObjBarCount,"Objectbar ist unbekannt!" ); >+ DBG_ASSERT( nNo<nObjBarCount,"Objectbar is unknown!" ); > #endif > return (*pImpData->pObjectBars)[nNo]->nFeature; > } >@@ -641,10 +635,10 @@ BOOL SfxInterface::IsObjectBarVisible(USHORT nNo) const > BOOL bGenoType = (pGenoType != 0 && !pGenoType->HasName()); > if ( bGenoType ) > { >- // Gibt es Toolbars in der Superklasse ? >+ // Are there toolbars in the super class? > USHORT nBaseCount = pGenoType->GetObjectBarCount(); > if ( nNo < nBaseCount ) >- // Die der Superklasse kommen zuerst >+ // The Super class comes first > return pGenoType->IsObjectBarVisible( nNo ); > else > nNo = nNo - nBaseCount; >@@ -652,7 +646,7 @@ BOOL SfxInterface::IsObjectBarVisible(USHORT nNo) const > > #ifdef DBG_UTIL > USHORT nObjBarCount = pImpData->pObjectBars->Count(); >- DBG_ASSERT( nNo<nObjBarCount,"Objectbar ist unbekannt!" ); >+ DBG_ASSERT( nNo<nObjBarCount,"Objectbar is unknown!" ); > #endif > return (*pImpData->pObjectBars)[nNo]->bVisible; > } >@@ -662,17 +656,17 @@ const SfxInterface* SfxInterface::GetRealInterfaceForSlot( const SfxSlot *pRealS > DBG_ASSERT( pImpData->bRegistered, "Interface not registered!" ); > const SfxInterface* pInterface = this; > >- // Der Slot k"onnte auch aus dem Interface einer Shell-Basisklasse stammen >+ // The slot could also originate from the interface of a shell base class. > do > { > const SfxSlot *pLastSlot = (*pInterface)[pInterface->Count()-1]; > const SfxSlot *pFirstSlot = (*pInterface)[0]; > >- // Ist pInterface der Owner von pRealSlot ? >+ // Is pInterface the Owner of pRealSlot ? > if ( pFirstSlot <= pRealSlot && pRealSlot <= pLastSlot ) > break; > >- // Sonst Interface der Superklasse probieren >+ // Otherwise try the Interface of Super class > pInterface = pInterface->pGenoType; > } > while ( pInterface ); >@@ -680,6 +674,4 @@ const SfxInterface* SfxInterface::GetRealInterfaceForSlot( const SfxSlot *pRealS > return pInterface; > } > >- >- > /* vim:set shiftwidth=4 softtabstop=4 expandtab: */ >diff --git a/sfx2/source/control/request.cxx b/sfx2/source/control/request.cxx >index 328b2aa..019a17d 100644 >--- a/sfx2/source/control/request.cxx >+++ b/sfx2/source/control/request.cxx >@@ -60,23 +60,23 @@ using namespace ::com::sun::star; > > struct SfxRequest_Impl: public SfxListener > >-/* [Beschreibung] >+/* [Description] > >- Implementations-Struktur der Klasse <SfxRequest>. >+ Implementation structur of the <SfxRequest> class. > */ > > { >- SfxRequest* pAnti; // Owner wegen sterbendem Pool >- String aTarget; // ggf. von App gesetztes Zielobjekt >- SfxItemPool* pPool; // ItemSet mit diesem Pool bauen >- SfxPoolItem* pRetVal; // R"uckgabewert geh"ort sich selbst >- SfxShell* pShell; // ausgef"uhrt an dieser Shell >- const SfxSlot* pSlot; // ausgef"uhrter Slot >- USHORT nModifier; // welche Modifier waren gedrueckt? >- BOOL bDone; // "uberhaupt ausgef"uhrt >- BOOL bIgnored; // vom User abgebrochen >- BOOL bCancelled; // nicht mehr zustellen >- BOOL bUseTarget; // aTarget wurde von Applikation gesetzt >+ SfxRequest* pAnti; // Owner because of dying pool >+ String aTarget; // if possible from target object set by App >+ SfxItemPool* pPool; // ItemSet build with this pool >+ SfxPoolItem* pRetVal; // Return value belongs to itself >+ SfxShell* pShell; // run from this shell >+ const SfxSlot* pSlot; // executed Slot >+ USHORT nModifier; // which Modifier was pressed? >+ BOOL bDone; // at all executed >+ BOOL bIgnored; // Cancelled by the User >+ BOOL bCancelled; // no longer notify >+ BOOL bUseTarget; // aTarget was set by Application > USHORT nCallMode; // Synch/Asynch/API/Record > BOOL bAllowRecording; > SfxAllItemSet* pInternalArgs; >@@ -133,11 +133,11 @@ SfxRequest::~SfxRequest() > { > DBG_MEMTEST(); > >- // nicht mit Done() marktierte Requests mit 'rem' rausschreiben >+ // Leave out Done() marked requests with 'rem' > if ( pImp->xRecorder.is() && !pImp->bDone && !pImp->bIgnored ) > pImp->Record( uno::Sequence < beans::PropertyValue >() ); > >- // Objekt abr"aumen >+ // Clear object > delete pArgs; > if ( pImp->pRetVal ) > DeleteItemOnIdle(pImp->pRetVal); >@@ -186,13 +186,13 @@ SfxRequest::SfxRequest > > ) > >-/* [Beschreibung] >+/* [Description] > >- Mit diesem Konstruktor k"onnen Events, die nicht "uber den SfxDispatcher >- gelaufen sind (z.B aus KeyInput() oder Mouse-Events) nachtr"aglich >- recorded werden. Dazu wird eine SfxRequest-Instanz mit diesem Konstruktor >- erzeugt und dann genauso verfahren, wie mit einem SfxRequest, der in >- eine <Slot-Execute-Methode> als Parameter gegeben wird. >+ With this constructor events can subsequently be recorded that are not run >+ across SfxDispatcher (eg from KeyInput() or mouse events). For this, a >+ SfxRequest instance is created by this constructor and then proceed >+ exactly as with a SfxRequest that in a <Slot-Execute-Method> is given as a >+ parameter. > */ > > : nSlot(nSlotId), >@@ -231,9 +231,9 @@ SfxRequest::SfxRequest > > SfxRequest::SfxRequest > ( >- USHORT nSlotId, // auszuf"uhrende <Slot-Id> >+ USHORT nSlotId, // executed <Slot-Id> > SfxCallMode nMode, // Synch/API/... >- SfxItemPool& rPool // ggf. f"ur das SfxItemSet f"ur Parameter >+ SfxItemPool& rPool // necessary for the SfxItemSet for parameters > ) > > // creates a SfxRequest without arguments >@@ -256,10 +256,10 @@ SfxRequest::SfxRequest > > SfxRequest::SfxRequest > ( >- const SfxSlot* pSlot, // auszuf"uhrende <Slot-Id> >+ const SfxSlot* pSlot, // executed <Slot-Id> > const com::sun::star::uno::Sequence < com::sun::star::beans::PropertyValue >& rArgs, > SfxCallMode nMode, // Synch/API/... >- SfxItemPool& rPool // ggf. f"ur das SfxItemSet f"ur Parameter >+ SfxItemPool& rPool // necessary for the SfxItemSet for parameters > ) > : nSlot(pSlot->GetSlotId()), > pArgs(new SfxAllItemSet(rPool)), >@@ -344,16 +344,15 @@ const SfxItemSet* SfxRequest::GetInternalArgs_Impl() const > > void SfxRequest_Impl::Record > ( >- const uno::Sequence < beans::PropertyValue >& rArgs // aktuelle Parameter >+ const uno::Sequence < beans::PropertyValue >& rArgs // current Parameter > ) > >-/* [Beschreibung] >+/* [Description] > >- Interne Hilfsmethode zum erzeugen einer <SfxMacroStatement>-Instanz, >- welche den bereits ausgef"uhrten SfxRequest wiederholbar beschreibt. >- >- Die erzeugte Instanz, auf die ein Pointer zur"uckgeliefert wird >- geht in das Eigentum des Aufrufers "uber. >+ Internal helper method to create a <SfxMacroStatement> Instance, which >+ repeatable describes the just executed SfxRequest. The ownership of thr >+ created instance, to which a pointer is returned, is handed over to the >+ caller. > */ > > { >@@ -408,19 +407,17 @@ void SfxRequest_Impl::Record > > void SfxRequest::Record_Impl > ( >- SfxShell& rSh, // die <SfxShell>, die den Request ausgef"uhrt hat >- const SfxSlot& rSlot, // der <SfxSlot>, der den Request ausgef"uhrt hat >- com::sun::star::uno::Reference< com::sun::star::frame::XDispatchRecorder > xRecorder, // der Recorder, mit dem aufgezeichnet wird >+ SfxShell& rSh, // the <SfxShell>, which has excecuted the Request >+ const SfxSlot& rSlot, // the <SfxSlot>, which has executed the Request >+ com::sun::star::uno::Reference< com::sun::star::frame::XDispatchRecorder > xRecorder, > SfxViewFrame* pViewFrame > ) > >-/* [Beschreibung] >- >- Diese interne Methode markiert den SfxRequest als in dem angegebenen >- SfxMakro aufzuzeichnen. >+/* [Description] > >- Pointer auf die Parameter werden in Done() wieder verwendet, m"usseb >- dann also noch leben. >+ This internal method marks the specified SfxMakro SfxRequest as recorded in >+ SfxMakro. Pointer to the parameters in Done() is used again, thus has to >+ still be alive. > */ > > { >@@ -466,9 +463,9 @@ void SfxRequest::RemoveItem( USHORT nID ) > > const SfxPoolItem* SfxRequest::GetArg > ( >- USHORT nSlotId, // Slot-Id oder Which-Id des Parameters >- bool bDeep, // FALSE: nicht in Parent-ItemSets suchen >- TypeId aType // != 0: RTTI Pruefung mit Assertion >+ USHORT nSlotId, // Slot-Id or Which-Id of the parameters >+ bool bDeep, // FALSE: do not seach in the Parent-ItemSets >+ TypeId aType // != 0: RTTI check with Assertion > ) const > { > return GetItem( pArgs, nSlotId, bDeep, aType ); >@@ -479,22 +476,19 @@ const SfxPoolItem* SfxRequest::GetArg > const SfxPoolItem* SfxRequest::GetItem > ( > const SfxItemSet* pArgs, >- USHORT nSlotId, // Slot-Id oder Which-Id des Parameters >- bool bDeep, // false: nicht in Parent-ItemSets suchen >- TypeId aType // != 0: RTTI Pruefung mit Assertion >+ USHORT nSlotId, // Slot-Id or Which-Id of the parameters >+ bool bDeep, // FALSE: do not seach in the Parent-ItemSets >+ TypeId aType // != 0: RTTI check with Assertion > ) > >-/* [Beschreibung] >- >- Mit dieser Methode wird der Zugriff auf einzelne Parameter im >- SfxRequest wesentlich vereinfacht. Insbesondere wird die Typpr"ufung >- (per Assertion) durchgef"uhrt, wodurch die Applikations-Sourcen >- wesentlich "ubersichtlicher werden. In der PRODUCT-Version wird >- eine 0 zur"uckgegeben, wenn das gefundene Item nicht von der >- angegebenen Klasse ist. >+/* [Description] > >+ With this method the access to induvidual parameters in the SfxRequest is >+ simplified. In particular the type-examination (by Assertion) is performed, >+ whereby the application source code will be much clearer. In the product- >+ version is a 0 returned, if the found item is not of the specified class. > >- [Beispiel] >+ [Example] > > void MyShell::Execute( SfxRequest &rReq ) > { >@@ -503,12 +497,12 @@ const SfxPoolItem* SfxRequest::GetItem > case SID_MY: > { > ... >- // ein Beispiel ohne Verwendung des Makros >+ // An Example on not using the macros > const SfxInt32Item *pPosItem = (const SfxUInt32Item*) > rReq.GetArg( SID_POS, FALSE, TYPE(SfxInt32Item) ); > USHORT nPos = pPosItem ? pPosItem->GetValue() : 0; > >- // ein Beispiel mit Verwendung des Makros >+ // An Example on using the macros > SFX_REQUEST_ARG(rReq, pSizeItem, SfxInt32Item, SID_SIZE, FALSE); > USHORT nSize = pSizeItem ? pPosItem->GetValue() : 0; > >@@ -523,24 +517,24 @@ const SfxPoolItem* SfxRequest::GetItem > { > if ( pArgs ) > { >- // ggf. in Which-Id umrechnen >+ // Which may be converted to ID > USHORT nWhich = pArgs->GetPool()->GetWhich(nSlotId); > >- // ist das Item gesetzt oder bei bDeep==TRUE verf"ugbar? >+ // Is the item set or available at bDeep == TRUE? > const SfxPoolItem *pItem = 0; > if ( ( bDeep ? SFX_ITEM_AVAILABLE : SFX_ITEM_SET ) > <= pArgs->GetItemState( nWhich, bDeep, &pItem ) ) > { >- // stimmt der Typ "uberein? >+ // Compare type > if ( !pItem || pItem->IsA(aType) ) > return pItem; > >- // Item da aber falsch => Programmierfehler >+ // Item of wrong type => Programming error > DBG_ERROR( "invalid argument type" ); > } > } > >- // keine Parameter, nicht gefunden oder falschen Typ gefunden >+ // No Parameter, not found or wrong type > return 0; > } > >@@ -548,7 +542,7 @@ const SfxPoolItem* SfxRequest::GetItem > > void SfxRequest::SetReturnValue(const SfxPoolItem &rItem) > { >- DBG_ASSERT(!pImp->pRetVal, "Returnwert mehrfach setzen?"); >+ DBG_ASSERT(!pImp->pRetVal, "Set Return value multiple times?"); > if(pImp->pRetVal) > delete pImp->pRetVal; > pImp->pRetVal = rItem.Clone(); >@@ -565,47 +559,42 @@ const SfxPoolItem* SfxRequest::GetReturnValue() const > > void SfxRequest::Done > ( >- const SfxItemSet& rSet, /* von der Applikation mitgeteilte Parameter, >- die z.B. in einem Dialog vom Benuter >- erfragt wurden, ggf. 0 falls keine >- Parameter gesetzt wurden */ >+ const SfxItemSet& rSet, /* parameters passed on by the application, >+ that for example were asked for by the user >+ in a dialogue, 0 if no parameters have been >+ set */ > > bool bKeep /* TRUE (default) >- 'rSet' wird gepeichert und ist "uber >- GetArgs() abfragbar >+ 'rSet' is saved and GetArgs() queriable. > > FALSE >- 'rSet' wird nicht kopiert (schneller) */ >+ 'rSet' is not copied (faster) */ > ) > >-/* [Beschreibung] >+/* [Description] > >- Diese Methode mu\s in der <Execute-Methode> des <SfxSlot>s gerufen >- werden, der den SfxRequest ausgef"uhrt hat, wenn die Ausf"uhrung >- tats"achlich stattgefunden hat. Wird 'Done()' nicht gerufen, gilt >- der SfxRequest als abgebrochen. >+ This method must be called in the <Execute-Method> of the <SfxSlot>s, which >+ has performed the SfxRequest when the execution actually took place. If >+ 'Done()' is not called, then the SfxRequest is considered canceled. > >- Etwaige Returnwerte werden nur durchgereicht, wenn 'Done()' gerufen >- wurde. Ebenso werden beim Aufzeichnen von Makros nur echte >- Statements erzeugt, wenn 'Done()' gerufen wurde; f"ur SfxRequests, >- die nicht derart gekennzeichnet wurden, wird anstelle dessen eine >- auf die abgebrochene Funktion hinweisende Bemerkung ('rem') eingf"ugt. >+ Any return values are passed only when 'Done()' was called. Similar, when >+ recording a macro only true statements are generated if 'Done()' was >+ called; for SfxRequests that were not identified as such will instead >+ be commented out by inserting ('rem'). > >+ [Note] > >- [Anmerkung] >- >- 'Done()' wird z.B. nicht gerufen, wenn ein durch die Funktion gestarteter >- Dialog vom Benutzer abgebrochen wurde oder das Ausf"uhren aufgrund >- eines falschen Kontextes (ohne Verwendung separater <SfxShell>s) >- nicht durchgef"uhrt werden konnte. 'Done()' mu\s sehr wohl gerufen >- werden, wenn das Ausf"uhren der Funktion zu einem regul"aren Fehler >- f"uhrte (z.B. Datei konnte nicht ge"offnet werden). >+ 'Done ()' is not called, for example when a dialoge started by the function >+ was canceled by the user or if the execution could not be performed due to >+ a wrong context (without use of separate <SfxShell>s). 'Done ()' will be >+ launched, when executing the function led to a regular error >+ (for example, file could not be opened). > */ > > { > Done_Impl( &rSet ); > >- // ggf. Items merken, damit StarDraw sie abfragen kann >+ // Keep items if possible, so they can be queried by StarDraw. > if ( bKeep ) > { > if ( !pArgs ) >@@ -657,10 +646,10 @@ BOOL SfxRequest::IsCancelled() const > > void SfxRequest::Cancel() > >-/* [Beschreibung] >+/* [Description] > >- Markiert diesen Request als nicht mehr auszufuehren. Wird z.B. gerufen, >- wenn das Ziel (genauer dessen Pool) stirbt. >+ Marks this request as no longer executable. For example, if called when >+ the target (more precisely, its pool) dies. > */ > > { >@@ -674,22 +663,20 @@ void SfxRequest::Cancel() > > void SfxRequest::Ignore() > >-/* [Beschreibung] >- >- Wird diese Methode anstelle von <SfxRequest::Done()> gerufen, dann >- wird dieser Request nicht recorded. >+/* [Description] > >+ If this method is called instead of <SfxRequest::Done()>, then this >+ request is not recorded. > >- [Bespiel] >+ [Example] > >- Das Selektieren von Tools im StarDraw soll nicht aufgezeichnet werden, >- dieselben Slots sollen aber zum erzeugen der von den Tools zu >- erzeugenden Objekte verwendet werde. Also kann nicht NoRecord >- angegeben werden, dennoch soll u.U. nicht aufgezeichnet werden. >+ The selecting of tools in StarDraw should not be recorded, but the same >+ slots are to be used from the generation of the tools to the generated >+ objects. Thus can NoRecords not be specified, i.e. should not be recorded. > */ > > { >- // als tats"achlich ausgef"uhrt markieren >+ // Mark as actually executed > pImp->bIgnored = TRUE; > } > >@@ -697,38 +684,39 @@ void SfxRequest::Ignore() > > void SfxRequest::Done_Impl > ( >- const SfxItemSet* pSet /* von der Applikation mitgeteilte Parameter, >- die z.B. in einem Dialog vom Benuter >- erfragt wurden, ggf. 0 falls keine >- Parameter gesetzt wurden */ >+ const SfxItemSet* pSet /* parameters passed on by the application, >+ that for example were asked for by the user >+ in a dialogue, 0 if no parameters have been >+ set */ >+ > ) > >-/* [Beschreibung] >+/* [Description] > >- Interne Methode zum als 'done' markieren des SfxRequest und zum Auswerten >- der Parameter in 'pSet' falls aufgezeichnet wird. >+ Internal method to mark SfxRequest with 'done' and to evaluate the >+ parameters in 'pSet' in case it is recorded. > */ > > { >- // als tats"achlich ausgef"uhrt markieren >+ // Mark as actually executed > pImp->bDone = TRUE; > >- // nicht Recorden >+ // not Recording > if ( !pImp->xRecorder.is() ) > return; > >- // wurde ein anderer Slot ausgef"uhrt als angefordert (Delegation) >+ // was running a different slot than requested (Delegation) > if ( nSlot != pImp->pSlot->GetSlotId() ) > { >- // Slot neu suchen >+ // Search Slot again > pImp->pSlot = pImp->pShell->GetInterface()->GetSlot(nSlot); > DBG_ASSERT( pImp->pSlot, "delegated SlotId not found" ); >- if ( !pImp->pSlot ) // Hosentr"ger und G"urtel >+ if ( !pImp->pSlot ) // playing it safe > return; > } > >- // record-f"ahig? >- // neues Recorden verwendet UnoName! >+ // recordable? >+ // new Recording uses UnoName! > if ( !pImp->pSlot->pUnoName ) > { > ByteString aStr( "Recording not exported slot: "); >@@ -736,16 +724,16 @@ void SfxRequest::Done_Impl > DBG_ERROR( aStr.GetBuffer() ); > } > >- if ( !pImp->pSlot->pUnoName ) // Hosentr"ger und G"urtel >+ if ( !pImp->pSlot->pUnoName ) // playing it safe > return; > >- // "ofters ben"otigte Werte >+ // often required values > SfxItemPool &rPool = pImp->pShell->GetPool(); > > // Property-Slot? > if ( !pImp->pSlot->IsMode(SFX_SLOT_METHOD) ) > { >- // des Property als SfxPoolItem besorgen >+ // get the property as SfxPoolItem > const SfxPoolItem *pItem; > USHORT nWhich = rPool.GetWhich(pImp->pSlot->GetSlotId()); > SfxItemState eState = pSet ? pSet->GetItemState( nWhich, FALSE, &pItem ) : SFX_ITEM_UNKNOWN; >@@ -763,7 +751,7 @@ void SfxRequest::Done_Impl > pImp->Record( aSeq ); > } > >- // alles in ein einziges Statement aufzeichnen? >+ // record everything in a single statement? > else if ( pImp->pSlot->IsMode(SFX_SLOT_RECORDPERSET) ) > { > uno::Sequence < beans::PropertyValue > aSeq; >@@ -772,27 +760,27 @@ void SfxRequest::Done_Impl > pImp->Record( aSeq ); > } > >- // jedes Item als einzelnes Statement recorden >+ // record each item as a single statement > else if ( pImp->pSlot->IsMode(SFX_SLOT_RECORDPERITEM) ) > { > if ( pSet ) > { >- // "uber die Items iterieren >+ // iterate over Items > SfxItemIter aIter(*pSet); > for ( const SfxPoolItem* pItem = aIter.FirstItem(); pItem; pItem = aIter.NextItem() ) > { >- // die Slot-Id f"ur das einzelne Item ermitteln >+ // to determine the slot ID for the individual item > USHORT nSlotId = rPool.GetSlotId( pItem->Which() ); > if ( nSlotId == nSlot ) > { >- // mit Hosentr"ager und G"urtel reparieren des falschen Flags >+ // play it safe; repair the wrong flags > DBG_ERROR( "recursion RecordPerItem - use RecordPerSet!" ); > SfxSlot *pSlot = (SfxSlot*) pImp->pSlot; > pSlot->nFlags &= ~((ULONG)SFX_SLOT_RECORDPERITEM); > pSlot->nFlags &= SFX_SLOT_RECORDPERSET; > } > >- // einen Sub-Request recorden >+ // Record a Sub-Request > SfxRequest aReq( pImp->pViewFrame, nSlotId ); > if ( aReq.pImp->pSlot ) > aReq.AppendItem( *pItem ); >@@ -801,7 +789,7 @@ void SfxRequest::Done_Impl > } > else > { >- HACK(hierueber nochmal nachdenken) >+ //HACK(think about this again) > pImp->Record( uno::Sequence < beans::PropertyValue >() ); > } > } >@@ -811,18 +799,16 @@ void SfxRequest::Done_Impl > > BOOL SfxRequest::IsDone() const > >-/* [Beschreibung] >- >- Mit dieser Methode kann abgefragt werden, ob der SfxRequest tats"achlich >- ausgef"uhrt wurde oder nicht. Wurde ein SfxRequest nicht ausgef"uhrt, >- liegt dies z.B. daran, da\s der Benutzer abgebrochen hat oder >- der Kontext f"ur diesen Request falsch war, dieses aber nicht "uber >- eine separate <SfxShell> realisiert wurde. >+/* [Description] > >- SfxRequest-Instanzen, die hier FALSE liefern, werden nicht recorded. >+ With this method it can be queried whether the SfxRequest was actually >+ executed or not. If a SfxRequest was not executed, then this is for example >+ because it was canceled by the user or the context for this request was >+ wrong, this was not implemented on a separate <SfxShell>. > >+ SfxRequest instances that return FALSE will not be recorded. > >- [Querverweise] >+ [Cross-reference] > > <SfxRequest::Done(const SfxItemSet&)> > <SfxRequest::Done()> >@@ -836,10 +822,10 @@ BOOL SfxRequest::IsDone() const > > SfxMacro* SfxRequest::GetRecordingMacro() > >-/* [Beschreibung] >+/* [Description] > >- Mit dieser Methode kann abgefragt werden, ob und in welchem <SfxMacro> >- die SfxRequests gerade aufgezeichnet werden. >+ With this method it can be queried as to whether and to what <SfxMacro> >+ the SfxRequests is being recorded. > */ > > { >@@ -850,12 +836,13 @@ SfxMacro* SfxRequest::GetRecordingMacro() > > com::sun::star::uno::Reference< com::sun::star::frame::XDispatchRecorder > SfxRequest::GetMacroRecorder( SfxViewFrame* pView ) > >-/* [Beschreibung] >+/* [Description] > >- Hier wird versucht einen Recorder fuer dispatch() Aufrufe vom Frame zu bekommen. >- Dieser ist dort per Property an einem Supplier verfuegbar - aber nur dann, wenn >- recording angeschaltet wurde. >- (Siehe auch SfxViewFrame::MiscExec_Impl() und SID_RECORDING) >+ This recorder is an attempt for dispatch () to get calls from the Frame. >+ This is then available through a property by a supplier but only when >+ recording was turned on. >+ >+ (See also SfxViewFrame::MiscExec_Impl() and SID_RECORDING) > */ > > { >@@ -887,10 +874,10 @@ BOOL SfxRequest::HasMacroRecorder( SfxViewFrame* pView ) > > BOOL SfxRequest::IsAPI() const > >-/* [Beschreibung] >+/* [Description] > >- Liefert TRUE, wenn dieser SfxRequest von einer API (z.B. BASIC) >- erzeugt wurde, sonst FALSE. >+ Returns TRUE if this SfxRequest was generated by an API (for example BASIC), >+ otherwise FALSE. > */ > > { >@@ -902,13 +889,13 @@ BOOL SfxRequest::IsAPI() const > > bool SfxRequest::IsRecording() const > >-/* [Beschreibung] >+/* [Description] > >- Liefert TRUE, wenn dieser SfxRequest recorded werden soll, d.h. >- 1. zu Zeit ein Makro aufgezeichnet wird >- 2. dieser Request "uberhaupt aufgezeichnet wird >- 3. der Request nicht von reiner API (z.B. BASIC) ausgeht, >- sonst FALSE. >+ Returns TRUE if this SfxRequest is to be recorded ie >+ 1. Currently a macro is beeing recorded >+ 2. This request is even recorded >+ 3. the request did not originate from a pure API (for example BASIC), >+ otherwise FALSE. > */ > > { >@@ -931,19 +918,18 @@ USHORT SfxRequest::GetModifier() const > > void SfxRequest::SetTarget( const String &rTarget ) > >-/* [Beschreibung] >- >- Mit dieser Methode kann das zu recordende Zielobjekt umgesetzt werden. >+/* [Description] > >+ With this method the recording of the target object can be implemented. > >- [Beispiel] >+ [Example] > >- Die BASIC-Methode 'Open' wird zwar von der Shell 'Application' ausgef"uhrt, >- aber am Objekt 'Documents' (global) recorded: >+ The BASIC-Methode 'Open' is although executed by the Shell 'Application' >+ but recorded on the Objekt 'Documents' (global): > > rReq.SetTarget( "Documents" ); > >- Dies f"uhrt dann zu: >+ This then leads to: > > Documents.Open( ... ) > */
You cannot view the attachment while viewing its details because your browser does not support IFRAMEs.
View the attachment on a separate page
.
View Attachment As Raw
Actions:
View
Attachments on
bug 33424
: 42396 |
42397