Hello,
this patch is LGPLv3+/MPL.
Greetings,
Tobias
>From e38102f749d242152d0ada7e50405d7833b5acb8 Mon Sep 17 00:00:00 2001
From: Tobias Rosenberger <s...@ich-habe-fertig.com>
Date: Tue, 8 Feb 2011 22:51:15 +0100
Subject: [PATCH] translated parts of German comment in svtools/inc/ruler.hxx
---
svtools/inc/ruler.hxx | 235 +++++++++++++++++++++++--------------------------
1 files changed, 110 insertions(+), 125 deletions(-)
diff --git a/svtools/inc/ruler.hxx b/svtools/inc/ruler.hxx
index 079954c..7581443 100644
--- a/svtools/inc/ruler.hxx
+++ b/svtools/inc/ruler.hxx
@@ -124,160 +124,145 @@ the values on the ruler. The following units are accepted:
--------------------------------------------------------------------------
-Mit SetMargin1() kann der linke/obere Rand und mit SetMargin2() kann
-der rechte/untere Rand gesetzt werden. Falls diese Methoden ohne Parameter
-aufgerufen werden, werden keine Raender angezeigt. Wenn SetMargin1() bzw.
-SetMargin2() mit Parametern aufgerufen werden, kann bei diesen
-folgendes angegeben werden:
-
- long nPos - Offset zum NullPunkt in Pixel
- USHORT nStyle - Bit-Style:
+SetMargin1() sets the upper/left margin and SetMargin2() sets the
+bottom/right margin. If these methods are called whithout arguments,
+no margins are displayed. Otherwise, the following arguments can be passed:
+
+ long nPos - offset in pixels relative to the origin
+ USHORT nStyle - bit style:
RULER_MARGIN_SIZEABLE
- Rand kann in der Groesse veraendert werden.
+ margin size can be changed
- Zu diesen Style's koennen folgende Style-
- Bits dazugeodert werden:
- RULER_STYLE_INVISIBLE (fuer nicht sichtbar)
+ The following bits can be set in addition
+ to these styles:
+ RULER_STYLE_INVISIBLE
-Mit SetBorders() kann ein Array von Raendern gesetzt werden. Dabei muss
-ein Array vom Typ RulerBorder uebergeben werden, wobei folgende Werte
-initialisiert werden muessen:
+SetBorders() sets an array of margins. To do this, an array of type RulerBorder
+has to be passed. In the array, the following values have to be initialized:
- long nPos - Offset zum NullPunkt in Pixel
- long nWidth - Breite des Spaltenabstands in Pixel (kann zum
- Beispiel fuer Tabellenspalten auch 0 sein)
- USHORT nStyle - Bit-Style:
+ long nPos - offset in pixels relative to the origin
+ long nWidth - column spacing in pixels (can also be 0, for example,
+ for table columns)
+ USHORT nStyle - bit style:
RULER_BORDER_SIZEABLE
- Spaltenabstand kann in der Groesse veraendert
- werden. Dieses Flag sollte nur gesetzt werden,
- wenn ein Abstand in der Groesse geaendert wird
- und nicht die Groesse einer Zelle.
+ Column spacing can be changed. This flag should
+ only be set if the size of the spacing is changed,
+ not that of a cell.
RULER_BORDER_MOVEABLE
- Spaltenabstand/Begrenzung kann verschoben
- werden. Wenn Tabellenbegrenzungen verschoben
- werden, sollte dieses Flag gesetzt werden und
- nicht Sizeable. Denn Sizeable gibt an, das
- ein Abstand vergroessert werden kann und nicht
- eine einzelne Zelle in der Groesse geaendert
- werden kann.
+ Column spacing/border can be moved. Whenever
+ table borders are to be moved, this flag should
+ be set instead of SIZEABLE (SIZEABLE indicates
+ that the size of a spacing, not that of a single
+ cell can be changed).
RULER_BORDER_VARIABLE
- Nicht alle Spaltenabstande sind gleich
+ Not all of the column spacings are equal
RULER_BORDER_TABLE
- Tabellenrahmen. Wenn dieser Style gesetzt
- wird, muss die Spaltenbreite 0 sein.
+ Table border. Whenever this style ist set, the column
+ width must be 0.
RULER_BORDER_SNAP
- Hilfslinie / Fanglinie. Wenn dieser Style
- gesetzt wird, muss die Spaltenbreite 0 sein.
+ Auxiliary line. Whenever this style is set, the
+ column width must be 0.
RULER_BORDER_MARGIN
- Margin. Wenn dieser Style gesetzt wird,
- muss die Spaltenbreite 0 sein.
-
- Zu diesen Style's koennen folgende Style-
- Bits dazugeodert werden:
- RULER_STYLE_INVISIBLE (fuer nicht sichtbar)
-
-Mit SetIndents() kann ein Array von Indents gesetzt werden. Diese Methode darf
-nur angewendet werden, wenn es sich um ein horizontales Lineal handelt. Als
-Parameter muss ein Array vom Typ RulerIndent uebergeben werden, wobei folgende
-Werte initialisiert werden muessen:
-
- long nPos - Offset zum NullPunkt in Pixel
- USHORT nStyle - Bit-Style:
- RULER_INDENT_TOP (Erstzeileneinzug)
- RULER_INDENT_BOTTOM (Linker/Rechter Einzug)
- RULER_INDENT_BORDER (Verical line that shows the border distance)
- Zu diesen Style's koennen folgende Style-
- Bits dazugeodert werden:
- RULER_STYLE_DONTKNOW (fuer alte Position oder
- fuer Uneindeutigkeit)
- RULER_STYLE_INVISIBLE (fuer nicht sichtbar)
-
-Mit SetTabs() kann ein Array von Tabs gesetzt werden. Diese Methode darf nur
-angewendet werden, wenn es sich um ein horizontales Lineal handelt. Als
-Parameter muss ein Array vom Typ RulerTab uebergeben werden, wobei folgende
-Werte initialisiert werden muessen:
-
- long nPos - Offset zum NullPunkt in Pixel
- USHORT nStyle - Bit-Style:
- RULER_TAB_DEFAULT (kann nicht selektiert werden)
+ Margin. Whenever this style is set, the column
+ width must be 0.
+
+ The following bits can be set in addition
+ to these styles:
+ RULER_STYLE_INVISIBLE
+
+SetIndents() sets an array of indents. This method may only be used for horizontal
+rulers. A Ruler Indent must be passed as an argument, with the following values
+initialized:
+
+ long nPos - offset relative to the origin in pixels
+ USHORT nStyle - bit style:
+ RULER_INDENT_TOP (indent of the first line)
+ RULER_INDENT_BOTTOM (left/right indent)
+ RULER_INDENT_BORDER (Vertical line that shows the border distance)
+ The following bits can be set in addition
+ to these styles:
+ RULER_STYLE_DONTKNOW (for old position or for
+ ambiguity)
+ RULER_STYLE_INVISIBLE
+
+SetTabs() sets an array of tabs. This method may only be used for horizontal rulers.
+An array of type RulerTab must be passed as an argument, with the following values
+initialized:
+
+ long nPos - offset relative to the origin in pixels
+ USHORT nStyle - bit style:
+ RULER_TAB_DEFAULT (can't be selected)
RULER_TAB_LEFT
RULER_TAB_CENTER
RULER_TAB_RIGHT
RULER_TAB_DECIMAL
- Zu diesen Style's koennen folgende Style-
- Bits dazugeodert werden:
- RULER_STYLE_DONTKNOW (fuer alte Position oder
- fuer Uneindeutigkeit)
- RULER_STYLE_INVISIBLE (fuer nicht sichtbar)
-
-Mit SetLines() koennen Positionslinien im Lineal angezeigt werden. Dabei
-muss ein Array vom Typ RulerLine uebergeben werden, wobei folgende Werte
-initialisiert werden muessen:
-
- long nPos - Offset zum NullPunkt in Pixel
- USHORT nStyle - Bit-Style (muss zur Zeit immer 0 sein)
-
-Mit SetArrows() koennen Bemassungspfeile im Lineal angezeigt werden. Wenn
-Bemassungspfeile gesetzt werden, werden im Lineal auch keine Unterteilungen
-mehr angezeigt. Deshalb sollten die Bemassungspfeile immer ueber die ganze
-Linealbreite gesetzt werden. Dabei muss ein Array vom Typ RulerArrow
-uebergeben werden, wobei folgende Werte initialisiert werden muessen:
-
- long nPos - Offset zum NullPunkt in Pixel
- long nWidth - Breite des Pfeils
- long nLogWidth - Breite des Pfeils in logischer Einheit
- USHORT nStyle - Bit-Style (muss zur Zeit immer 0 sein)
-
-Mit SetSourceUnit() wird die Einheit eingestellt, in welcher die logischen
-Werte vorliegen, die bei SetArrows() uebergeben werden. Dabei werden nur die
-Einheiten MAP_TWIP und MAP_100TH_MM (default) akzeptiert.
+ The following bits can be set in addition
+ to these styles:
+ RULER_STYLE_DONTKNOW (for old position of for
+ ambiguity)
+ RULER_STYLE_INVISIBLE
+
+SetLines() displays position lines in the ruler. An array of type RulerLine must be passed, with
+the following values initialized:
+
+ long nPos - offset relative to the origin in pixels
+ USHORT nStyle - bit style (has to be 0 currently)
+
+SetArrows() displays dimension arrows in the ruler. With dimension arrows set
+no subdivisions will be shown any more in the ruler. Therefore, dimension
+arrows should always be set along the whole ruler. An array of type RulerArrow
+must be passed with the following values initialized:
+
+ long nPos - offset relative to the origin in pixels
+ long nWidth - the arrow's width
+ long nLogWidth - the arrow's width in logical unit
+ USHORT nStyle - bit style (has to be 0 currently)
+
+SetSourceUnit() sets the unit in which the logical values are given that are
+passed to SetArrows(). The only units accepted are MAP_TWIP and MAP_100TH_MM.
--------------------------------------------------------------------------
-Wenn auch vom Benutzer die Raender, Tabs, Border, ... ueber das Lineal
-geaendert werden koennen, muss etwas mehr Aufwand getrieben werden. Dazu
-muessen die Methoden StartDrag(), Drag() und EndDrag() ueberlagert werden.
-Bei der Methode StartDrag() besteht die Moeglichkeit durch das zurueckgeben
-von FALSE das Draggen zu verhindern. Im Drag-Handler muss die Drag-Position
-abgefragt werden und die Werte muessen an die neue Position verschoben werden.
-Dazu ruft man einfach die einzelnen Set-Methoden auf. Solange man sich
-im Drag-Handler befindet, werden sich die Werte nur gemerkt und erst
-danach das Lineal neu ausgegeben. Alle Handler koennen auch als Links ueber
-entsprechende Set..Hdl()-Methoden gesetzt werden.
+If the user should also be able to change the margins tabs, borders, ...
+in the ruler, a bit more effort is necessary. In this case, the StartDrag(),
+Drag() and EndDrag() methods have to be overridden. For the StartDrag() method
+it is possible to prevent dragging by returning FALSE. In the drag handler,
+the drag position must be queried and the values must be moved to the new
+position. This is done by calling the particular Set methods. While in the
+drag handler, the values are just cached and only afterward the ruler is redrawn.
+All the handlers can also be set as links with the particular Set..Hdl() methods.
- StartDrag()
- Wird gerufen, wenn das Draggen gestartet wird. Wenn FALSE
- zurueckgegeben wird, wird das Draggen nicht ausgefuehrt. Bei TRUE
- wird das Draggen zugelassen. Wenn der Handler nicht ueberlagert
- wird, wird FALSE zurueckgegeben.
+ Is called when dragging is started. If FALSE is returned, the dragging.
+ won't be executed. If TRUE is returned, the dragging will be permitted.
+ If the handler isn't overridden, FALSE will be returned.
- EndDrag()
- Wird gerufen, wenn das Draggen beendet wird.
+ Is called at the end of dragging.
- Drag()
- Wird gerufen, wenn gedragt wird.
+ Is called when dragging takes place.
- Click()
- Dieser Handler wird gerufen, wenn kein Element angeklickt wurde.
- Die Position kann mit GetClickPos() abgefragt werden. Dadurch
- kann man zum Beispiel Tabs in das Lineal setzen. Nach Aufruf des
- Click-Handlers wird gegebenenfalls das Drag sofort ausgeloest. Dadurch
- ist es moeglich, einen neuen Tab im Click-Handler zu setzen und
- danach gleich zu verschieben.
+ This handler is called when no element has been clicked on.
+ The position can be queried with GetClickPos(). This way it is possible
+ to, for example, ser tabs in the ruler. After calling the click handler,
+ the drag, if any, is immediately triggered. This makes it possible to
+ set a new tab in the click handler and then immediately move it.
- DoubleClick()
- Dieser Handler wird gerufen, wenn ein DoubleClick ausserhalb des
- Extrafeldes gemacht wurde. Was angeklickt wurde, kann mit
- GetClickType(), GetClickAryPos() und GetClickPos() abgefragt werden.
- Somit kann man zum Beispiel den Tab-Dialog anzeigen, wenn ein
- Tab mit einem DoubleClick betaetigt wurde.
+ This handler is called when a double-click has been performed outside
+ the special panel. The methods GetClickType(), GetClickAryPos() and
+ GetClickPos() can be used to query what has been clicked on.
+ This way you can, for example, show the tab dialog when a double-click
+ is performed on a tab.
-Im Drag-Handler kann man abfragen, was und wohin gedragt wurde. Dazu gibt
-es folgende Abfrage-Methoden.
+In the drag handler it is possible to query what has been dragged and where
+it has been dragged. There are the following query methods:
- GetDragType()
- Liefert zurueck, was gedragt wird:
+ Returns what has been dragged.
RULER_TYPE_MARGIN1
RULER_TYPE_MARGIN2
RULER_TYPE_BORDER
@@ -285,8 +270,8 @@ es folgende Abfrage-Methoden.
RULER_TYPE_TAB
- GetDragPos()
- Liefert die Pixel-Position bezogen auf den eingestellten Null-Offset
- zurueck, wohin der Anwender die Maus bewegt hat.
+ Returns the pixel position to which the user has moved the mouse
+ relative to the set zero-offset.
- GetDragAryPos()
Liefert den Index im Array zurueck, wenn ein Border, Indent oder ein
--
1.7.1
_______________________________________________
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice
