[Libreoffice-commits] .: sw/inc
Christoph Herzog
cherzog at kemper.freedesktop.org
Sat Feb 19 05:42:23 PST 2011
sw/inc/grfatr.hxx | 12 +--
sw/inc/helpid.h | 12 +--
sw/inc/hintids.hxx | 33 ++++------
sw/inc/htmltbl.hxx | 166 +++++++++++++++++++++++++----------------------------
4 files changed, 107 insertions(+), 116 deletions(-)
New commits:
commit fc37bcd78650214c5bc9670fddc4efe20c1ca93a
Author: Christoph Herzog <rhogez at googlemail.com>
Date: Sat Feb 19 14:38:10 2011 +0100
Translation of German comments.
diff --git a/sw/inc/grfatr.hxx b/sw/inc/grfatr.hxx
index 25a0821..9529a49 100644
--- a/sw/inc/grfatr.hxx
+++ b/sw/inc/grfatr.hxx
@@ -28,14 +28,14 @@
#ifndef _GRFATR_HXX
#define _GRFATR_HXX
-#include <hintids.hxx> // fuer die WhichIds @@@ must be included first @@@
+#include <hintids.hxx> // For the WhichIds @@@ must be included first @@@
#include <tools/gen.hxx>
#include <svl/eitem.hxx>
#include <svl/intitem.hxx>
#include <svx/grfcrop.hxx>
#include "swdllapi.h"
-#include <swatrset.hxx> // fuer inlines
-#include <format.hxx> // fuer inlines
+#include <swatrset.hxx> // For inlines.
+#include <format.hxx> // For inlines.
/******************************************************************************
* class SwMirrorGrf
@@ -53,7 +53,7 @@ RES_MIRROR_GRAPH_END
class SW_DLLPUBLIC SwMirrorGrf : public SfxEnumItem
{
- BOOL bGrfToggle; // auf geraden Seiten Grafiken spiegeln
+ BOOL bGrfToggle; // Flip graphics on even pages.
public:
SwMirrorGrf( MirrorGraph eMiro = RES_MIRROR_GRAPH_DONT )
@@ -310,7 +310,7 @@ public:
/******************************************************************************
- * Implementierung der GrafikAttribut Methoden vom SwAttrSet
+ * Implementation of graphics attributes methods of SwAttr
******************************************************************************/
inline const SwMirrorGrf &SwAttrSet::GetMirrorGrf(BOOL bInP) const
@@ -339,7 +339,7 @@ inline const SwDrawModeGrf &SwAttrSet::GetDrawModeGrf(BOOL bInP) const
{ return (const SwDrawModeGrf&)Get( RES_GRFATR_DRAWMODE,bInP); }
/******************************************************************************
- * Implementierung der GrafikAttribut Methoden vom SwFmt
+ * Implementation of graphics attributes methods of SwFmt
******************************************************************************/
inline const SwMirrorGrf &SwFmt::GetMirrorGrf(BOOL bInP) const
diff --git a/sw/inc/helpid.h b/sw/inc/helpid.h
index 988a7f3..b4a78aa 100644
--- a/sw/inc/helpid.h
+++ b/sw/inc/helpid.h
@@ -88,7 +88,7 @@
#define HID_DRAW_WIN (HID_BASE + 52)
#define HID_EDIT_WIN (HID_BASE + 53)
-#define HID_INSERT_CTRL (HID_BASE + 54) // TbxControl Einfuegen
+#define HID_INSERT_CTRL (HID_BASE + 54) // Insert TbxControl.
#define HID_INSERT_OBJ_CTRL (HID_BASE + 55)
#define HID_INSERT_FIELD_CTRL (HID_BASE + 56)
@@ -108,7 +108,7 @@
#define HID_PAGEPREVIEW (HID_BASE + 67)
#define HID_SOURCE_EDITWIN (HID_BASE + 68)
-// Dialog Help-IDs **********************************************************
+// Dialog Help-IDs
#define HID_CONVERT_FROM (HID_BASE + 200)
#define HID_CONVERT_TO (HID_BASE + 201)
@@ -224,7 +224,7 @@
#define HID_REFSELECTION_TOOLTIP (HID_BASE + 309) // #i83479#
-// TabPage Help-IDs *********************************************************
+// TabPage Help-IDs
#define HID_DROPCAPS (HID_BASE + 400)
#define HID_FRM_EXT (HID_BASE + 401)
@@ -312,7 +312,7 @@
#define HID_OPTCOMPATIBILITY_PAGE (HID_BASE + 483)
#define HID_COMPATIBILITY_OPTIONS_BOX (HID_BASE + 484)
-// AutoPilot Help-IDs *********************************************************
+// AutoPilot Help-IDs
#define HID_LETTER_PAGE1 (HID_BASE + 501)
#define HID_LETTER_PAGE2 (HID_BASE + 502)
@@ -350,7 +350,7 @@
#define HID_AUTOPILOT_PREV (HID_BASE + 538)
#define HID_AUTOPILOT_OK (HID_BASE + 539)
-// HelpIds fuers Menue *****************************************************
+// HelpIds for Menu
#define HID_MN_SUB_TBLROW (HID_BASE + 600)
#define HID_MN_SUB_TBLCOL (HID_BASE + 601)
@@ -431,7 +431,7 @@
#define HID_SMARTTAG_MAIN (HID_BASE + 675) // SMARTTAGS
#define HID_LINGU_IGNORE_SELECTION (HID_BASE + 676) // grammar check context menu
-// Weiter Help-IDs **********************************************************
+// More Help-IDs
#define HID_CLOSE_FILE (HID_BASE + 1001)
#define HID_LAUNCH_REGISTRY (HID_BASE + 1002)
diff --git a/sw/inc/hintids.hxx b/sw/inc/hintids.hxx
index c47e7c1..9b8178b 100644
--- a/sw/inc/hintids.hxx
+++ b/sw/inc/hintids.hxx
@@ -32,7 +32,7 @@
#include <sal/types.h> // for sal_Unicode
#include "swdllapi.h"
-// fuer SwTxtHints ohne Endindex wird folgendes Zeichen eingefuegt:
+// For SwTxtHints without end index the following char is added:
#define CH_TXTATR_BREAKWORD ((sal_Unicode)0x01)
#define CH_TXTATR_INWORD ((sal_Unicode)0x02)
@@ -53,8 +53,8 @@
#define POOLATTR_BEGIN HINT_BEGIN
#define POOLATTR_END RES_UNKNOWNATR_END
-// Bereiche fuer die Id's der einzelnen Format-Attribute
-// die Which-Werte fuer die Charakter-Format Attribute
+// Ranges for the IDs of the format-attributes.
+// Which-values for character-format attributes.
enum RES_CHRATR
{
RES_CHRATR_BEGIN = HINT_BEGIN,
@@ -339,12 +339,10 @@ RES_MSG_BEGIN = RES_FMT_END,
RES_MSG_END
};
-
-// eine ID fuer den RTF-Reader. Die Stylesheets werden wie
-// Attribute behandelt, d.H. es gibt ein StyleSheet Attribut. Um
-// nicht mit anderen Which()-Werten zu kollidieren, ist der Wert
-// hier mit aufgefuehrt. (Auch das Hilfesystem definiert neue
-// Attribute !!)
+// An ID for the RTF-reader. The stylesheets are treated like attributes,
+// i.e. there is a StyleSheet-attribute. To avoid collision with other
+// Which()-values, the value is listed here. (The help system too defines
+// new attributes!)
enum RES_FLTRATTR
{
RES_FLTRATTR_BEGIN = RES_MSG_END,
@@ -366,7 +364,7 @@ RES_FLTRATTR_END
#define HINT_END RES_TBX_DUMMY
-// Fehler-Erkennung !!
+// Error recognition!!
#define INVALID_HINT HINT_END
#define RES_WHICHHINT_END HINT_END
@@ -418,15 +416,12 @@ inline bool isUNKNOWNATR(const USHORT nWhich)
}
-/*
- * hole aus der statischen Default-Attribut Tabelle ueber den Which-Wert
- * das entsprechende default Attribut.
- * Ist keines vorhanden, returnt ein 0-Pointer !!!
- *
- * Diese Funktion ist im Init.CXX implementiert. Damit die Formate darauf
- * zugreifen koennen, ist sie hier als extern deklariert.
- * Im PRODUCT ist das Teil inline.
- */
+// Take the respective default attribute from the statistical default
+// attributes table over the Which-value.
+// If none exists, return a 0 pointer!!!
+// This function is implemented in Init.cxx. It is declared here as external
+// in order to allow the formats to access it.
+// Inline in PRODUCT.
class SfxPoolItem;
struct SfxItemInfo;
typedef SfxPoolItem* SwDfltAttrTab[ POOLATTR_END - POOLATTR_BEGIN ];
diff --git a/sw/inc/htmltbl.hxx b/sw/inc/htmltbl.hxx
index ebcfcd6..9dd8973 100644
--- a/sw/inc/htmltbl.hxx
+++ b/sw/inc/htmltbl.hxx
@@ -47,24 +47,24 @@ class SwFrmFmt;
class SwHTMLTableLayoutCnts
{
- SwHTMLTableLayoutCnts *pNext; // der naechste Inhalt
+ SwHTMLTableLayoutCnts *pNext; // The next content.
- // von den beiden naechsten Pointern darf nur einer gesetzt sein!
- SwTableBox *pBox; // ein Box
- SwHTMLTableLayout *pTable; // eine "Tabelle in der Tabelle"
+ // Only one of the following two pointers may be set!
+ SwTableBox *pBox; // A Box.
+ SwHTMLTableLayout *pTable; // A "table within a table".
- // Beim ersten Durchlauf gibt es noch keine Boxen. Es wird dann
- // pStartNode anstelle von pBox verwendet.
+ // During first run there are still no boxes. In this case
+ // pStartNode is used instead of pBox.
const SwStartNode *pStartNode;
- // Die folgenden Zahler geben an, wie oft ein Pass bereits fuer diesen
- // Inhalt durchgefuehrt wurde. Dazu werden sie mit einer Soll-Vorgabe
- // verglichen. Wird 255 erreicht laufen sie bei 0 weiter. So wird
- // eine Reinitialisierung bei jedem Resize vermieden.
- BYTE nPass1Done; // Wieoft wurde Pass 1 aufgerufen?
- BYTE nWidthSet; // Wieoft wurde die Breite gesetzt?
+ // The following counters indicate how often a pass has been
+ // done for this content. Therefore they are compared against
+ // a reference value. If 255 is reached the continue with 0.
+ // This avoids reinitialization on every resize.
+ BYTE nPass1Done; // How many times has Pass 1 been called?
+ BYTE nWidthSet; // How many times has the width been set?
- BOOL bNoBreakTag; // <NOBR>-Tag ueber gesamten Inhalt
+ BOOL bNoBreakTag; // <NOBR>-Tag over complete content.
public:
@@ -80,7 +80,7 @@ public:
const SwStartNode *GetStartNode() const;
- // Ermitteln des naechsten Knotens
+ // Calculation of next node.
SwHTMLTableLayoutCnts *GetNext() const { return pNext; }
void SetWidthSet( BYTE nRef ) { nWidthSet = nRef; }
@@ -94,14 +94,14 @@ public:
class SwHTMLTableLayoutCell
{
- SwHTMLTableLayoutCnts *pContents; // der Inhalt der Zelle
+ SwHTMLTableLayoutCnts *pContents; // Content of cell.
- USHORT nRowSpan; // ROWSPAN der Zelle
- USHORT nColSpan; // COLSPAN der Zelle
- USHORT nWidthOption;// angegebene Breite der Zelle in Twip oder %
+ USHORT nRowSpan; // ROWSPAN of cell.
+ USHORT nColSpan; // COLSPAN of cell.
+ USHORT nWidthOption;// Given width of cell in Twip or %.
- BOOL bPrcWidthOption : 1;// nWidth ist %-Angabe
- BOOL bNoWrapOption : 1; // NOWRAP-Option
+ BOOL bPrcWidthOption : 1;// nWidth is %-value.
+ BOOL bNoWrapOption : 1; // NOWRAP-option.
public:
@@ -112,13 +112,13 @@ public:
~SwHTMLTableLayoutCell();
- // Setzen/Ermitteln des Inhalts einer Zelle
+ // Set or get content of a cell.
void SetContents( SwHTMLTableLayoutCnts *pCnts ) { pContents = pCnts; }
SwHTMLTableLayoutCnts *GetContents() const { return pContents; }
inline void SetProtected();
- // ROWSPAN/COLSPAN der Zelle Setzen/Ermitteln
+ // Set or get ROWSPAN/COLSPAN of cell.
void SetRowSpan( USHORT nRSpan ) { nRowSpan = nRSpan; }
USHORT GetRowSpan() const { return nRowSpan; }
USHORT GetColSpan() const { return nColSpan; }
@@ -131,17 +131,18 @@ public:
class SwHTMLTableLayoutColumn
{
- // Zwischenwerte von AutoLayoutPass1
+
+ // Interim values of AutoLayoutPass1,
ULONG nMinNoAlign, nMaxNoAlign, nAbsMinNoAlign;
- // Ergebnisse von AutoLayoutPass1
+ // Results of AutoLayoutPass1
ULONG nMin, nMax;
- // Ergibnisse von Pass 2
- USHORT nAbsColWidth; // in Twips
- USHORT nRelColWidth; // in Twips bzw. relativ zu USHRT_MAX
+ // Results of Pass 2.
+ USHORT nAbsColWidth; // In Twips.
+ USHORT nRelColWidth; // In Twips or relative to USHRT_MAX.
- USHORT nWidthOption; // Optionen von <COL> oder <TD>/<TH>
+ USHORT nWidthOption; // Options of <COL> or <TD>/<TH>.
BOOL bRelWidthOption : 1;
BOOL bLeftBorder : 1;
@@ -183,37 +184,37 @@ public:
class SwHTMLTableLayout
{
- Timer aResizeTimer; // Timer fuer DelayedResize
+ Timer aResizeTimer; // Timer for DelayedResize.
SwHTMLTableLayoutColumn **aColumns;
SwHTMLTableLayoutCell **aCells;
- const SwTable *pSwTable; // die SwTable (nur Top-Table)
- SwTableBox *pLeftFillerBox; // linke Filler-Zelle (nur Tab in Tab)
- SwTableBox *pRightFillerBox; // rechte Filler-Zelle (nur Tab-in Tab)
+ const SwTable *pSwTable; // SwTable (Top-Table only).
+ SwTableBox *pLeftFillerBox; // Left filler-box (table in table only).
+ SwTableBox *pRightFillerBox; // Right filler-box (table in Table only).
- ULONG nMin; // minimale Breite der Tabelle (Twips)
- ULONG nMax; // maximale Breite der Tabelle (Twips)
+ ULONG nMin; // Minimal width of table (Twips).
+ ULONG nMax; // Maximal width of table (Twips).
- USHORT nRows; // Anzahl Zeilen
- USHORT nCols; // Anzahl Spalten
+ USHORT nRows; // Row count.
+ USHORT nCols; // Column count.
- USHORT nLeftMargin; // Abstand zum linken Rand (aus Absatz)
- USHORT nRightMargin; // Abstand zum rechten Rand (aus Absatz)
+ USHORT nLeftMargin; // Space to left margin (from paragraph).
+ USHORT nRightMargin; // Space to left margin (from paragraph).
- USHORT nInhAbsLeftSpace; // von umgebender Zelle geerbter Abstand,
- USHORT nInhAbsRightSpace; // der Zellen zugeschlagen wurde
+ USHORT nInhAbsLeftSpace; // Space inherited from surrounding box
+ USHORT nInhAbsRightSpace; // that was added to boxes.
- USHORT nRelLeftFill; // relative Breiten der Zellen zur
- USHORT nRelRightFill; // Ausrichtung von Tabellen in Tabellen
+ USHORT nRelLeftFill; // Width of boxes relative to alignment
+ USHORT nRelRightFill; // of tables in tables.
- USHORT nRelTabWidth; // Die relative Breite der Tabelle
+ USHORT nRelTabWidth; // Relative width of table.
- USHORT nWidthOption; // die Breite der Tabelle (in Twip oder %)
- USHORT nCellPadding; // Abstand zum Inhalt (in Twip)
- USHORT nCellSpacing; // Absatnd zwischen Zellen (in Twip)
- USHORT nBorder; // Dicke der ausseren Umrandung bzw.
- // Platz, den Netscape hierfuer einrechnet.
+ USHORT nWidthOption; // Width of table (in Twips oder %).
+ USHORT nCellPadding; // Space to contents (in Twips).
+ USHORT nCellSpacing; // Cell spacing (in Twips).
+ USHORT nBorder; // Line strength of outer border, or rather the
+ // space needed for it as calculated by Netscape.
USHORT nLeftBorderWidth;
USHORT nRightBorderWidth;
@@ -221,28 +222,27 @@ class SwHTMLTableLayout
USHORT nInhRightBorderWidth;
USHORT nBorderWidth;
- USHORT nDelayedResizeAbsAvail; // Param fuer's verzoegerte Resize
+ USHORT nDelayedResizeAbsAvail; // Param for delayed Resize.
USHORT nLastResizeAbsAvail;
- BYTE nPass1Done; // Vorgabe-Werte fuer die einzelen
- BYTE nWidthSet; // Schleifen-Durchlauefe
+ BYTE nPass1Done; // Reference-values for
+ BYTE nWidthSet; // the runs through loop.
- SvxAdjust eTableAdjust; // Die Ausrichtung der Tabelle
+ SvxAdjust eTableAdjust; // Alignment of table.
- BOOL bColsOption : 1; // Tabelle besitzt eine COLS-Option
- BOOL bColTags : 1; // Tabelle besitzt COL/COLGRP-Tags
- BOOL bPrcWidthOption : 1; // Breite ist eine %-Angabe
- BOOL bUseRelWidth : 1; // SwTable bekommt relative Breite
+ BOOL bColsOption : 1; // Table has a COLS-option.
+ BOOL bColTags : 1; // Tabelle has COL/COLGRP-tags.
+ BOOL bPrcWidthOption : 1; // Width is given in percent.
+ BOOL bUseRelWidth : 1; // SwTable gets relative width.
- BOOL bMustResize : 1; // Tabelle muss in der Breite ang. werden
- BOOL bExportable : 1; // Layout kann zum Export genutzt werden
- BOOL bBordersChanged : 1; // Umrandung wurde geaendert
- BOOL bMayBeInFlyFrame : 1; // Die Tabelle koennte im Rahmen sein
+ BOOL bMustResize : 1; // Table width must be defined.
+ BOOL bExportable : 1; // Layout may be used for export.
+ BOOL bBordersChanged : 1; // Borders have been changed.
+ BOOL bMayBeInFlyFrame : 1; // Table could be within frame.
- BOOL bDelayedResizeRecalc : 1; // Param fuer's verzoegerte Resize
- BOOL bMustNotResize : 1; // Die Tabelle darf nicht reseized werden
- BOOL bMustNotRecalc : 1; // Tabelle darf nicht an Inhalt angepasst
- // werden
+ BOOL bDelayedResizeRecalc : 1; // Param for delayed Resize.
+ BOOL bMustNotResize : 1; // Table may not be resized.
+ BOOL bMustNotRecalc : 1; // Table may not be adapted to its contents.
void AddBorderWidth( ULONG &rMin, ULONG &rMax, ULONG& rAbsMin,
USHORT nCol, USHORT nColSpan,
@@ -318,38 +318,34 @@ public:
void SetMustNotResize( BOOL bSet ) { bMustNotResize = bSet; }
void SetMustNotRecalc( BOOL bSet ) { bMustNotRecalc = bSet; }
- // Neueberechnung der Tabellenbreiten fuer die uebergebene verfuegbare
- // Breite.
- // - Wenn bRecalc gesetzt ist, werden auch der Inhalt der Boxen
- // zur Berechnung herangezogen.
- // neu berechnet.
- // - Wenn bForce gesetzt ist, wird die Tabelle auch neu berechnet, wenn
- // dies mit SetMustNotResize unterdrueckt werden soll.
- // - Wenn nDelay>0 wird die Berechnung entsprechend verzoegert.
- // Innerhalb der Verzeoegerung auftretende Resize-Aufrufe werden
- // ignoriert, die Verzeogerung wird aber ggf. uebernommen.
- // - Wenn nDelay==HTMLTABLE_RESIZE_NOW ist, wird sofort Resized und
- // eventuell noch asstehende Resize-Aufrufe werden nicht mehr
- // ausgefuehrt.
- // - Der Rueckgabewert gibt an, ob sich die Tabelle geaendert hat.
+ // Recalculation of table widths for available width that has been passed.
+ // - If bRecalc is set, contents of boxes are included into calculation.
+ // - If bForce is set, table will be recalculated even if this was
+ // disallowed by SetMustNotResize.
+ // - If nDelay > 0 the calculation is delayed accordingly. Resizing calls
+ // occuring during delay-time are ignored, but the delay may be counted
+ // under certain circumstances.
+ // - If nDelay == HTMLTABLE_RESIZE_NOW, resize immediately and do not
+ // consider any resize-calls that might possibly be in order.
+ // - The return value indicates whether the table has been changed.
BOOL Resize( USHORT nAbsAvail, BOOL bRecalc=FALSE, BOOL bForce=FALSE,
ULONG nDelay=0 );
void BordersChanged( USHORT nAbsAvail, BOOL bRecalc=FALSE );
- // Ermitteln der verfuegbaren Breite. Das geht nur, wenn ein Layout
- // oder eine ViewShell vorhanden ist. Sonst wird 0 zurueckgegeben.
- // (Wird vom HTML-Filter benoetigt, da der nicht an das Layout kommt.)
+ // Calculate available width. This works only if a layout or a
+ // ViewShell exists. Otherwise returns 0.
+ // This is needed by HTML-filter because it doesn't have access to the layout.)
static USHORT GetBrowseWidth( const SwDoc& rDoc );
- // Ermitteln der verfuegbaren Breite uber den Tabellen-Frame
+ // Calculates available width by table-frame.
USHORT GetBrowseWidthByTabFrm( const SwTabFrm& rTabFrm ) const;
- // Ermitteln der verfuegbaren Breite uber den Tabellen-Frame oder
- // das statische GetBrowseWidth, wenn kein Layout existiert.
+ // Calculates available width by the table-frame or
+ // static GetBrowseWidth if no layout exists.
USHORT GetBrowseWidthByTable( const SwDoc& rDoc ) const;
- // Fuer Export
+ // For Export.
USHORT GetWidthOption() const { return nWidthOption; }
BOOL HasPrcWidthOption() const { return bPrcWidthOption; }
More information about the Libreoffice-commits
mailing list