fdo#39468: Translate German comments in dbaccess/source/ui/inc

Change-Id: Ibf6993a5b935d4ca4e0c792e8676b293ab224d68

dbaccess/source/ui/inc/DExport.hxx

@@ -60,8 +60,8 @@ namespace dbaui
         typedef ::std::vector< ::std::pair<sal_Int32,sal_Int32> >   TPositions;
 
     protected:
-        TPositions                      m_vColumns;     // Welche Spalten "ubernommen werden sollen
-        ::std::vector<sal_Int32>        m_vColumnTypes; // FeldTypen f"ur schnelleren Zugriff
+        TPositions                      m_vColumns;     // columns to be used
+        ::std::vector<sal_Int32>        m_vColumnTypes; // ColumnTypes for faster access
         ::std::vector<sal_Int32>        m_vColumnSize;
         ::std::vector<sal_Int16>        m_vNumberFormat;
         ::com::sun::star::lang::Locale  m_aLocale;
@@ -84,20 +84,20 @@ namespace dbaui
         //for save the selected tablename
         ::rtl::OUString     m_sDefaultTableName;
 
-        String              m_sTextToken;       // Zellen Inhalt
+        String              m_sTextToken;       /// cell content
         String              m_sNumToken;        /// SDNUM value
         String              m_sValToken;        /// SDVAL value
         TOTypeInfoSP        m_pTypeInfo;    // contains the default type
         const TColumnVector* m_pColumnList;
         const OTypeInfoMap* m_pInfoMap;
-        sal_Int32           m_nColumnPos;       // aktuelle Spaltenposition
-        sal_Int32           m_nRows;        // Anzahl der Zeilen die durchsucht werden sollen
+        sal_Int32           m_nColumnPos;       // current column position
+        sal_Int32           m_nRows;        // number of rows to be searched
         sal_Int32           m_nRowCount;    // current count of rows
-        rtl_TextEncoding    m_nDefToken;        // Sprache
-        sal_Bool            m_bError;           // Fehler und Abbruchstatus
-        sal_Bool            m_bInTbl;           // Ist gesetzt, wenn der Parser sich in der RTF Tabelle befindet
-        sal_Bool            m_bHead;        // ist true, wenn die Kopfzeile noch nicht gelesen wurde
-        sal_Bool            m_bDontAskAgain;// Falls beim Einf"ugen ein Fehler auftritt, soll die Fehlermeldung nicht
+        rtl_TextEncoding    m_nDefToken;        // language
+        sal_Bool            m_bError;           // error and termination code
+        sal_Bool            m_bInTbl;           // true, if parser is in RTF table
+        sal_Bool            m_bHead;        // true, if the header hasn't been read yet
+        sal_Bool            m_bDontAskAgain;// if there is an error when pasting, don't show it again
         sal_Bool            m_bIsAutoIncrement; // if PKey is set by user
         sal_Bool            m_bFoundTable;      // set to true when a table was found
         sal_Bool            m_bCheckOnly;
@@ -139,7 +139,7 @@ namespace dbaui
             SvStream& _rInputStream
         );
 
-        // wird f"ur auto. Typ-Erkennung gebraucht
+        // required for automatic type recognition
         ODatabaseExport(
             sal_Int32 nRows,
             const TPositions& _rColumnPositions,

dbaccess/source/ui/inc/FieldDescControl.hxx

@@ -26,7 +26,7 @@
 #include "TypeInfo.hxx"
 
 //------------------------------------------------------------------
-// die Spalten einer Feld-Beschreibung einer Tabelle
+// field description columns of a table
 #define FIELD_NAME                      1
 #define FIELD_TYPE                      2
 #define HELP_TEXT                       3
@@ -122,7 +122,7 @@ namespace dbaui
         DECL_LINK( FormatClickHdl, Button * );
         DECL_LINK( ChangeHdl, ListBox * );
 
-            // von ActivatePropertyField benutzt
+            // used by ActivatePropertyField
         DECL_LINK( OnControlFocusLost, Control* );
         DECL_LINK( OnControlFocusGot, Control* );
 
@@ -155,7 +155,6 @@ namespace dbaui
         virtual void        DeactivateAggregate( EControlType eType );
         virtual sal_Bool        IsReadOnly() { return sal_False; };
 
-        // Sind von den abgeleiteten Klassen zu impl.
         virtual ::com::sun::star::uno::Reference< ::com::sun::star::util::XNumberFormatter > GetFormatter() const = 0;
 
         virtual ::com::sun::star::lang::Locale  GetLocale() const = 0;
@@ -189,7 +188,7 @@ namespace dbaui
         String              GetControlText( sal_uInt16 nControlId );
         void                SetReadOnly( sal_Bool bReadOnly );
 
-        // Resize aufegrufen
+        // when resize is called
         void                CheckScrollBars();
         sal_Bool            isCutAllowed();
         sal_Bool            isCopyAllowed();

dbaccess/source/ui/inc/HtmlReader.hxx

@@ -36,12 +36,12 @@ namespace dbaui
         String              m_sCurrent;
         sal_Int32           m_nTableCount;
         sal_Int16           m_nWidth;
-        sal_Int16           m_nColumnWidth;     // max. Spaltenbreite
-        sal_Bool            m_bMetaOptions;     // true when we scaned the meta information
+        sal_Int16           m_nColumnWidth;     // maximum column width
+        sal_Bool            m_bMetaOptions;     // true when we scanned the meta information
         sal_Bool            m_bSDNum;
 
     protected:
-        virtual void        NextToken( int nToken ); // Basisklasse
+        virtual void        NextToken( int nToken ); // base class
         virtual sal_Bool    CreateTable(int nToken);
         virtual TypeSelectionPageFactory
                              getTypeSelectionPageFactory();
@@ -59,7 +59,7 @@ namespace dbaui
                     const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >& _rM,
                     const TColumnVector* rList = 0,
                     const OTypeInfoMap* _pInfoMap = 0);
-        // wird f"ur auto. Typ-Erkennung gebraucht
+        // required for automatic type recognition
         OHTMLReader(SvStream& rIn,
                     sal_Int32 nRows,
                     const TPositions &_rColumnPositions,
@@ -69,9 +69,9 @@ namespace dbaui
                     const OTypeInfoMap* _pInfoMap,
                     sal_Bool _bAutoIncrementEnabled);
 
-        virtual     SvParserState CallParser();// Basisklasse
+        virtual     SvParserState CallParser();// base class
         virtual     void          release();
-        // birgt nur korrekte Daten, wenn der 1. CTOR benutzt wurde
+        // recovers only valid data if 1. CTOR has been used
     };
 
     SV_DECL_IMPL_REF( OHTMLReader );

dbaccess/source/ui/inc/JoinExchange.hxx

@@ -30,7 +30,7 @@ namespace dbaui
 {
     //==================================================================
     // OJoinExchObj :
-    // Zusaetzliche Daten fuer das Erzeugen von Joins in der JoinShell
+    // Additional data to create Joins in the JoinShell
     //==================================================================
 
     typedef ::cppu::ImplHelper1< ::com::sun::star::lang::XUnoTunnel > OJoinExchObj_Base;

dbaccess/source/ui/inc/JoinTableView.hxx

@@ -131,7 +131,7 @@ namespace dbaui
         virtual void AddTabWin(const ::rtl::OUString& _rComposedName, const ::rtl::OUString& rWinName, sal_Bool bNewTable = sal_False);
         virtual void RemoveTabWin( OTableWindow* pTabWin );
 
-        // alle TabWins verstecken (NICHT loeschen, sie werden in eine Undo-Action gepackt)
+        // hide all TabWins (does NOT delete them; they are put in an UNDO action)
         virtual void    HideTabWins();
 
         virtual void AddConnection(const OJoinExchangeData& jxdSource, const OJoinExchangeData& jxdDest) = 0;
@@ -200,13 +200,16 @@ namespace dbaui
         // set the focus to that tab win which most recently had it (or to the first available one)
         void GrabTabWinFocus();
 
-        // ReSync ist dazu gedacht, aus dem Dokument alle WinData und ConnData zu holen und entsprechend Wins und Conns anzulegen
+        // ReSync is meant to get all WinData and ConnData from the document
+        // and create the corresponding Wins and Conns
         virtual void ReSync() { }
-        // ClearAll implementiert ein hartes Loeschen, es werden alle Conns und alle Wins aus ihren jeweiligen Listen geloescht
-        // sowie die entsprechenden Datas aus dem Dokument ausgetragen
+
+        // ClearAll implements hart deletion, all Conns and Wins are deleted
+        // from their respective lists and the corresponding Datas removed
+        // from the document
         virtual void ClearAll();
 
-        // wird vom AddTabDlg benutzt, um festzustellen, ob noch Tabellen hinzugefuegt werden duerfen
+        // used by AddTabDlg to see if more tables can be added
         virtual sal_Bool IsAddAllowed();
         virtual long PreNotify(NotifyEvent& rNEvt);
 
@@ -221,18 +224,18 @@ namespace dbaui
         */
         virtual void lookForUiActivities();
 
-        // wird nach Verschieben/Groessenaenderung der TabWins aufgerufen (die Standardimplementation reicht die neuen Daten einfach
-        // an die Daten des Wins weiter)
+        // called after moving/resizing TabWins
+        // (the standard implementation just passes the new data to the Wins)
         virtual void TabWinMoved(OTableWindow* ptWhich, const Point& ptOldPosition);
-            // die Position ist "virtuell" : der Container hat sozusagen eine virtuelle Flaeche, von der immer nur ein bestimmter Bereich
-            // - der mittels der Scrollbar veraendert werden kann - zu sehen ist. Insbesondere hat ptOldPosition immer positive Koordinaten,
-            // auch wenn er einen Punkt oberhalb des aktuell sichtbaren Bereichs bezeichnet, dessen physische Ordinate eigentlich
-            // negativ ist.
+            // the position is 'virtual': the container has a virtual area
+            // of which only a part - changeable by scroll bar - is visible
+            // therefore: ptOldPosition is always positive, even if it represents
+            // a point with a negative physical ordinate above the visible area
         virtual void TabWinSized(OTableWindow* ptWhich, const Point& ptOldPosition, const Size& szOldSize);
 
         void modified();
 
-        /** returns if teh given window is visible.
+        /** check if the given window is visible.
             @param  _rPoint
                 The Point to check
             @param  _rSize
@@ -266,7 +269,8 @@ namespace dbaui
         virtual void Resize();
 
         virtual void dragFinished( );
-        // hier ist die Position (die sich waehrend des Sizings aendern kann) physisch, da waehrend des Sizens nicht gescrollt wird
+        // here the physical position (that can be changed while resizing)
+        // is used, as no scrolling can take place while resizing
         virtual void Command(const CommandEvent& rEvt);
 
         virtual OTableWindowData* CreateImpl(const ::rtl::OUString& _rComposedName

dbaccess/source/ui/inc/QEnumTypes.hxx

@@ -35,7 +35,8 @@ namespace dbaui
         FKT_AGGREGATE   =0x00000002,
         FKT_CONDITION   =0x00000004,
         FKT_NUMERIC     =0x00000008
-        // wenn dieser Fkt.Typ gesetzt handelt es sich um EXISTS oder UNIQUE, der FieldName enthlt das gesamte Statement
+        // if this function type is set, it is either EXISTS oder UNIQUE,
+        // the FieldName contains the complete statement
     };
 
     enum EConnectionSide

dbaccess/source/ui/inc/QueryTableView.hxx

@@ -60,57 +60,60 @@ namespace dbaui
         OQueryTableView(Window* pParent,OQueryDesignView* pView);
         virtual ~OQueryTableView();
 
-        // Basisklasse ueberschrieben : Fenster kreieren und loeschen
-        // (eigentlich nicht wirklich LOESCHEN, es geht in die Verantwortung einer UNDO-Action ueber)
+        // base class overwritten: create and delete windows
+        // (not really delete, as it becomes an UNDO action)
         virtual void AddTabWin( const ::rtl::OUString& _rTableName, const ::rtl::OUString& _rAliasName, sal_Bool bNewTable = sal_False );
         virtual void RemoveTabWin(OTableWindow* pTabWin);
 
-        // und ein AddTabWin, das einen Alias vorgibt
+        // AddTabWin, setting an alias
         void    AddTabWin(const ::rtl::OUString& strDatabase, const ::rtl::OUString& strTableName, const ::rtl::OUString& strAlias, sal_Bool bNewTable = sal_False);
         // TabWin suchen
         OQueryTableWindow*  FindTable(const String& rAliasName);
         sal_Bool            FindTableFromField(const String& rFieldName, OTableFieldDescRef& rInfo, sal_uInt16& rCnt);
 
-        // Basisklasse ueberschrieben : Connections kreieren und loeschen
+        // base class overwritten: create and delete Connections
         virtual void AddConnection(const OJoinExchangeData& jxdSource, const OJoinExchangeData& jxdDest);
 
         virtual bool RemoveConnection( OTableConnection* _pConn ,sal_Bool _bDelete);
 
-        // Transfer von Connections von/zu einer UndoAction
+        // transfer of connections from and to UndoAction
         void GetConnection(OQueryTableConnection* pConn);
-            // Einfuegen einer Connection in meine Struktur
+            // Inserting a connection into the structure
         void DropConnection(OQueryTableConnection* pConn);
-            // Entfernen einer Connection aus meiner Struktur
+            // Removing a connection from the structure
 
-            // das resultiert effektiv in einem voelligen Leeren des Abfrageentwurfs, da alle Fenster versteckt werden, und dabei
-            // natuerlich alle Connections an diesen Fenstern und alle Abfrage-Spalten, die auf diesen Tabellen basierten.
+            // results in complete reset of request form, as
+            // all windows are hidden, as are all Connections to these windows
+            // and all request columns based on those tables
 
-        // TabWin anzeigen oder verstecken (NICHT kreieren oder loeschen)
+        // show and hide TabWin (NOT create or delete)
         sal_Bool    ShowTabWin(OQueryTableWindow* pTabWin, OQueryTabWinUndoAct* pUndoAction,sal_Bool _bAppend);
         void    HideTabWin(OQueryTableWindow* pTabWin, OQueryTabWinUndoAct* pUndoAction);
 
-        // Sichbarkeit eines TabWins sicherstellen (+ Invalidieren der Connections)
+        // ensure visibility of TabWins (+ and invalidate connections)
         virtual void EnsureVisible(const OTableWindow* _pWin);
 
-        // wieviel Tabellen mit einem bestimmten Namen habe ich schon ?
+        // how many tables with a certain alias do I already have?
         sal_Int32   CountTableAlias(const String& rName, sal_Int32& rMax);
 
         // ein Feld einfuegen (wird einfach an das Elter weitergereicht
         void InsertField(const OTableFieldDescRef& rInfo);
 
-        // alles (TabWins, Connections) neu aufbauen (PRECONDITION : vorher wurde ClearAll gerufen)
+        // rebuild everything (TabWins, Connections)
+        // (PRECONDITION: ClearAll was called previously)
         virtual void ReSync();
-        // alles (TabWins, Connections) loeschen, und zwar hart, es erfolgen also keinerlei Notifications
+
+        // delete everything hard (TabWins, Connections), without any notifications
         virtual void ClearAll();
 
-        // wird vom AddTabDlg benutzt, um festzustellen, ob noch Tabellen hinzugefuegt werden duerfen
+        // used by AddTabDlg to see if tables can still be added
         //virtual sal_Bool IsAddAllowed();
 
-        // eine neu Connection bekanntgeben und einfuegen lassen, wenn nicht schon existent
+        // announce new Connection and insert it, if not existant yet
         void NotifyTabConnection(const OQueryTableConnection& rNewConn, sal_Bool _bCreateUndoAction = sal_True);
 
         Link    SetTabWinsChangeHandler(const Link& lnk) { Link lnkRet = m_lnkTabWinsChangeHandler; m_lnkTabWinsChangeHandler = lnk; return lnkRet; }
-            // der Handler bekommt einen Zeiger auf eine TabWinsChangeNotification-Struktur
+            // the Handler receives a pointer to a TabWinsChangeNotification struct
 
         sal_Bool ExistsAVisitedConn(const OQueryTableWindow* pFrom) const;
 

dbaccess/source/ui/inc/RelationTableView.hxx

@@ -62,8 +62,8 @@ namespace dbaui
         virtual void ReSync();
 
         void AddNewRelation();
-            // reisst den Dialog fuer eine voellig neue Relation hoch
-        // wird vom AddTabDlg benutzt, um festzustellen, ob noch Tabellen hinzugefuegt werden duerfen
+            // Creates a dialogue for a completely new relation.
+        // used by AddTabDlg to check if tables can be added
         virtual sal_Bool IsAddAllowed();
 
         virtual void lookForUiActivities();

dbaccess/source/ui/inc/RtfReader.hxx

@@ -35,7 +35,7 @@ namespace dbaui
         //  void insertValueIntoColumn();
     protected:
         virtual sal_Bool        CreateTable(int nToken);
-        virtual void            NextToken( int nToken ); // Basisklasse
+        virtual void            NextToken( int nToken ); // base class
         virtual TypeSelectionPageFactory
                                 getTypeSelectionPageFactory();
 
@@ -47,7 +47,7 @@ namespace dbaui
                     const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >& _rM,
                     const TColumnVector* rList = 0,
                     const OTypeInfoMap* _pInfoMap = 0);
-        // wird f"ur auto. Typ-Erkennung gebraucht
+        // required for automatic type recognition
         ORTFReader( SvStream& rIn,
                     sal_Int32 nRows,
                     const TPositions &_rColumnPositions,
@@ -57,10 +57,10 @@ namespace dbaui
                     const OTypeInfoMap* _pInfoMap,
                     sal_Bool _bAutoIncrementEnabled);
 
-        virtual SvParserState   CallParser();// Basisklasse
+        virtual SvParserState   CallParser();// base class
         virtual void            release();
-        // birgt nur korrekte Daten, wenn der 2. CTOR benutzt wurde
-        // ansonsten wird die SbaColumnList ohne "Anderung zur"uckgegeben
+        // Only recovers correct data if 2. CTOR has been used.
+        // Otherwise, the SbaColumnList will be returned without changes.
     };
 
     SV_DECL_IMPL_REF( ORTFReader );

dbaccess/source/ui/inc/TableConnection.hxx

@@ -57,10 +57,11 @@ namespace dbaui
     public:
         OTableConnection( OJoinTableView* pContainer, const TTableConnectionData::value_type& pTabConnData );
         OTableConnection( const OTableConnection& rConn );
-            // WICHTIG : normalerweise bekomme ich von aussen einen Zeiger auf OTableConnectionData mitgegeben, hier aber muss ich
-            // mir (ueber OTableConnectionData::NewInstance) selber eine INstanz anlegen, die ich aber - wie in allen anderen Faellen auch -
-            // NIE loesche. Der Aufrufer ist also bei Benutzung dieses Constructors dafuer verantwortlich, meine Daten abzufragen und
-            // sich irgendwo zu merken, um sie dann irgendwann zu loeschen.
+        // IMPORTANT: Normally a pointer to OTableConnectionData is given but
+        // here, however, one has to create an instance (with
+        // OTableConnectionDate::NewInstance) which is never deleted (same like
+        // in other cases). Thus, the caller is responsible to check and save
+        // the data for deleting it eventually.
         virtual ~OTableConnection();
 
         OTableConnection& operator=( const OTableConnection& rConn );

dbaccess/source/ui/inc/TableConnectionData.hxx

@@ -62,12 +62,13 @@ namespace dbaui
         OTableConnectionData( const OTableConnectionData& rConnData );
         virtual ~OTableConnectionData();
 
-        // sich aus einer Quelle initialisieren (das ist mir irgendwie angenehmer als ein virtueller Zuweisungsoperator)
+        // initialise from a source (more comfortable than a virtual assignment operator)
         virtual void CopyFrom(const OTableConnectionData& rSource);
 
-        // eine neue Instanz meines eigenen Typs liefern (braucht NICHT initialisiert sein)
+        // deliver a new instance of my own type (does NOT have to be initialised)
         virtual OTableConnectionData* NewInstance() const;
-            // (von OTableConnectionData abgeleitete Klasse muessen entsprechend eine Instanz ihrer Klasse liefern)
+            // classes derived from OTableConnectionData correspondingly
+            // have to deliver an instance of their own type
 
         sal_Bool SetConnLine( sal_uInt16 nIndex, const String& rSourceFieldName, const String& rDestFieldName );
         sal_Bool AppendConnLine( const ::rtl::OUString& rSourceFieldName, const ::rtl::OUString& rDestFieldName );
@@ -76,7 +77,8 @@ namespace dbaui
         /** normalizeLines moves the empty lines to the back
         */
         void normalizeLines();
-            // loescht die Liste der ConnLines, bei bUseDefaults == sal_True werden danach MAX_CONN_COUNT neue Dummy-Linien eingefuegt
+            // deletes list of ConnLines, if bUseDefaults == sal_True
+            // MAX_CONN_COUNT new dummy lines will be inserted
 
         OConnectionLineDataVec* GetConnLineDataList(){ return &m_vConnLineData; }
 

dbaccess/source/ui/inc/TableDesignControl.hxx

@@ -35,8 +35,8 @@ namespace dbaui
         friend class OTableDesignUndoAct;
 
     protected:
-        long    m_nDataPos;             // derzeit benoetigte Zeile
-        long    m_nCurrentPos;          // Aktuelle Position der ausgewaehlten Column
+        long    m_nDataPos;             // currently needed row
+        long    m_nCurrentPos;          // current position of selected column
     private:
         sal_uInt16  m_nCurUndoActId;
     protected:

dbaccess/source/ui/inc/TableDesignHelpBar.hxx

@@ -27,9 +27,8 @@
 class MultiLineEdit;
 namespace dbaui
 {
-    //==================================================================
-    // Ableitung von TabPage ist ein Trick von TH,
-    // um Aenderungen der Systemfarben zu bemerken
+    // Deriving from TabPage is a trick to notice changes
+    // of the system colors
     class OTableDesignHelpBar : public TabPage
                                 ,public IClipboardTest
     {

dbaccess/source/ui/inc/TableFieldDescription.hxx

@@ -46,7 +46,7 @@ namespace dbaui
         ::rtl::OUString             m_aAliasName;       // table range
         ::rtl::OUString             m_aFieldName;       // column
         ::rtl::OUString             m_aFieldAlias;  // column alias
-        ::rtl::OUString             m_aFunctionName;    // enth"alt den Funktionsnamen, nur wenn m_eFunctionType != FKT_NONE gesetzt
+        ::rtl::OUString             m_aFunctionName;    // contains the function name (only if m_eFunctionType != FKT_NONE)
 
         Window*                     m_pTabWindow;
 
@@ -60,7 +60,7 @@ namespace dbaui
         sal_Bool                    m_bGroupBy;
         sal_Bool                    m_bVisible;
 
-        // !!!! bitte bei Erweiterung um neue Felder auch IsEmpty mitpflegen !!!!
+        // when adding new fields, please take care of IsEmpty!
 
     public:
         OTableFieldDesc();