fdo#39468: Translated German comments in vcl/{inc,win}

Change-Id: I1b11872dd56d93b116a65ac2e3905f751cfafeeb
Signed-off-by: Philipp Riemer <ruderphilipp@gmail.com>
Reviewed-on: https://gerrit.libreoffice.org/2447
Reviewed-by: Michael Meeks <michael.meeks@suse.com>
Tested-by: Michael Meeks <michael.meeks@suse.com>

3 files changed, 57 insertions, 70 deletions

diff --git a/vcl/inc/vcl/graphicfilter.hxx b/vcl/inc/vcl/graphicfilter.hxx
index f9a7ae138073..3e2218c750c8 100644
--- a/vcl/inc/vcl/graphicfilter.hxx
+++ b/vcl/inc/vcl/graphicfilter.hxx
@@ -87,10 +87,7 @@ struct ConvertData;
 #define EMF_SHORTNAME           "EMF"
 #define SVG_SHORTNAME           "SVG"
 
-// ------------------------------------
-// - Info-Klasse fuer alle von uns
-//  unterstuetzten Grafik-Fileformate
-// ------------------------------------
+//  Info class for all supported file formats
 
 #define GFF_NOT ( (sal_uInt16)0x0000 )
 #define GFF_BMP ( (sal_uInt16)0x0001 )
@@ -169,50 +166,48 @@ class VCL_DLLPUBLIC GraphicDescriptor
 
 public:
 
-    // Ctor, um einen Filenamen zu setzen. Es muss ::Detect() gerufen werden,
-    // um das File zu identifizieren;
-    // wenn das File keinen eindeutigen Header besitzt ( Mtf's ) wird das
-    // Format anhand der Extension bestimmt
+    /** Ctor to set a filename
+
+        ::Detect() must be called to identify the file
+        If the file has no unique header (Mtf's), the format
+        is determined from the extension */
     GraphicDescriptor( const INetURLObject& rPath );
 
-    // Ctor, um einen Stream zu setzen. Es muss ::Detect() gerufen werden,
-    // um das File zu identifizieren;
-    // da einige Formate ( Mtf's ) keinen eindeutigen Header besitzen,
-    // ist es sinnvoll den Filenamen (inkl. Ext. ) mitanzugeben,
-    // da so das Format ueber die Extension ermittelt werden kann
+    /** Ctor using a stream
+
+        ::Detect() must be called to identify the file
+        As some formats (Mtf's) do not have a unique header, it makes sense
+        to supply the file name (incl. ext.), so that the format can be
+        derived from the extension */
     GraphicDescriptor( SvStream& rInStream, const String* pPath = NULL );
 
-    // Dtor
     virtual ~GraphicDescriptor();
 
-    // Startet die Detektion;
-    // bei bExtendedInfo == sal_True werden soweit wie moeglich
-    // Daten aus dem jeweiligen FileHeader ermittelt
-    // ( Groesse, Farbtiefe usw. )
+    /** starts the detection
+
+        if bExtendedInfo == sal_True the file header is used to derive
+        as many properties as possible (size, color, etc.) */
     virtual sal_Bool    Detect( sal_Bool bExtendedInfo = sal_False );
 
-    // liefert das Fileformat nach erfolgreicher  Detektion zurueck;
-    // wenn kein Format erkannt wurde, ist das Formart GFF_NOT
+    /** @return the file format, GFF_NOT if no format was recognized */
     sal_uInt16          GetFileFormat() const { return nFormat; }
 
-    // liefert die Pixel-Bildgroesse oder 0-Size zurueck
+    /** @return graphic size in pixels or 0 size */
     const Size&     GetSizePixel() const { return (Size&) aPixSize; }
 
-    // liefert die logische Bildgroesse in 1/100mm oder 0-Size zurueck
+    /** @return the logical graphic size in 1/100mm or 0 size */
     const Size&     GetSize_100TH_MM() const { return (Size&) aLogSize; }
 
-    // liefert die Bits/Pixel oder 0 zurueck
+    /** @return bits/pixel or 0 **/
     sal_uInt16          GetBitsPerPixel() const { return nBitsPerPixel; }
 
-    // liefert die Anzahl der Planes oder 0 zurueck
+    /** return number of planes or 0 */
     sal_uInt16          GetPlanes() const { return nPlanes; }
 
-    // zeigt an, ob das Bild evtl. komprimiert (wie auch immer) ist
+    /** @return true if the graphic is compressed */
     sal_Bool            IsCompressed() const { return bCompressed; }
 
-    // gibt die Filternummer des Filters zurueck,
-    // der im GraphicFilter zum Lesen dieses Formats
-    // benoetigt wird
+    /** @return filter number that is needed by the GraphFilter to read this format */
     static String GetImportFormatShortName( sal_uInt16 nFormat );
 };
 
diff --git a/vcl/inc/vcl/prgsbar.hxx b/vcl/inc/vcl/prgsbar.hxx
index fb686702c4ac..9f22df47c7a8 100644
--- a/vcl/inc/vcl/prgsbar.hxx
+++ b/vcl/inc/vcl/prgsbar.hxx
@@ -24,29 +24,26 @@
 #include <vcl/window.hxx>
 
 /*************************************************************************
-
-Beschreibung
-============
-
-class ProgressBar
-
-Diese Klasse dient zur Anzeige einer Progress-Anzeige.
-
---------------------------------------------------------------------------
-
-WinBits
-
-WB_BORDER           Border um das Fenster
-WB_3DLOOK           3D-Darstellung
-
---------------------------------------------------------------------------
-
-Methoden
-
-Mit SetValue() setzt man einen Prozent-Wert zwischen 0 und 100. Wenn Werte
-groesser 100 gesetzt werden, faengt das letzte Rechteck an zu blinken.
-
-*************************************************************************/
+ *
+ * class ProgressBar
+ *
+ * this class is used to display the ProgressBar
+ *
+ * -----------------------------------------------------------------------
+ *
+ * WinBits
+ *
+ * WB_BORDER           border around the window
+ * WB_3DLOOK           3D representation
+ *
+ * -----------------------------------------------------------------------
+ *
+ * Methodes
+ *
+ * Use SetValue() to set a percentage between 0 and 100. A value larger
+ * than 100 will cause the last rectangle to start flashing
+ *
+ ************************************************************************/
 
 // -----------
 // - WinBits -
diff --git a/vcl/win/source/window/salobj.cxx b/vcl/win/source/window/salobj.cxx
index e2c1b24840c2..f6287e7c93b7 100644
--- a/vcl/win/source/window/salobj.cxx
+++ b/vcl/win/source/window/salobj.cxx
@@ -41,7 +41,7 @@ static sal_Bool ImplIsSysWindowOrChild( HWND hWndParent, HWND hWndChild )
     HWND hTempWnd = ::GetParent( hWndChild );
     while ( hTempWnd )
     {
-        // Ab nicht Child-Fenstern hoeren wir auf zu suchen
+        // stop searching if not a child window
         if ( !(GetWindowStyle( hTempWnd ) & WS_CHILD) )
             return FALSE;
         if ( hTempWnd == hWndParent )
@@ -129,8 +129,7 @@ LRESULT CALLBACK SalSysMsgProc( int nCode, WPARAM wParam, LPARAM lParam )
             pObject = ImplFindSalObject( pData->hwnd );
             if ( pObject && !ImplFindSalObject( (HWND)pData->wParam ) )
             {
-                // LoseFocus nur rufen, wenn wirklich kein ChildFenster
-                // den Focus bekommt
+                // only call LoseFocus, if truly no child window gets the focus
                 if ( !pData->wParam || !ImplFindSalObject( (HWND)pData->wParam ) )
                 {
                     if ( ImplSalYieldMutexTryToAcquire() )
@@ -172,11 +171,9 @@ sal_Bool ImplSalPreDispatchMsg( MSG* pMsg )
     if ( (pMsg->message == WM_KEYDOWN) ||
          (pMsg->message == WM_KEYUP) )
     {
-        // KeyEvents wollen wir nach Moeglichkeit auch abarbeiten,
-        // wenn das Control diese nicht selber auswertet
-        // SysKeys werden als WM_SYSCOMMAND verarbeitet
-        // Char-Events verarbeiten wir nicht, da wir nur
-        // Accelerator relevante Keys verarbeiten wollen
+        // process KeyEvents even if the control does not process them itself
+        // SysKeys are processed as WM_SYSCOMMAND
+        // Char-Events are not processed, as they are not accelerator-relevant
         sal_Bool bWantedKeyCode = FALSE;
         // A-Z, 0-9 nur in Verbindung mit Control-Taste
         if ( ((pMsg->wParam >= 65) && (pMsg->wParam <= 90)) ||
@@ -200,7 +197,7 @@ sal_Bool ImplSalPreDispatchMsg( MSG* pMsg )
             ImplSalYieldMutexRelease();
         }
     }
-    // Hier WM_SYSCHAR abfangen, um mit Alt+Taste evtl. Menu zu aktivieren
+    // check WM_SYSCHAR, to activate menu with Alt key
     else if ( pMsg->message == WM_SYSCHAR )
     {
         pSalData->mnSalObjWantKeyEvt = 0;
@@ -362,9 +359,8 @@ LRESULT CALLBACK SalSysObjWndProc( HWND hWnd, UINT nMsg, WPARAM wParam, LPARAM l
             CREATESTRUCTA* pStruct = (CREATESTRUCTA*)lParam;
             pSysObj = (WinSalObject*)pStruct->lpCreateParams;
             SetSalObjWindowPtr( hWnd, pSysObj );
-            // HWND schon hier setzen, da schon auf den Instanzdaten
-            // gearbeitet werden kann, wenn Messages waehrend
-            // CreateWindow() gesendet werden
+            // set HWND already here,
+            // as instance data might be used during CreateWindow() events
             pSysObj->mhWnd = hWnd;
             rDef = FALSE;
             }
@@ -400,7 +396,7 @@ LRESULT CALLBACK SalSysObjChildWndProc( HWND hWnd, UINT nMsg, WPARAM wParam, LPA
 
     switch( nMsg )
     {
-        // Wegen PlugIn's loeschen wir erstmal den Hintergrund
+        // clear background for plugins
         case WM_ERASEBKGND:
             {
                 WinSalObject* pSysObj = GetSalObjWindowPtr( ::GetParent( hWnd ) );
@@ -480,7 +476,7 @@ SalObject* ImplSalCreateObject( WinSalInstance* pInst, WinSalFrame* pParent )
 {
     SalData* pSalData = GetSalData();
 
-    // Hook installieren, wenn es das erste SalObject ist
+    // install hook, if it is the first SalObject
     if ( !pSalData->mpFirstObject )
     {
         pSalData->mhSalObjMsgHook = SetWindowsHookExW( WH_CALLWNDPROC,
@@ -599,7 +595,7 @@ WinSalObject::~WinSalObject()
     {
         pSalData->mpFirstObject = mpNextObject;
 
-        // Wenn letztes SalObject, dann Hook wieder entfernen
+        // remove hook, if it is the last SalObject
         if ( !pSalData->mpFirstObject )
             UnhookWindowsHookEx( pSalData->mhSalObjMsgHook );
     }
@@ -622,9 +618,8 @@ WinSalObject::~WinSalObject()
     if ( mhWnd )
         DestroyWindow( mhWnd );
 
-    // Palette wieder zuruecksetzen, wenn kein externes Child-Fenster
-    // mehr vorhanden ist, da diese unsere Palette ueberschrieben haben
-    // koennen
+    // reset palette, if no external child window is left,
+    // as they might have overwritten our palette
     if ( hWndParent &&
          ::GetActiveWindow() == hWndParent &&
          !GetWindow( hWndParent, GW_CHILD ) )
@@ -712,7 +707,7 @@ void WinSalObject::EndSetClipRegion()
 {
     HRGN hRegion;
 
-    // Aus den Region-Daten muessen wir jetzt eine ClipRegion erzeugen
+    // create a ClipRegion from the Region data
     if ( mpClipRgnData->rdh.nCount == 1 )
     {
         RECT* pRect = &(mpClipRgnData->rdh.rcBound);