Hello,
this patch is LGPLv3+/MPL.
Greetings,
Tobias
From e38102f749d242152d0ada7e50405d7833b5acb8 Mon Sep 17 00:00:00 2001
From: Tobias Rosenberger <son@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
Context
- [Libreoffice] translated parts of German comment in svtools/inc/ruler.hxx · Tobias Rosenberger
Privacy Policy |
Impressum (Legal Info) |
Copyright information: Unless otherwise specified, all text and images
on this website are licensed under the
Creative Commons Attribution-Share Alike 3.0 License.
This does not include the source code of LibreOffice, which is
licensed under the Mozilla Public License (
MPLv2).
"LibreOffice" and "The Document Foundation" are
registered trademarks of their corresponding registered owners or are
in actual use as trademarks in one or more countries. Their respective
logos and icons are also subject to international copyright laws. Use
thereof is explained in our
trademark policy.