mir/libreoffice
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fdo#39468 translate German comments

Browse Source 
Change-Id: I87ba3ac7aabbb297785eff5da6a5d498fdefd80c
Reviewed-on: https://gerrit.libreoffice.org/13534
Reviewed-by: Noel Grandin <noelgrandin@gmail.com>
Tested-by: Noel Grandin <noelgrandin@gmail.com>
This commit is contained in:
Michael Weghorn
2014-12-18 23:48:12 +01:00
committed by Noel Grandin
parent 2116f1cfb3
commit a3181adc11
1 changed files with 148 additions and 152 deletions
Download Patch File Download Diff File Expand all files Collapse all files

300
include/svtools/ruler.hxx
View File

@@ -257,223 +257,219 @@ it has been dragged. There are the following query methods:
relative to the set zero-offset. relative to the set zero-offset.
- GetDragAryPos() - GetDragAryPos()
Liefert den Index im Array zurueck, wenn ein Border, Indent oder ein Returns the index in the array if a border, an indent or a tab
Tab gedragt wird. Achtung: Es wird die Array-Position waehrend des is being dragged. Attention: During a drag process, the array position
gesammten Drag-Vorgangs von dem Item im Array was vor dem Drag gesetzt of the item that has been set before the drag is returned.
war zurueckgeben. Dadurch ist es zum Beispiel auch moeglich, einen Therefore, it is for example also possible, to no longer show a tab
Tab nicht mehr anzuzeigen, wenn die Maus nach unten/rechts aus dem if the mouse is dragged out of the ruler in bottom/right direction.
Lineal gezogen wird.
- GetDragSize() - GetDragSize()
Wenn Borders gedragt werden, kann hierueber abgefragt werden, ob If Borders are dragged, this can be used to query whether the size
die Groesse bzw. welche Seite oder die Position geaendert werden soll. resp. which side or the position should be changed.
RULER_DRAGSIZE_MOVE oder 0 - Move RULER_DRAGSIZE_MOVE oder 0 - Move
RULER_DRAGSIZE_1 - Linke/obere Kante RULER_DRAGSIZE_1 - left/upper border
RULER_DRAGSIZE_2 - Rechte/untere Kante RULER_DRAGSIZE_2 - right/bottom border
- IsDragDelete() - IsDragDelete()
Mit dieser Methode kann abgefragt werden, ob beim Draggen die This method can be used to query whether the mouse has been
Maus unten/rechts aus dem Fenster gezogen wurde. Damit kann moved out of the window at the bottom/right while dragging.
zum Beispiel festgestellt werden, ob der Benutzer einen Tab By this, it can for example be determined whether the user
loeschen will. wants to delete a tab.
- IsDragCanceled() - IsDragCanceled()
Mit dieser Methode kann im EndDrag-Handler abgefragt werden, Using this Handler, it can be queried in the EndDrag handler
ob die Aktion abgebrochen wurde, indem der Anwender die whether the action was canceled by the user releasing the
Maus oben/links vom Fenster losgelassen hat oder ESC gedrueckt mouse at the top/left of the window or by pressing ESC.
hat. In diesem Fall werden die Werte nicht uebernommen. Wird In this case, the values are not applied. If during the
waehrend des Draggings die Maus oben/links aus dem Fenster dragging, the mouse is dragged out of the window at the
gezogen, werden automatisch die alten Werte dargestellt, ohne das top/left, the old values are displayed automatically without
der Drag-Handler gerufen wird. the Drag handler being called.
Falls der Benutzer jedoch den Wert auf die alte Position But if the user has moved the value to the old position, the
zurueckgeschoben hat, liefert die Methode trotzdem sal_False. Falls method returns 'false' nevertheless.
dies vermieden werden soll, muss sich die Applikation im StartDrag- If this should be avoided, the application must remember the
Handler den alten Wert merken und im EndDrag-Handler den Wert old value in the StartDrag handler and compare the value in the
vergleichen. EndDrag handler.
- GetDragScroll() - GetDragScroll()
Mit dieser Methode kann abgefragt werden, ob gescrollt werden This method can be used to query whether scrolling should
soll. Es wird einer der folgenden Werte zurueckgegeben: take place. One of the following values is returned:
RULER_SCROLL_NO - Drag-Position befindet sich RULER_SCROLL_NO - Drag position is at no border and
an keinem Rand und somit therefore no scrolling needs to
muss nicht gescrollt werden. take place.
RULER_SCROLL_1 - Drag-Position befindet sich RULER_SCROLL_1 - Drag position is at the left/upper
am linken/oberen Rand und border and therefore the
somit sollte das Programm evt. application should possibly trigger
ein Srcoll ausloesen. scrolling.
RULER_SCROLL_2 - Drag-Position befindet sich RULER_SCROLL_2 - Drag position is at the right/bottom
am rechten/unteren Rand und border and therefore the
somit sollte das Programm evt. application should possibly trigger
ein Srcoll ausloesen. scrolling.
- GetDragModifier() - GetDragModifier()
Liefert die Modifier-Tasten zurueck, die beim Starten des Drag- Returns the modifier keys that were pressed when the Drag process
Vorgangs gedrueckt waren. Siehe MouseEvent. was started. See MouseEvent.
- GetClickPos() - GetClickPos()
Liefert die Pixel-Position bezogen auf den eingestellten Null-Offset Returns the pixel position at which the user has pressed the mouse
zurueck, wo der Anwender die Maus gedrueckt hat. with respect to the configured null-offset.
- GetClickType() - GetClickType()
Liefert zurueck, was per DoubleClick betaetigt wird: Returns what is applied by double click:
RULER_TYPE_DONTKNOW (kein Element im Linealbereich) RULER_TYPE_DONTKNOW (no element in the ruler area)
RULER_TYPE_OUTSIDE (ausserhalb des Linealbereichs) RULER_TYPE_OUTSIDE (outside of the ruler area)
RULER_TYPE_MARGIN1 (nur Margin1-Kante) RULER_TYPE_MARGIN1 (only Margin1 border)
RULER_TYPE_MARGIN2 (nur Margin2-Kante) RULER_TYPE_MARGIN2 (only Margin2 border)
RULER_TYPE_BORDER (Border: GetClickAryPos()) RULER_TYPE_BORDER (Border: GetClickAryPos())
RULER_TYPE_INDENT (Einzug: GetClickAryPos()) RULER_TYPE_INDENT (indent: GetClickAryPos())
RULER_TYPE_TAB (Tab: GetClickAryPos()) RULER_TYPE_TAB (Tab: GetClickAryPos())
- GetClickAryPos() - GetClickAryPos()
Liefert den Index im Array zurueck, wenn ein Border, Indent oder ein Returns the index in the array if a Border, an Indent or a Tab
Tab per DoubleClick betaetigt wird. is applied via DoubleClick.
- GetType() - GetType()
Mit dieser Methode kann man einen HitTest durchfuehren, um This method can be used to carry out a HitTest,
gegebenenfalls ueber das Abfangen des MouseButtonDown-Handlers in order to possibly also apply sth to an Item using the right
auch ueber die rechte Maustaste etwas auf ein Item anzuwenden. Als mouse button by catching the MouseButtonDown handler. As
Paramter ueber gibt man die Fensterposition und gegebenenfalls parameters, the window position and possibly a pointer to a
einen Pointer auf einen sal_uInt16, um die Array-Position eines sal_uInt16 are passed, in order to determine the array position
Tabs, Indent oder Borders mitzubekommen. Als Type werden folgende of a Tab, an Indent, or a Border. The following values are
Werte zurueckgegeben: returned as type:
RULER_TYPE_DONTKNOW (kein Element im Linealbereich) RULER_TYPE_DONTKNOW (no element in the ruler area)
RULER_TYPE_OUTSIDE (ausserhalb des Linealbereichs) RULER_TYPE_OUTSIDE (outside of the ruler area)
RULER_TYPE_MARGIN1 (nur Margin1-Kante) RULER_TYPE_MARGIN1 (only Margin1 border)
RULER_TYPE_MARGIN2 (nur Margin2-Kante) RULER_TYPE_MARGIN2 (only Margin2 border)
RULER_TYPE_BORDER (Border: GetClickAryPos()) RULER_TYPE_BORDER (Border: GetClickAryPos())
RULER_TYPE_INDENT (Einzug: GetClickAryPos()) RULER_TYPE_INDENT (indent: GetClickAryPos())
RULER_TYPE_TAB (Tab: GetClickAryPos()) RULER_TYPE_TAB (Tab: GetClickAryPos())
Wenn der Drag-Vorgang abgebrochen werden soll, kann der Drag-Vorgang If the drag process should be canceled, this can be done using CancelDrag().
mit CancelDrag() abgebrochen werden. Folgende Methoden gibt es fuer die There are the following methods for controlling the Drag:
Drag-Steuerung:
- IsDrag() - IsDrag()
Liefert sal_True zurueck, wenn sich das Lineal im Drag-Vorgang befindet. Returns 'true' if the ruler is in a drag process.
- CancelDrag() - CancelDrag()
Bricht den Drag-Vorgang ab, falls einer durchgefuehrt wird. Dabei Cancels the drag process, if one is being carried out. During this,
werden die alten Werte wieder hergestellt und der Drag und der the old values are restored and the Drag and the EndDrag handlers
EndDrag-Handler gerufen. are called.
Um vom Dokument ein Drag auszuloesen, gibt es folgende Methoden: In order to trigger a Drag from the document, there are the following
methods:
- StartDocDrag() - StartDocDrag()
Dieser Methode werden der MouseEvent vom Dokumentfenster und This method is passed the MouseEvent of the document window
was gedragt werden soll uebergeben. Wenn als DragType and what should be dragged. If RULER_TYPE_DONTKNOW is passed
RULER_TYPE_DONTKNOW uebergeben wird, bestimmt das Lineal, was as DragType, the ruler decides what should be dragged. In case
verschoben werden soll. Bei den anderen, wird der Drag nur dann of the other types, the Drag is only started if a respective
gestartet, wenn auch an der uebergebenen Position ein entsprechendes element was found at the given position.
Element gefunden wurde. Dies ist zun Beispiel dann notwendig, wenn This is for example necessary if indents and columns are located
zum Beispiel Einzuege und Spalten an der gleichen X-Position liegen. at the same X position.
Der Rueckgabewert gibt an, ob der Drag ausgeloest wurde. Wenn ein The return value indicates whether the Drag has been triggered.
Drag ausgeloest wird, uebernimmt das Lineal die normale Drag-Steuerung If a Drag is triggered, the ruler takes over the normal drag
und verhaelt sich dann so, wie als wenn direkt in das Lineal geklickt control and behaves as if the ruler had been clicked directly.
wurde. So captured das Lineal die Mouse und uebernimmt auch die Thus, the ruler captures the mouse and also takes over control
Steuerung des Cancel (ueber Tastatur, oder wenn die Mouse ueber of the Cancel (via keyboard, or if the mouse is moved outside
oder links vom Lineal ruasgeschoben wird). Auch alle Handler werden of the ruler above it or left of it). All handlers are called,
gerufen (inkl. des StartDrag-Handlers). Wenn ein MouseEvent mit too (including the StartDrag handler). If a MouseEvent with
Click-Count 2 uebergeben wird auch der DoubleClick-Handler ClickCount 2 is passed, the DoubleClick handler is also called,
entsprechend gerufen. respectively.
-------------------------------------------------------------------------- --------------------------------------------------------------------------
Fuer das Extra-Feld kann der Inhalt bestimmt werden und es gibt Handler, For the extra field, the content can be determined and there are handlers
womit man bestimmte Aktionen abfangen kann. that can be used to handle specific actions.
- ExtraDown() - ExtraDown()
Dieser Handler wird gerufen, wenn im Extra-Feld die Maus This handler is called when the mouse is pressed in the extra field.
gedrueckt wird.
- SetExtraType() - SetExtraType()
Mit dieser Methode kann festgelegt werden, was im ExtraFeld With this method, it can be defined what should be displayed in
dargestellt werden soll. the extra field.
- ExtraType Was im Extrafeld dargestellt werden soll - ExtraType what should be displayed in the extra field
RULER_EXTRA_DONTKNOW (Nichts) RULER_EXTRA_DONTKNOW (nothing)
RULER_EXTRA_NULLOFFSET (Koordinaaten-Kreuz) RULER_EXTRA_NULLOFFSET (coordinate axes)
RULER_EXTRA_TAB (Tab) RULER_EXTRA_TAB (Tab)
- sal_uInt16 nStyle Bitfeld als Style: - sal_uInt16 nStyle bit field as style:
RULER_STYLE_HIGHLIGHT (selektiert) RULER_STYLE_HIGHLIGHT (selected)
RULER_TAB_... (ein Tab-Style) RULER_TAB_... (a Tab style)
- GetExtraClick() - GetExtraClick()
Liefert die Anzahl der Mausclicks zurueck. Dadurch ist es zum Returns the number of mouse clicks. By this, it is for example
Beispiel auch moeglich, auch durch einen DoubleClick im Extrafeld also possible to trigger an action by a DoubleClick in the
eine Aktion auszuloesen. extra field.
- GetExtraModifier() - GetExtraModifier()
Liefert die Modifier-Tasten zurueck, die beim Klicken in das Extra- Returns the modifier keys that were pressed when the extra field
Feld gedrueckt waren. Siehe MouseEvent. was clicked. See MouseEvent.
-------------------------------------------------------------------------- --------------------------------------------------------------------------
Weitere Hilfsfunktionen: Further helper functions:
- static Ruler::DrawTab() - static Ruler::DrawTab()
Mit dieser Methode kann ein Tab auf einem OutputDevice ausgegeben With this method, a Tab can be output on an OutputDevice.
werden. Dadurch ist es moeglich, auch in Dialogen die Tabs so By this, it is also possible to show the Tabs in dialogs like
anzuzeigen, wie Sie im Lineal gemalt werden. they are drawn in the ruler.
Diese Methode gibt den Tab zentriert an der uebergebenen Position This method outputs the Tab centred at the given position. The size
aus. Die Groesse der Tabs kann ueber die Defines RULER_TAB_WIDTH und of the tabs can be defined by the defines RULER_TAB_WIDTH and
RULER_TAB_HEIGHT bestimmt werden. RULER_TAB_HEIGHT.
-------------------------------------------------------------------------- --------------------------------------------------------------------------
Tips zur Benutzung des Lineals: Tips for the use of the ruler:
- Bei dem Lineal muss weder im Drag-Modus noch sonst das Setzen der Werte - For the ruler, neither in the Drag mode nor elsewhere, the setting
in SetUpdateMode() geklammert werden. Denn das Lineal sorgt von sich of the values must be bracketed in SetUpdateMode(). The ruler itself
aus dafuer, das wenn mehrere Werte gesetzt werden, diese automatisch takes care that, if multiple values are set, they are automatically
zusammengefast werden und flackerfrei ausgegeben werden. grouped together and output flicker-free.
- Initial sollten beim Lineal zuerst die Groessen, Positionen und Werte - Initially, the sizes, positions and values should be set first for the
gesetzt werden, bevor es angezeigt wird. Dies ist deshalb wichtig, da ruler, before it is displayed. This is important because otherwise
ansonsten viele Werte unnoetig berechnet werden. many values are calculated unnecessarily.
- Wenn das Dokumentfenster, in dem sich das Lineal befindet aktiv bzw. - When the document window, in which the ruler resides, becomes active
deaktiv wird, sollten die Methoden Activate() und Deactivate() vom resp. unactive, the methods Activate() and Deactivate() should be
Lineal gerufen werden. Denn je nach Einstellungen und System wird die called by the ruler. That is so because the display is switched according
Anzeige entsprechend umgeschaltet. to the settings and the system.
- Zum Beispiel sollte beim Drag von Tabs und Einzuegen nach Moeglichkeit die - For example, while dragging Tabs and Indents, the old positions should
alten Positionen noch mit angezeigt werden. Dazu sollte zusaetzlich beim also be shown if possible. For that, while setting the Tabs and Indents,
Setzen der Tabs und Einzuege als erstes im Array die alten Positionen the old positions should be inserted first into the array in addition
eingetragen werden und mit dem Style RULER_STYLE_DONTKNOW verknuepft and be linked with the style RULER_STYLE_DONTKNOW. After that, the
werden. Danach sollte im Array die restlichen Werte eingetragen werden. remaining values should be set in the array.
- Bei mehreren markierten Absaetzen und Tabellen-Zellen, sollten die Tabs - In case of multiple selected paragraphs and table cells, the Tabs and
und Einzuege in grau von der ersten Zelle, bzw. vom ersten Absatz Indents should be displayed in grey in front of the first cell resp.
angezeigt werden. Dies kann man auch ueber den Style RULER_STYLE_DONTKNOW the first paragraph. This can also be achieved by the style
erreichen. RULER_STYLE_DONTKNOW.
- Die Bemassungspfeile sollten immer dann angezeigt, wenn beim Drag die - The measuring arrow should always be shown when the Alt key (WW-Like)
Alt-Taste (WW-Like) gedrueckt wird. Vielleicht sollte diese Einstellung is pressed during the drag. Maybe, this setting should be configurable
auch immer vornehmbar sein und vielleicht beim Drag immer die always and possibly the measuring arrows always be shown while
Bemassungspfeile dargestellt werden. Bei allen Einstellung sollten die dragging. For all settings, the values should always be rounded to the
Werte immer auf ein vielfaches eines Wertes gerundet werden, da die multiple of one value because the screen resolution is very unprecise.
Bildschirmausloesung sehr ungenau ist.
- DoppelKlicks sollten folgendermassen behandelt werden (GetClickType()): - DoubleClicks should be handled in the following way (GetClickType()):
- RULER_TYPE_DONTKNOW - RULER_TYPE_DONTKNOW
RULER_TYPE_MARGIN1 RULER_TYPE_MARGIN1
RULER_TYPE_MARGIN2 RULER_TYPE_MARGIN2
Wenn die Bedingunden GetClickPos() <= GetMargin1() oder If the conditions GetClickPos() <= GetMargin1() or
GetClickPos() >= GetMargin2() oder der Type gleich GetClickPos() >= GetMargin2() are met or the type is equal to
RULER_TYPE_MARGIN1 oder RULER_TYPE_MARGIN2 ist, sollte RULER_TYPE_MARGIN1 or RULER_TYPE_MARGIN2, a side dialog should
ein SeitenDialog angezeigt werden, wo der Focus auf dem be displayed in which the focus is at the respective border.
entsprechenden Rand steht
- RULER_TYPE_BORDER - RULER_TYPE_BORDER
Es sollte ein Spalten- oder Tabellen-Dialog angezeigt werden, A column or table dialog should be shown in which the focus
wo der Focus auf der entsprechenden Spalte steht, die mit is at the respective column that can be queried using
GetClickAryPos() abgefragt werden kann. GetClickAryPos().
- RULER_TYPE_INDENT - RULER_TYPE_INDENT
Es sollte der Dialog angezeigt werden, wo die Einzuege eingestellt The dialog, in which the indents can be configured, should be
werden koennen. Dabei sollte der Focus auf dem Einzug stehen, der shown. In this, the focus should be on the indent which can
mit GetClickAryPos() ermittelt werden kann. be queried using GetClickAryPos().
- RULER_TYPE_TAB - RULER_TYPE_TAB
Es sollte ein TabDialog angezeigt werden, wo der Tab selektiert A TabDialog should be displayed in which the Tab, that can be
sein sollte, der ueber GetClickAryPos() abgefragt werden kann. queried using GetClickAryPos(), should be selected.
*************************************************************************/ *************************************************************************/