[Libreoffice] [PATCH] (Reworked) some translations of comments in sw/inc
Christoph Herzog
rhogez at googlemail.com
Wed Jan 19 09:51:46 PST 2011
On 01/19/2011 11:38 AM, Tor Lillqvist wrote:
> Thanks for the translations, but please don't use Doxygen format comments (starting with /** or /// ) for comments that can't meaningfully be used by Doxygen. (Those inside methods, I think; I am not really a Doxygen user.) Can you fix those back to use the // style, thanks!
>
> Some comments you change from // style to /* style, I think it's best to stick with // style also for multi-line comments.
>
> Also, I think comments like
>
> class SwField; // fuer Felder
>
> are pointless, just delete them, no need to translate and keep. (Sure, if *every* such empty "forward" class declaration had a comment indicating *why* it is needed in that particular case, then they would be OK, but when just a few of them have, it's mostly pointless IMO.) In this case the comment just says that "SwField" is for "fields", which should not really be hard to guess from the name.
>
> --tml
>
>
From d89330b8858d1c5bf87c4be83d5d8a9070b9b67f Mon Sep 17 00:00:00 2001
From: Christoph Herzog <rhogez at googlemail.com>
Date: Wed, 19 Jan 2011 18:38:15 +0100
Subject: [PATCH] Some translations of comments in /sw/in notably editsh.hxx
Oops sorry! I didn't know that /* style comments were deprecated. I
removed them from my patch and reverted everything to proper // style.
As I have only very rudimentary knowledge of how doxigen works I thought
it safer to remove all "doxigenification" I had inserted previously in
order to avoid possible problems.
---
sw/inc/drawdoc.hxx | 5 +-
sw/inc/edglbldc.hxx | 4 +-
sw/inc/edimp.hxx | 4 +-
sw/inc/editsh.hxx | 489
+++++++++++++++++++++++++--------------------------
4 files changed, 248 insertions(+), 254 deletions(-)
diff --git a/sw/inc/drawdoc.hxx b/sw/inc/drawdoc.hxx
index 1286884..ffdb4cc 100644
--- a/sw/inc/drawdoc.hxx
+++ b/sw/inc/drawdoc.hxx
@@ -47,10 +47,11 @@ public:
virtual SdrPage* AllocPage(bool bMasterPage);
- // fuers "load on demand" von Grafiken im DrawingLayer
+
+ // For "load on demand" of graphics in DrawingLayer.
virtual SvStream* GetDocumentStream( SdrDocumentStreamInfo& rInfo
) const;
- // fuers Speicher von Rechtecken als Control-Ersatz fuker Versionen
< 5.0
+ // For saving of rectangles as control-replacement for versions < 5.0.
virtual SdrLayerID GetControlExportLayerId( const SdrObject & ) const;
protected:
diff --git a/sw/inc/edglbldc.hxx b/sw/inc/edglbldc.hxx
index a163c34..0d281ac 100644
--- a/sw/inc/edglbldc.hxx
+++ b/sw/inc/edglbldc.hxx
@@ -54,7 +54,7 @@ public:
SwGlblDocContent( const SwTOXBaseSection* pTOX );
SwGlblDocContent( const SwSection* pSect );
- // Inhalte abfragen
+ // Query contents.
GlobalDocContentType GetType() const { return eType; }
const SwSection* GetSection() const
{ return GLBLDOC_SECTION == eType ?
PTR.pSect : 0; }
@@ -62,7 +62,7 @@ public:
{ return GLBLDOC_TOXBASE == eType ?
PTR.pTOX : 0; }
ULONG GetDocPos() const { return nDocPos; }
- // fuers Sortieren
+ // For sorting.
inline int operator==( const SwGlblDocContent& rCmp ) const
{ return GetDocPos() == rCmp.GetDocPos(); }
inline int operator<( const SwGlblDocContent& rCmp ) const
diff --git a/sw/inc/edimp.hxx b/sw/inc/edimp.hxx
index 99477d8..9756efc 100644
--- a/sw/inc/edimp.hxx
+++ b/sw/inc/edimp.hxx
@@ -35,9 +35,7 @@
class SwPaM;
class SwNodeIndex;
-/*
- * MACROS um ueber alle Bereiche zu iterieren
- */
+// Macros to iterate over all ranges.
#define PCURCRSR (_pStartCrsr)
#define FOREACHPAM_START(pCURSH) \
diff --git a/sw/inc/editsh.hxx b/sw/inc/editsh.hxx
index bfefbce..a6ab600 100644
--- a/sw/inc/editsh.hxx
+++ b/sw/inc/editsh.hxx
@@ -35,7 +35,7 @@
#include <vcl/font.hxx>
#include <editeng/swafopt.hxx>
#include "swdllapi.h"
-#include <crsrsh.hxx> // fuer Basisklasse
+#include <crsrsh.hxx> // For base class.
#include <itabenum.hxx>
#include <swdbdata.hxx>
#include <com/sun/star/linguistic2/XSpellAlternatives.hpp>
@@ -59,7 +59,7 @@ class SfxPoolItem;
class SfxItemSet;
class SvxAutoCorrect;
-class SwField; // fuer Felder
+class SwField;
class SwFieldType;
class SwDDEFieldType;
class SwNewDBMgr;
@@ -71,22 +71,22 @@ class SwAutoCompleteWord;
class SwFmtRefMark;
-class SwNumRule; // Numerierung
+class SwNumRule;
-class SwUndoIds; // fuer Undo
+class SwUndoIds;
class SwTxtFmtColl;
class SwGrfNode;
class SwFlyFrmFmt;
-class SwFrmFmt; // fuer GetTxtNodeFmts()
+class SwFrmFmt; // For GetTxtNodeFmts().
class SwCharFmt;
class SwExtTextInput;
-class SwRootFrm; // fuer CTOR
-class Graphic; // fuer GetGraphic
-class GraphicObject; // fuer GetGraphicObj
-class SwFmtINetFmt; // InsertURL
+class SwRootFrm; // For CTOR.
+class Graphic;
+class GraphicObject;
+class SwFmtINetFmt; // InsertURL.
class SwTable;
-class SwTextBlocks; // fuer GlossaryRW
+class SwTextBlocks; // For GlossaryRW.
class SwFmtFtn;
class SwSection;
class SwSectionData;
@@ -127,9 +127,8 @@ class LinkManager;
#define GETSELTXT_PARABRK_KEEP 1
#define GETSELTXT_PARABRK_TO_ONLYCR 2
-/****************************************************************
- * zum Abfragen der INet-Attribute fuer den Navigator
- ****************************************************************/
+
+// For querying the INet-attributes for Navigator.
struct SwGetINetAttr
{
String sText;
@@ -141,13 +140,12 @@ struct SwGetINetAttr
};
SV_DECL_PTRARR_DEL( SwGetINetAttrs, SwGetINetAttr*, 0, 5 )
-/****************************************************************
- * Typen der Inhaltsformen
- ****************************************************************/
+// Types of forms of content.
#define CNT_TXT 0x0001
#define CNT_GRF 0x0002
#define CNT_OLE 0x0010
-/* Teste einen USHORT auf eine bestimmte Inhaltsform */
+
+// Test USHORT for a defined form of content.
#define CNT_HasTxt(USH) ((USH)&CNT_TXT)
#define CNT_HasGrf(USH) ((USH)&CNT_GRF)
#define CNT_HasOLE(USH) ((USH)&CNT_OLE)
@@ -156,19 +154,17 @@ class SW_DLLPUBLIC SwEditShell: public SwCrsrShell
{
static SvxSwAutoFmtFlags* pAutoFmtFlags;
- // fuer die privaten Methoden DelRange und die vom AutoCorrect
+ // For the private methods DelRange and those of AutoCorrect.
friend class SwAutoFormat;
friend void _InitCore();
friend void _FinitCore();
- // fuer die PamCorrAbs/-Rel Methoden
+ // For the PamCorrAbs/-Rel methods.
friend class SwUndo;
SW_DLLPRIVATE SfxPoolItem& _GetChrFmt( SfxPoolItem& ) const;
- /*
- * liefert einen Pointer auf einen SwGrfNode; dieser wird von
- * GetGraphic() und GetGraphicSize() verwendet.
- */
+ // Returns pointer to a SwGrfNode
+ // that will be used by GetGraphic() and GetGraphicSize().
SW_DLLPRIVATE SwGrfNode *_GetGrfNode() const ;
SW_DLLPRIVATE void DeleteSel( SwPaM& rPam, BOOL* pUndo = 0 );
@@ -179,71 +175,69 @@ class SW_DLLPUBLIC SwEditShell: public SwCrsrShell
using SwModify::GetInfo;
public:
- // Editieren (immer auf allen selektierten Bereichen)
+ // Edit (all selected ranges).
void Insert( sal_Unicode, BOOL bOnlyCurrCrsr = FALSE );
void Insert2( const String &, const bool bForceExpandHints = false );
void Overwrite( const String & );
- // Ersetz einen selektierten Bereich in einem TextNode mit dem
- // String. Ist fuers Suchen&Ersetzen gedacht.
- // bRegExpRplc - ersetze Tabs (\\t) und setze den gefundenen String
- // ein ( nicht \& )
- // z.B.: Fnd: "zzz", Repl: "xx\t\\t..&..\&"
- // --> "xx\t<Tab>..zzz..&"
+ // Replace a selected range in a TextNode by given string.
+ // Meant for Search & Replace.
+ // bRegExpRplc - replace tabs (\\t) and insert found string (not \&).
+ // E.g.: Fnd: "zzz", Repl: "xx\t\\t..&..\&"
+ // --> "xx\t<Tab>..zzz..&"
BOOL Replace( const String& rNewStr, BOOL bRegExpRplc = FALSE );
- // loescht den Inhalt aller Bereiche;
- // werden ganze Nodes selektiert, werden die Nodes geloescht
+ // Delete content of all ranges.
+ // If whole nodes are selected, these nodes get deleted.
long Delete();
- // remove a complete paragraph
+ // Remove a complete paragraph.
BOOL DelFullPara();
- // change text to Upper/Lower/Hiragana/Katagana/...
+ // Change text to Upper/Lower/Hiragana/Katagana/...
void TransliterateText( sal_uInt32 nType );
- // count words in current selection
+ // Count words in current selection.
void CountWords( SwDocStat& rStat ) const;
- // loesche den nicht sichtbaren Content aus dem Document, wie z.B.:
- // versteckte Bereiche, versteckte Absaetze
+ // Delete non-visible content in the document.
+ // E.g. hidden ranges, hidden paragraphs.
BOOL RemoveInvisibleContent();
- // replace fields by text - mailmerge support
+ // Replace fields by text - mailmerge support.
BOOL ConvertFieldsToText();
- // set all numbering start points to a fixed value - mailmerge support
+
+ // Set all numbering start points to a fixed value - mailmerge support.
void SetNumberingRestart();
- // embedded alle lokalen Links (Bereiche/Grafiken)
+ // Embedds all local links (ranges/graphics).
USHORT GetLinkUpdMode(BOOL bDocSettings = FALSE) const;
void SetLinkUpdMode( USHORT nMode );
- // kopiere den Inhalt aller Bereiche an die akt. Cursor-Position
- // in die angegebene Shell
+ // Copy content of all ranges at current position of cursor to
given Shell.
long Copy( SwEditShell* pDestShell = 0 );
- // fuers Kopieren uebers ClipBoard:
- // wird Tabelle in Tabelle kopiert, verschiebe aus dieser dann
- // alle Cursor. Copy und Paste muss aufgrund der FlyFrames in
- // der FEShell stehen!
- // kopiere alle Selectionen und das Doc
+ // For copying via ClipBoard:
+ // If table is copied into table, move all cursors away from it.
+ // Copy and Paste must be in FEShell because of FlyFrames!
+ // Copy all selections and the document.
BOOL _CopySelToDoc( SwDoc* pInsDoc, SwNodeIndex* pNdInsPos = 0 );
long SplitNode( BOOL bAutoFormat = FALSE, BOOL bCheckTableStart =
TRUE );
sal_Bool AppendTxtNode();
void AutoFmtBySplitNode();
- // ist der Cursor in einem INetAttribut, dann wird das komplett
- // geloescht; inclusive des Hinweistextes (wird beim Drag&Drop
gebraucht)
+ // If cursor is in a INetAttribute it will be deleted completely
+ // including the descriptive text (needed at drag & drop).
BOOL DelINetAttrWithText();
- // ist der Cursor am Ende einer Zeichenvorlage, an der das
DontExpand-Flag
- // noch nicht gesetzt ist, wird dies gesetzt ( => return TRUE; )
+ // If Cursor is at the end of a character style in which the
DontExpand-flag
+ is not yet set, the latter will be set (==> return TRUE).
BOOL DontExpandFmt();
- // Anwenden / Entfernen von Attributen
- // liefert Attribute im angeforderten AttributSet. Wenn nicht eindeutig
- // steht im Set ein DONT_CARE !!
+ // Apply / remove attributes.
+ // Returns attributs in required AttributeSet.
+ // When not unambiguous the set has a DONT_CARE !!
// 2nd optional parameter <bMergeIndentValuesOfNumRule>.
// If <bMergeIndentValuesOfNumRule> == TRUE, the indent attributes of
// the corresponding list level of an applied list style is merged
into
@@ -255,19 +249,19 @@ public:
void SetAttr( const SfxPoolItem&, USHORT nFlags = 0 );
void SetAttr( const SfxItemSet&, USHORT nFlags = 0 );
- // Setze das Attribut als neues default Attribut im Dokument.
+ // Set attribute as new default attribute in document.
void SetDefault( const SfxPoolItem& );
- // Erfrage das Default Attribut vom Dokument.
+ // Query default attribute of document.
const SfxPoolItem& GetDefault( USHORT nFmtHint ) const;
void ResetAttr( const SvUShortsSort* pAttrs = 0 );
void GCAttr();
- // returns the scripttpye of the selection
+ // Returns the scripttpye of the selection.
USHORT GetScriptType() const;
- // returns the language at current cursor position
+ // Returns the language at current cursor position.
USHORT GetCurLang() const;
// TABLE
@@ -284,14 +278,14 @@ public:
SwCharFmt* FindCharFmtByName( const String& rName ) const;
- /* Formatcollections, neu */
- /* GetXXXCount() liefert die Anzahl der im Dokument vorhandenen XXX
- * GetXXX(i) liefert das i-te XXX (ERR_RAISE bei Ueberindizierung!)
- * DelXXX(i) loescht das i-te XXX (ERR_RAISE bei Ueberindizierung!)
- * GetCurXXX() liefert das am Cursor oder in den Bereichen
- * geltende XXX (0, wenn nicht eindeutig!)
- * SetXXX() setzt am Cursor oder in den Bereichen das XXX
- * MakeXXX() macht ein XXX, abgeleitet vom pDerivedFrom
+ /* FormatCollections (new) - Explaining the general naming pattern:
+ * GetXXXCount() returns the count of xxx in the document.
+ * GetXXX(i) returns i-th xxx (ERR_RAISE if beyond range!).
+ * DelXXX(i) delets i-th xxx (ERR_RAISE if beyond range!).
+ * GetCurXXX() returns xxx that is valid at cursor or in ranges.
+ * returns 0, if not unanimuous.
+ * SetXXX() sets xxx at cursor or in ranges.
+ * MakeXXX() makes a xxx, derived from pDerivedFrom.
*/
// TXT
@@ -299,6 +293,7 @@ public:
USHORT GetTxtFmtCollCount() const;
SwTxtFmtColl& GetTxtFmtColl( USHORT nTxtFmtColl) const;
SwTxtFmtColl* GetCurTxtFmtColl() const;
+
// #i62675#
// Add 2nd optional parameter <bResetListAttrs> - see also
<SwDoc::SetTxtFmtColl(..)>
void SetTxtFmtColl( SwTxtFmtColl*,
@@ -308,28 +303,28 @@ public:
void FillByEx(SwTxtFmtColl*, BOOL bReset = FALSE);
SwTxtFmtColl* FindTxtFmtCollByName( const String& rName ) const;
- // Gebe die "Auto-Collection" mit der Id zurueck. Existiert
- // sie noch nicht, dann erzuege sie
+ // Return "Auto-Collection" with given Id. If it does not exist
create it.
SwTxtFmtColl* GetTxtCollFromPool( USHORT nId );
- // return das geforderte automatische Format - Basis-Klasse !
+
+ // Return required automatic format base class.
SwFmt* GetFmtFromPool( USHORT nId );
- // returne die geforderte automatische Seiten-Vorlage
+
+ // Return required automatic page style.
SwPageDesc* GetPageDescFromPool( USHORT nId );
- // erfrage ob die Absatz-/Zeichen-/Rahmen-/Seiten - Vorlage benutzt
wird
+ // Query if the paragraph-/character-/frame-/page-style is used.
BOOL IsUsed( const SwModify& ) const;
- // returne das geforderte automatische Format
+ // Return required automatic format.
SwFrmFmt* GetFrmFmtFromPool( USHORT nId )
{ return (SwFrmFmt*)SwEditShell::GetFmtFromPool( nId ); }
SwCharFmt* GetCharFmtFromPool( USHORT nId )
{ return (SwCharFmt*)SwEditShell::GetFmtFromPool( nId ); }
- // Felder
void Insert2(SwField&, const bool bForceExpandHints = false);
SwField* GetCurFld() const;
- void UpdateFlds( SwField & ); // ein einzelnes Feld
+ void UpdateFlds( SwField & ); // One single field.
USHORT GetFldTypeCount(USHORT nResId = USHRT_MAX, BOOL bUsed =
FALSE) const;
SwFieldType* GetFldType(USHORT nId, USHORT nResId = USHRT_MAX,
BOOL bUsed = FALSE) const;
@@ -342,7 +337,7 @@ public:
void ChangeAuthorityData(const SwAuthEntry* pNewData);
- // Datenbankinfo
+ // Database information.
SwDBData GetDBData() const;
const SwDBData& GetDBDesc() const;
void ChgDBData(const SwDBData& SwDBData);
@@ -352,7 +347,8 @@ public:
SvStringsDtor* pAllDBNames = 0 );
BOOL IsAnyDatabaseFieldInDoc()const;
- //check whether DB fields point to an available data source and
returns it
+
+ // Check whether DB fields point to an available data source and
returns it.
BOOL IsFieldDataSourceAvailable(String& rUsedDataSource) const;
void UpdateExpFlds(BOOL bCloseDB = FALSE);// nur alle
ExpressionFelder updaten
void SetFixFields( BOOL bOnlyTimeDate = FALSE,
@@ -363,28 +359,28 @@ public:
SwFldUpdateFlags GetFldUpdateFlags(BOOL bDocSettings = FALSE) const;
void SetFldUpdateFlags( SwFldUpdateFlags eFlags );
- // fuer die Evaluierung der DBFelder (neuer DB-Manager)
+ // For evaluation of DB fields (new DB-manager).
SwNewDBMgr* GetNewDBMgr() const;
SwFieldType* InsertFldType(const SwFieldType &);
- // Aenderungen am Dokument?
+ // Changes in document?
BOOL IsModified() const;
void SetModified();
void ResetModified();
void SetUndoNoResetModified();
- // Dokument - Statistics
+ // Document - Statistics
void UpdateDocStat( SwDocStat& rStat );
- // Verzeichnismarke einfuegen loeschen
void Insert(const SwTOXMark& rMark);
+
void DeleteTOXMark(SwTOXMark* pMark);
- // Alle Markierungen am aktuellen SPoint ermitteln
+ // Get all marks at current SPoint.
USHORT GetCurTOXMarks(SwTOXMarks& rMarks) const ;
- // Verzeichnis einfuegen, und bei Bedarf erneuern
+ // Insert content table. Renew if required.
void InsertTableOf(const SwTOXBase& rTOX,
const SfxItemSet* pSet = 0);
BOOL UpdateTableOf(const SwTOXBase& rTOX,
@@ -400,38 +396,37 @@ public:
const SwTOXBase* GetTOX( USHORT nPos ) const;
BOOL DeleteTOX( const SwTOXBase& rTOXBase, BOOL bDelNodes =
FALSE );
- // nach einlesen einer Datei alle Verzeichnisse updaten
+ // After reading file update all content tables.
void SetUpdateTOX( BOOL bFlag = TRUE );
BOOL IsUpdateTOX() const;
- // Verzeichnis-Typen verwalten
+ // Manage types of content tables.
USHORT GetTOXTypeCount(TOXTypes eTyp) const;
const SwTOXType* GetTOXType(TOXTypes eTyp, USHORT nId) const;
void InsertTOXType(const SwTOXType& rTyp);
- //AutoMark file
+ // AutoMark file
const String& GetTOIAutoMarkURL() const;
void SetTOIAutoMarkURL(const String& rSet);
void ApplyAutoMark();
- // Schluessel fuer die Indexverwaltung
+ // Key for managing index.
USHORT GetTOIKeys( SwTOIKeyType eTyp, SvStringsSort& rArr ) const;
void SetOutlineNumRule(const SwNumRule&);
const SwNumRule* GetOutlineNumRule() const;
- // Gliederung - hoch-/runterstufen
+
BOOL OutlineUpDown( short nOffset = 1 );
- // Gliederung - hoch-/runtermoven
+
BOOL MoveOutlinePara( short nOffset = 1);
- // Outlines and SubOutline are protected ?
+
BOOL IsProtectedOutlinePara() const;
- // Numerierung Aufzaehlunglisten
- // liefert Regelwerk der aktuellen Aufzaehlung (FALSE sonst)
+ // Returns numbering rulse pf current enumeration list (else FALSE).
const SwNumRule* GetCurNumRule() const;
- // setzt, wenn noch keine Numerierung, sonst wird geaendert
- // arbeitet mit alten und neuen Regeln, nur Differenzen aktualisieren
+ // If there is not already a numbering, set one, else change.
+ // Works with old and new rules. Update only differences.
// Add optional parameter <bResetIndentAttrs> (default value FALSE).
// If <bResetIndentAttrs> equals true, the indent attributes
"before text"
// and "first line indent" are additionally reset at the current
selection,
@@ -440,22 +435,26 @@ public:
// <bCreateNewList> indicates, if a new list is created by
applying the
// given list style.
// If <bCreateNewList> equals FALSE, <sContinuedListId> may
contain the
- // list Id of a list, which has to be continued by applying the
given list style
+ // list Id of a list, which has to be continued by applying the
given list style.
void SetCurNumRule( const SwNumRule&,
const bool bCreateNewList /*= false*/,
const String sContinuedListId = String(),
const bool bResetIndentAttrs = false );
- // Absaetze ohne Numerierung, aber mit Einzuegen
+
+ // Paragraphs without enumeration but with indents.
BOOL NoNum();
- // Loeschen, Splitten der Aufzaehlungsliste
+
+ // Delete, split enumeration list.
void DelNumRules();
- // Hoch-/Runterstufen
+
BOOL NumUpDown( BOOL bDown = TRUE );
- // Hoch-/Runtermoven sowohl innerhalb als auch ausserhalb von
Numerierungen
+
BOOL MoveParagraph( long nOffset = 1);
BOOL MoveNumParas( BOOL bUpperLower, BOOL bUpperLeft );
- // No-/Numerierung ueber Delete/Backspace ein/abschalten
+
+ // Switch on/off of numbering via Delete/Backspace.
BOOL NumOrNoNum( BOOL bDelete = FALSE, BOOL bChkStart = TRUE);
+
// #i23726#
// #i90078#
// Remove unused default parameter <nLevel> and <bRelative>.
@@ -467,17 +466,17 @@ public:
BOOL IsFirstOfNumRule(const SwPaM & rPaM) const;
BOOL IsNoNum( BOOL bChkStart = TRUE ) const;
- // returne den Num-Level des Nodes, in dem sich der Point vom
- // Cursor befindet. Return kann sein :
- // - NO_NUMBERING, 0..MAXLEVEL-1, NO_NUMLEVEL .. NO_NUMLEVEL|MAXLEVEL-1
+ // Return Num-Level of the node in which point of cursor is.
+ // Return values can be: NO_NUMBERING,
+ // 0..MAXLEVEL-1, NO_NUMLEVEL .. NO_NUMLEVEL|MAXLEVEL-1
BYTE GetNumLevel() const;
- // detect highest and lowest level to check moving of outline levels
+ // Detect highest and lowest level to check moving of outline levels.
void GetCurrentOutlineLevels( sal_uInt8& rUpper, sal_uInt8& rLower );
- // get Outline level of current paragraph
+ // Get Outline level of current paragraph.
int GetCurrentParaOutlineLevel( ) const;// #outlinelevel add by
zhaojianwei
// i29560
@@ -486,8 +485,8 @@ public:
String GetUniqueNumRuleName( const String* pChkStr = 0, BOOL
bAutoNum = TRUE ) const;
void ChgNumRuleFmts( const SwNumRule& rRule );
- // setze und erfrage, ob an aktueller PointPos eine Numerierung mit
- // dem StartFlag startet
+
+ // Set (and query if) a numbering with StartFlag starts at current
PointPos.
void SetNumRuleStart( BOOL bFlag = TRUE );
BOOL IsNumRuleStart() const;
void SetNodeNumStart( USHORT nStt );
@@ -495,6 +494,7 @@ public:
USHORT GetNodeNumStart() const;
BOOL ReplaceNumRule( const String& rOldRule, const String& rNewRule );
+
// Searches for a text node with a numbering rule.
// in case a list style is found, <sListId> holds the list id, to
which the
// text node belongs, which applies the found list style.
@@ -504,75 +504,75 @@ public:
int nNonEmptyAllowed,
String& sListId );
- // Undo
- // UndoHistory am Dokument pflegen
- // bei Save, SaveAs, Create wird UndoHistory zurueckgesetzt ???
+ // Undo.
+ // Maintain UndoHistory in Document.
+ // Reset UndoHistory at Save, SaveAs, Create ???
void DoUndo( BOOL bOn = TRUE );
BOOL DoesUndo() const;
void DoGroupUndo( BOOL bUn = TRUE );
BOOL DoesGroupUndo() const;
void DelAllUndoObj();
- // macht rueckgaengig:
- // setzt Undoklammerung auf, liefert nUndoId der Klammerung
+ // Undo: set up Undo parenthesis, return nUndoId of this parenthesis.
SwUndoId StartUndo( SwUndoId eUndoId = UNDO_EMPTY, const
SwRewriter * pRewriter = 0 );
- // schliesst Klammerung der nUndoId, nicht vom UI benutzt
+
+ // Closes parenthesis of nUndoId, not used by UI.
SwUndoId EndUndo( SwUndoId eUndoId = UNDO_EMPTY, const SwRewriter
* pRewriter = 0 );
- // liefert die Id der letzten undofaehigen Aktion zurueck
- // fuellt ggf. VARARR mit User-UndoIds
+
+ // Returns Id of last undo-able action. Fills VARARR with
User-UndoIds if required.
SwUndoId GetUndoIds( String* pUndoStr = 0, SwUndoIds *pUndoIds =
0) const;
String GetUndoIdsStr( String* pUndoStr = 0, SwUndoIds *pUndoIds =
0) const;
- // abfragen/setzen der Anzahl von wiederherstellbaren Undo-Actions
+ // Get count of possible undo-actions.
static USHORT GetUndoActionCount();
+
+ // Query count of possible undo-actions.
static void SetUndoActionCount( USHORT nNew );
- // Redo
- // liefert die Id der letzten Redofaehigen Aktion zurueck
- // fuellt ggf. VARARR mit RedoIds
+ // Redo.
+ // Returns Id of las undo-able action. Fills VARARR with RedoIds if
required.
SwUndoId GetRedoIds( String* pRedoStr = 0, SwUndoIds *pRedoIds =
0) const;
String GetRedoIdsStr( String* pRedoStr = 0, SwUndoIds *pRedoIds =
0) const;
- // Repeat
- // liefert die Id der letzten Repeatfaehigen Aktion zurueck
- // fuellt ggf. VARARR mit RedoIds
+ // Repeat.
+ // Returns Id of last repeatable action. Fills VARARR with RedoIds
if required.
SwUndoId GetRepeatIds( String* pRepeatStr = 0, SwUndoIds *pRedoIds
= 0) const;
String GetRepeatIdsStr( String* pRepeatStr = 0,
SwUndoIds *pRedoIds = 0) const;
- // 0 letzte Aktion, sonst Aktionen bis zum Start der Klammerung nUndoId
- // mit KillPaMs, ClearMark
+
+ // 0 if last action, else actions until start of parenthesis nUndoId
+ // with KillPaMs, ClearMark.
BOOL Undo(SwUndoId nUndoId = UNDO_EMPTY, USHORT nCnt = 1 );
- // wiederholt
+
USHORT Repeat( USHORT nCount );
- // wiederholt
+
USHORT Redo( USHORT nCnt = 1 );
- // fuer alle Sichten auf dieses Dokument
+
+ // For all views of this document.
void StartAllAction();
void EndAllAction();
- //Damit Start-/EndActions aufgesetzt werden koennen.
+ // To enable set up of StartActions and EndActions.
void CalcLayout();
- // Inhaltsform bestimmen, holen, liefert Type am CurCrsr->SPoint
+ // Determine form of content. Return Type at CurCrsr->SPoint.
USHORT GetCntType() const;
- BOOL HasOtherCnt() const; // gibt es Rahmen, Fussnoten, ...
- /* Anwenden der ViewOptions mit Start-/EndAction */
+ // Are there frames, footnotes, etc.
+ BOOL HasOtherCnt() const;
+
+ // Apply ViewOptions with Start-/EndAction.
inline void ApplyViewOptions( const SwViewOption &rOpt );
- // Text innerhalb der Selektion erfragen
- // Returnwert liefert FALSE, wenn der selektierte Bereich
- // zu gross ist, um in den Stringpuffer kopiert zu werden
- // oder andere Fehler auftreten
+ // Query text within selection.
+ // Returns FALSE, if selected range is too large to be copied
+ // into string buffer or if other errors occur.
BOOL GetSelectedText( String &rBuf,
int nHndlParaBreak = GETSELTXT_PARABRK_TO_BLANK );
- /*
- * liefert eine Graphic, wenn CurCrsr->Point() auf einen
- * SwGrfNode zeigt (und Mark nicht gesetzt ist oder auf die
- * gleiche Graphic zeigt), sonst gibt's was auf die Finger
- */
+ // Returns graphic, if CurCrsr->Point() points to a SwGrfNode
+ // (and mark is not set or points to the same graphic).
const Graphic* GetGraphic( BOOL bWait = TRUE ) const;
const GraphicObject* GetGraphicObj() const;
@@ -584,84 +584,78 @@ public:
void SetGraphicPolygon( const PolyPolygon *pPoly );
// If there's an automatic, not manipulated polygon at the selected
- // notxtnode, it has to be deleted, e.g. cause the object has changed.
+ notxtnode, it has to be deleted, e.g. cause the object has changed.
void ClearAutomaticContour();
- /*
- * liefert die Groesse einer Graphic in Twips, wenn der Cursor
- * auf einer Graphic steht; BOOL liefert FALSE, wenn s.o.
- */
+ // Returns the size of a graphic in Twips if cursor is in a graphic.
BOOL GetGrfSize(Size&) const;
- /*
- * liefert den Namen und den Filter einer Graphic, wenn der Cursor
- * auf einer Graphic steht, sonst gibt's was auf die Finger!
- * Ist ein String-Ptr != 0 dann returne den entsp. Namen
- */
+
+ // Returns name and filter of a graphic if the cursor is in a graphic,
+ // else give a rap on the knuckles!
+ // If a string-ptr != 0 return the respective name.
void GetGrfNms( String* pGrfName, String* pFltName,
const SwFlyFrmFmt* = 0 ) const;
- /*
- * erneutes Einlesen, falls Graphic nicht Ok ist. Die
- * aktuelle wird durch die neue ersetzt.
- */
+
+ // Re-read if graphic is not ok. Current graphic is replaced by the
new one.
void ReRead( const String& rGrfName, const String& rFltName,
const Graphic* pGraphic = 0,
const GraphicObject* pGrafObj = 0 );
- //eindeutige Identifikation des Objektes (fuer ImageMapDlg)
+ // Unique identification of object (for ImageMapDlg).
void *GetIMapInventor() const;
+
// #i73788#
- // remove default parameter, because method always called this
default value
- Graphic GetIMapGraphic() const; //liefert eine Graphic fuer alle Flys!
+ // Remove default parameter, because method always called this
default value.
+ Graphic GetIMapGraphic() const; // Returns a graphic for all Flys!
const SwFlyFrmFmt* FindFlyByName( const String& rName, BYTE nNdTyp
= 0 ) const;
- //liefert ein ClientObject, wenn CurCrsr->Point() auf einen
- //SwOLENode zeigt (und Mark nicht gesetzt ist oder auf das
- //gleiche ClientObject zeigt), sonst gibt's was auf die
- //Finger.
+ // Returns a ClientObject, if CurCrsr->Point() points to a SwOLENode
+ // (and mark is neither set not pointint to same ClientObject)
+ // else give rap on the knuckles.
svt::EmbeddedObjectRef& GetOLEObject() const;
- //Gibt es ein OleObject mit diesem Namen (SwFmt)?
+
+ // Is there an OLEObject with this name (SwFmt)?
BOOL HasOLEObj( const String &rName ) const;
- //Liefert den Pointer auf die Daten des Chart, indem sich der Crsr
- //befindet.
+ // Returns pointer to the data of the chart in which Cursr is.
void SetChartName( const String &rName );
- //Updaten der Inhalte aller Charts zu der Tabelle mit dem angegeben
Namen
+ // Update content of all charts for table with given name.
void UpdateCharts( const String &rName );
- // aktuelles Wort erfragen
String GetCurWord();
- // Textbaustein aus dem Textbausteindokument in
- // das aktuelle Dokument, Vorlagen nur wenn es nicht schon gibt
+ // Glossary from glossary document in current document.
+ // Styles only if not already existent.
void InsertGlossary( SwTextBlocks& rGlossary, const String& );
- // aktuelle Selektion zum Textbaustein machen und ins
- // Textbausteindokument einfuegen, einschliesslich Vorlagen
+
+ // Make current selection glossary and insert into glossary document
+ // including styles.
USHORT MakeGlossary( SwTextBlocks& rToFill, const String& rName,
const String& rShortName, BOOL bSaveRelFile =
FALSE,
const String* pOnlyTxt=0 );
- // speicher den gesamten Inhalt des Docs als Textbaustein
+
+ // Save complete content of doc as glossary.
USHORT SaveGlossaryDoc( SwTextBlocks& rGlossary, const String& rName,
const String& rShortName,
BOOL bSaveRelFile = FALSE,
BOOL bOnlyTxt = FALSE );
- // Linguistik
- // Selektionen sichern
+ // Linguistics...
+ // Save selections.
void HyphStart( SwDocPositions eStart, SwDocPositions eEnde );
- // Selektionen wiederherstellen
+
+ // restore selections.
void HyphEnd();
com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface>
HyphContinue( USHORT* pPageCnt, USHORT* pPageSt );
- // zu trennendes Wort ignorieren
+
void HyphIgnore();
- // zum Einfuegen des SoftHyphens, Position ist der Offset
- // innerhalb des getrennten Wortes.
+ // For Inserting SoftHyphen. Position is offset within the
syllabificated word.
void InsertSoftHyph( const xub_StrLen nHyphPos );
- //Tabelle
const SwTable& InsertTable( const SwInsertTableOptions&
rInsTblOpts, // ALL_TBL_INS_ATTR
USHORT nRows, USHORT nCols,
sal_Int16 eAdj =
com::sun::star::text::HoriOrientation::FULL,
@@ -689,49 +683,53 @@ public:
BOOL IsTableBoxTextFormat() const;
String GetTableBoxText() const;
- // Change Modus erfragen/setzen
TblChgMode GetTblChgMode() const;
void SetTblChgMode( TblChgMode eMode );
- // Tabelle an der Cursor Position aufsplitten
+ // Split table at cursor position.
BOOL SplitTable( USHORT eMode );
- // Tabellen verbinden
- // CanMerge kann feststellen, ob Prev oder Next moeglich ist. Wird
- // der Pointer pChkNxtPrv uebergeben, wird festgestellt in welche
- // Richtung es moeglich ist.
+
+ // Merge tables.
+
+ // Can Merge checks if Prev or Next are possible.
+ // If pointer pChkNxtPrv is passed possible direction is given.
BOOL CanMergeTable( BOOL bWithPrev = TRUE, BOOL* pChkNxtPrv = 0 )
const;
BOOL MergeTable( BOOL bWithPrev = TRUE, USHORT nMode = 0 );
- // setze das InsertDB als Tabelle Undo auf:
+
+ // Set up InsertDB as table Undo.
void AppendUndoForInsertFromDB( BOOL bIsTable );
- /*
- functions used for spell checking and text conversion
- */
+ // Functions used for spell checking and text conversion.
- // Selektionen sichern
+ // Save selections.
void SpellStart( SwDocPositions eStart, SwDocPositions eEnde,
SwDocPositions eCurr, SwConversionArgs *pConvArgs
= 0 );
- // Selektionen wiederherstellen
+
+ // Restore selections.
void SpellEnd( SwConversionArgs *pConvArgs = 0, bool
bRestoreSelection = true );
::com::sun::star::uno::Any SpellContinue(
USHORT* pPageCnt, USHORT* pPageSt,
SwConversionArgs *pConvArgs = 0 );
- // spells on a sentence basis - the SpellPortions are needed
- // returns false if no error could be found
+ // Spells on a sentence basis - the SpellPortions are needed
+ // returns false if no error could be found.
bool SpellSentence(::svx::SpellPortions& rToFill, bool
bIsGrammarCheck );
- // make SpellIter start with the current sentence when called next time
+
+ // Make SpellIter start with the current sentence when called next
time.
void PutSpellingToSentenceStart();
- // moves the continuation position to the end of the currently
checked sentence
+
+ // Moves the continuation position to the end of the currently
checked sentence.
void MoveContinuationPosToEndOfCheckedSentence();
- //applies a changed sentence
- void ApplyChangedSentence(const ::svx::SpellPortions& rNewPortions,
bool bRecheck);
+ // Applies a changed sentence.
+ void ApplyChangedSentence(const ::svx::SpellPortions& rNewPortions,
bool bRecheck);
- // check SwSpellIter data to see if the last sentence got grammar
checked
+ // Check SwSpellIter data to see if the last sentence got grammar
checked.
bool HasLastSentenceGotGrammarChecked() const;
+
// Is text conversion active somewhere else?
BOOL HasConvIter() const;
+
// Is hyphenation active somewhere else?
BOOL HasHyphIter() const;
@@ -749,59 +747,61 @@ public:
void IgnoreGrammarErrorAt( SwPaM& rErrorPosition );
void SetLinguRange( SwDocPositions eStart, SwDocPositions eEnde );
- // returne zum Namen die im Doc gesetzte Referenz
+ // Return reference set in document according to given name.
const SwFmtRefMark* GetRefMark( const String& rName ) const;
- // returne die Namen aller im Doc gesetzten Referenzen
- // Ist der ArrayPointer 0 dann returne nur, ob im Doc. eine RefMark
- // gesetzt ist
+
+ // Return names of all references set in document.
+ // If ArrayPointer == 0 then return only whether a RefMark is set
in document.
USHORT GetRefMarks( SvStringsDtor* = 0 ) const;
- // rufe die Autokorrektur auf
+ // Call AutoCorrect
void AutoCorrect( SvxAutoCorrect& rACorr, BOOL bInsertMode = TRUE,
sal_Unicode cChar = ' ' );
BOOL GetPrevAutoCorrWord( SvxAutoCorrect& rACorr, String& rWord );
- // dann setze nach entsprechenden Regeln unsere Vorlagen
+ // Set our styles according to the respective rules.
void AutoFormat( const SvxSwAutoFmtFlags* pAFlags = 0 );
static SvxSwAutoFmtFlags* GetAutoFmtFlags();
static void SetAutoFmtFlags(SvxSwAutoFmtFlags *);
- // errechnet die Selektion
+ // Calculates selection.
String Calculate();
BOOL InsertURL( const SwFmtINetFmt& rFmt, const String& rStr,
BOOL bKeepSelection = FALSE );
USHORT GetINetAttrs( SwGetINetAttrs& rArr );
- //SS Fuer holen/ersetzen DropCap-Inhalt
String GetDropTxt( const USHORT nChars ) const;
void ReplaceDropTxt( const String &rStr );
- // may an outline be moved or copied?
- // Check whether it's in text body, not in table, and not read-only
(move)
+ // May an outline be moved or copied?
+ // Check whether it's in text body, not in table, and not read-only
(move).
BOOL IsOutlineMovable( USHORT nIdx ) const;
BOOL IsOutlineCopyable( USHORT nIdx ) const;
USHORT GetLineCount( BOOL bActPos = TRUE );
- // erfrage und setze den Fussnoten-Text/Nummer. Set.. auf akt.
SSelection!
+ // Query and set footnote-text/number. Set.. to current SSelection!
BOOL GetCurFtn( SwFmtFtn* pToFillFtn = 0 );
bool SetCurFtn( const SwFmtFtn& rFillFtn );
bool HasFtns( bool bEndNotes = false ) const;
-//z.Zt nicht benoetigt USHORT GetFtnCnt( BOOL bEndNotes = FALSE ) const;
- // gebe Liste aller Fussnoten und deren Anfangstexte
+
+ // USHORT GetFtnCnt( BOOL bEndNotes = FALSE ) const; //Currently
not required.
+
+ // Return list of all footnotes and their first portions of text.
USHORT GetSeqFtnList( SwSeqFldList& rList, bool bEndNotes = false );
SwSection const* InsertSection(
SwSectionData & rNewData, SfxItemSet const*const = 0 );
BOOL IsInsRegionAvailable() const;
const SwSection* GetCurrSection() const;
- // liefert wie GetCurrSection() den aktuellen Bereich, allerdings
geht diese Funktion
- // ueber die Frames und erwischt dabei auch den Bereich, wenn der
Cursor in einer
- // Fussnote steht, deren Referenz in einem spaltigen Bereich steckt.
- // Wenn man bOutOfTab setzt, wird der Bereich gesucht,
- // der die Tabelle umfasst, nicht etwa ein innerer.
+
+ // Returns current range like Cet CurrSection(). But this function
iterates
+ // also over frames and catches the range even if the cursor is
positioned in
+ // a footnote the reference of which is in a columned range.
+ // If bOutOfTab is set, the range comprising the table is searched
+ // and not an inner one.
const SwSection* GetAnySection( BOOL bOutOfTab = FALSE, const
Point* pPt = 0 ) const;
USHORT GetSectionFmtCount() const;
@@ -816,15 +816,15 @@ public:
String GetUniqueSectionName( const String* pChkStr = 0 ) const;
- //Attribute setzen
+ // Set attributes.
void SetSectionAttr(const SfxItemSet& rSet, SwSectionFmt* pSectFmt
= 0);
- // search inside the cursor selection for full selected sections.
+ // Search inside the cursor selection for full selected sections.
// if any part of section in the selection return 0.
- // if more than one in the selection return the count
+ // if more than one in the selection return the count.
USHORT GetFullSelectedSectionCount() const;
- // special insert: Insert a new text node just before or after a
section or
+ // Special insert: Insert a new text node just before or after a
section or
// table, if the cursor is positioned at the start/end of said
// section/table. The purpose of the method is to allow users to
inert text
// at certain 'impossible' position, e.g. before a table at the
document
@@ -832,7 +832,7 @@ public:
bool DoSpecialInsert();
bool CanSpecialInsert() const;
- // Optimierung UI
+ // Optimizing UI.
void SetNewDoc(BOOL bNew = TRUE);
sfx2::LinkManager& GetLinkManager();
@@ -844,12 +844,12 @@ public:
BOOL IsMoveLeftMargin( BOOL bRight = TRUE, BOOL bModulus = TRUE )
const;
void MoveLeftMargin( BOOL bRight = TRUE, BOOL bModulus = TRUE );
- // Numberformatter vom Doc erfragen
+ // Query NumberFormater from document.
SvNumberFormatter* GetNumberFormatter();
const SvNumberFormatter* GetNumberFormatter() const
{ return ((SwEditShell*)this)->GetNumberFormatter(); }
- // Schnitstellen fuers GlobalDokument
+ // Interfaces for GlobalDocument.
BOOL IsGlobalDoc() const;
void SetGlblDocSaveLinks( BOOL bFlag = TRUE );
BOOL IsGlblDocSaveLinks() const;
@@ -866,7 +866,7 @@ public:
USHORT nNewPos );
BOOL GotoGlobalDocContent( const SwGlblDocContent& rPos );
- // alles fuers Redlining
+ // For Redlining.
USHORT GetRedlineMode() const;
void SetRedlineMode( USHORT eMode );
BOOL IsRedlineOn() const;
@@ -874,58 +874,59 @@ public:
const SwRedline& GetRedline( USHORT nPos ) const;
BOOL AcceptRedline( USHORT nPos );
BOOL RejectRedline( USHORT nPos );
- // suche das Redline zu diesem Data und returne die Pos im Array
- // USHRT_MAX wird returnt, falls nicht vorhanden
+
+
+ // Search Redline for this Data and return position in array.
+ // If not found, return USHRT_MAX.
USHORT FindRedlineOfData( const SwRedlineData& ) const;
- // Kommentar am Redline an der Position setzen
+ // Set comment to Redline at position.
BOOL SetRedlineComment( const String& rS );
const SwRedline* GetCurrRedline() const;
- // Redline Anzeigeattribute wurden geaendert, Views updaten
+ // Redline attributes have been changed. Updated views.
void UpdateRedlineAttr();
- // vergleiche zwei Dokument mit einander
+ // Compare two documents.
long CompareDoc( const SwDoc& rDoc );
- // merge zweier Dokumente
+
+ // Merge two documents.
long MergeDoc( const SwDoc& rDoc );
- // Dokumentglobale Fussnoteneigenschaften
+ // Footnote attributes global to document.
const SwFtnInfo& GetFtnInfo() const;
void SetFtnInfo(const SwFtnInfo& rInfo);
const SwEndNoteInfo& GetEndNoteInfo() const;
void SetEndNoteInfo(const SwEndNoteInfo& rInfo);
- //Einstellungen fuer Zeilennummierung
const SwLineNumberInfo &GetLineNumberInfo() const;
void SetLineNumberInfo( const SwLineNumberInfo& rInfo);
- // Etiketten: Bereiche synchronisieren
+ // Labels: Synchronize ranges.
void SetLabelDoc( BOOL bFlag = TRUE );
BOOL IsLabelDoc() const;
- // Schnittstelle fuer die TextInputDaten - ( fuer die Texteingabe
- // von japanischen/chinesischen Zeichen)
+ // Interface for TextInputData - (for input of Japanese/Chinese chars.)
SwExtTextInput* CreateExtTextInput(LanguageType eInputLanguage);
String DeleteExtTextInput( SwExtTextInput* pDel = 0, BOOL bInsText
= TRUE);
void SetExtTextInputData( const CommandExtTextInputData& );
- // Schnistelle fuer den Zugriff auf die AutoComplete-Liste
+ // Interface for access to AutoComplete-list.
static SwAutoCompleteWord& GetAutoCompleteWords();
- // returns a scaling factor of selected text. Used for the rotated
+ // Returns a scaling factor of selected text. Used for the rotated
// character attribut dialog.
USHORT GetScalingOfSelectedText() const;
- // ctor/dtor
+ // Ctor/Dtor.
SwEditShell( SwDoc&, Window*, const SwViewOption *pOpt = 0 );
- // verkleideter Copy-Constructor
+
+ // Copy-Constructor in disguise.
SwEditShell( SwEditShell&, Window* );
virtual ~SwEditShell();
private:
- // fuer METWARE:
- // es wird nicht kopiert und nicht zugewiesen
+ // For METWARE: no copying and no assignment.
SwEditShell(const SwEditShell &);
const SwEditShell &operator=(const SwEditShell &);
};
@@ -940,10 +941,7 @@ inline void SwEditShell::ApplyViewOptions( const
SwViewOption &rOpt )
inline const sfx2::LinkManager& SwEditShell::GetLinkManager() const
{ return ((SwEditShell*)this)->GetLinkManager(); }
-/*
- * Klasse fuer den automatisierten Aufruf von Start- und
- * EndAction();
- */
+// Class for automated call of Start- and EndAction().
class SwActKontext {
SwEditShell *pSh;
public:
@@ -953,10 +951,7 @@ public:
#define ACT_KONTEXT(x) SwActKontext _aActKontext_(x)
-/*
- * Klasse fuer den automatisierten Aufruf von Start- und
- * EndCrsrMove();
- */
+// Class for automated call of Start- and EndCrsrMove().
class SwMvKontext {
SwEditShell *pSh;
public:
--
1.7.1
More information about the LibreOffice
mailing list