From 6e7ec40523fa4822ff5f66ad112ffcea6e823b3a Mon Sep 17 00:00:00 2001 From: Urs Fässler Date: Tue, 19 Mar 2013 22:24:19 +0100 Subject: translation and cleanup of comments in sd/source/ui/view/ Change-Id: I988c0545600185c6b09131d27fb8480efddd947f --- sd/source/ui/view/sdwindow.cxx | 334 +++++++++++++---------------------------- 1 file changed, 102 insertions(+), 232 deletions(-) (limited to 'sd/source/ui/view/sdwindow.cxx') diff --git a/sd/source/ui/view/sdwindow.cxx b/sd/source/ui/view/sdwindow.cxx index 3872bb56b9ea..4967cfea64de 100644 --- a/sd/source/ui/view/sdwindow.cxx +++ b/sd/source/ui/view/sdwindow.cxx @@ -41,27 +41,22 @@ namespace sd { -#define SCROLL_LINE_FACT 0.05 // Faktor fuer Zeilenscrolling -#define SCROLL_PAGE_FACT 0.5 // Faktor fuer Seitenscrolling -#define SCROLL_SENSITIVE 20 // Sensitiver Bereich (Pixel) -#define ZOOM_MULTIPLICATOR 10000 // Multiplikator um Rundungsfehler zu vermeiden -#define MIN_ZOOM 5 // Minimaler Zoomfaktor -#define MAX_ZOOM 3000 // Maximaler Zoomfaktor +#define SCROLL_LINE_FACT 0.05 ///< factor for line scrolling +#define SCROLL_PAGE_FACT 0.5 ///< factor for page scrolling +#define SCROLL_SENSITIVE 20 ///< sensitive area in pixel +#define ZOOM_MULTIPLICATOR 10000 ///< multiplier to avoid rounding errors +#define MIN_ZOOM 5 ///< minimal zoom factor +#define MAX_ZOOM 3000 ///< maximal zoom factor -/************************************************************************* -|* -|* Konstruktor -|* -\************************************************************************/ Window::Window(::Window* pParent) : ::Window(pParent, WinBits(WB_CLIPCHILDREN | WB_DIALOGCONTROL)), DropTargetHelper( this ), mpShareWin(NULL), - maWinPos(0, 0), // vorsichtshalber; die Werte sollten aber - maViewOrigin(0, 0), // vom Besitzer des Fensters neu gesetzt - maViewSize(1000, 1000), // werden + maWinPos(0, 0), // precautionary; but the values should be set + maViewOrigin(0, 0), // again from the owner of the window + maViewSize(1000, 1000), maPrevSize(-1,-1), mnMinZoom(MIN_ZOOM), mnMaxZoom(MAX_ZOOM), @@ -79,7 +74,7 @@ Window::Window(::Window* pParent) aMap.SetMapUnit(MAP_100TH_MM); SetMapMode(aMap); - // Damit im Diamodus die ::WindowColor genommen wird + // whit it, the ::WindowColor is used in the slide mode SetBackground( Wallpaper( GetSettings().GetStyleSettings().GetWindowColor() ) ); // adjust contrast mode initially @@ -88,7 +83,7 @@ Window::Window(::Window* pParent) ? ViewShell::OUTPUT_DRAWMODE_CONTRAST : ViewShell::OUTPUT_DRAWMODE_COLOR ); - // Hilfe-ID setzen + // set Help ID // SetHelpId(HID_SD_WIN_DOCUMENT); SetUniqueId(HID_SD_WIN_DOCUMENT); @@ -96,11 +91,6 @@ Window::Window(::Window* pParent) EnableRTL(sal_False); } -/************************************************************************* -|* -|* Destruktor -|* -\************************************************************************/ Window::~Window (void) { @@ -232,11 +222,6 @@ long Window::GetZoom (void) const -/************************************************************************* -|* -|* Resize event -|* -\************************************************************************/ void Window::Resize() { @@ -247,11 +232,6 @@ void Window::Resize() mpViewShell->GetViewFrame()->GetBindings().Invalidate( SID_ATTR_ZOOMSLIDER ); } -/************************************************************************* -|* -|* PrePaint event -|* -\************************************************************************/ void Window::PrePaint() { @@ -259,11 +239,6 @@ void Window::PrePaint() mpViewShell->PrePaint(); } -/************************************************************************* -|* -|* Paint event -|* -\************************************************************************/ void Window::Paint(const Rectangle& rRect) { @@ -271,11 +246,6 @@ void Window::Paint(const Rectangle& rRect) mpViewShell->Paint(rRect, this); } -/************************************************************************* -|* -|* Keyboard event -|* -\************************************************************************/ void Window::KeyInput(const KeyEvent& rKEvt) { @@ -292,11 +262,6 @@ void Window::KeyInput(const KeyEvent& rKEvt) } } -/************************************************************************* -|* -|* MouseButtonDown event -|* -\************************************************************************/ void Window::MouseButtonDown(const MouseEvent& rMEvt) { @@ -304,11 +269,6 @@ void Window::MouseButtonDown(const MouseEvent& rMEvt) mpViewShell->MouseButtonDown(rMEvt, this); } -/************************************************************************* -|* -|* MouseMove event -|* -\************************************************************************/ void Window::MouseMove(const MouseEvent& rMEvt) { @@ -316,11 +276,6 @@ void Window::MouseMove(const MouseEvent& rMEvt) mpViewShell->MouseMove(rMEvt, this); } -/************************************************************************* -|* -|* MouseButtonUp event -|* -\************************************************************************/ void Window::MouseButtonUp(const MouseEvent& rMEvt) { @@ -330,11 +285,6 @@ void Window::MouseButtonUp(const MouseEvent& rMEvt) mpViewShell->MouseButtonUp(rMEvt, this); } -/************************************************************************* -|* -|* Command event -|* -\************************************************************************/ void Window::Command(const CommandEvent& rCEvt) { @@ -342,6 +292,7 @@ void Window::Command(const CommandEvent& rCEvt) mpViewShell->Command(rCEvt, this); } + long Window::Notify( NotifyEvent& rNEvt ) { long nResult = sal_False; @@ -356,12 +307,6 @@ long Window::Notify( NotifyEvent& rNEvt ) } -/************************************************************************* -|* -|* RequestHelp event -|* -\************************************************************************/ - void Window::RequestHelp(const HelpEvent& rEvt) { if ( mpViewShell ) @@ -400,36 +345,26 @@ Size Window::GetViewSize (void) const -/************************************************************************* -|* -|* Position der linken oberen Ecke des im Fenster sichtbaren Bereichs -|* setzen -|* -\************************************************************************/ - +/** + * Set the position of the upper left corner from the visible area of the + * window. + */ void Window::SetWinViewPos(const Point& rPnt) { maWinPos = rPnt; } -/************************************************************************* -|* -|* Ursprung der Darstellung in Bezug zur gesamten Arbeitsflaeche setzen -|* -\************************************************************************/ - +/** + * Set origin of the representation in respect to the whole working area. + */ void Window::SetViewOrigin(const Point& rPnt) { maViewOrigin = rPnt; } -/************************************************************************* -|* -|* Groesse der gesamten Arbeitsflaeche, die mit dem Fenster betrachtet -|* werden kann, setzen -|* -\************************************************************************/ - +/** + * Set size of the whole working area which can be seen with the window. + */ void Window::SetViewSize(const Size& rSize) { maViewSize = rSize; @@ -651,14 +586,11 @@ void Window::SetMinZoomAutoCalc (bool bAuto) -/************************************************************************* -|* -|* Neuen MapMode-Origin berechnen und setzen; wenn aWinPos.X()/Y() -|* gleich -1 ist, wird die entsprechende Position zentriert -|* (z.B. fuer Initialisierung) -|* -\************************************************************************/ - +/** + * Calculate and set new MapMode origin. + * If aWinPos.X()/Y() == -1, then we center the corresponding position (e.g. for + * initialization). + */ void Window::UpdateMapOrigin(sal_Bool bInvalidate) { sal_Bool bChanged = sal_False; @@ -713,15 +645,15 @@ void Window::UpdateMapMode (void) maWinPos -= maViewOrigin; Size aPix(maWinPos.X(), maWinPos.Y()); aPix = LogicToPixel(aPix); - // Groesse muss vielfaches von BRUSH_SIZE sein, damit Muster - // richtig dargestellt werden + // Size has to be a multiple of BRUSH_SIZE due to the correct depiction of + // pattern // #i2237# // removed old stuff here which still forced zoom to be // %BRUSH_SIZE which is outdated now if (mpViewShell && mpViewShell->ISA(DrawViewShell)) { - // Seite soll nicht am Fensterrand "kleben" + // page should not "stick" to the window border if (aPix.Width() == 0) { // #i2237# @@ -752,38 +684,28 @@ void Window::UpdateMapMode (void) -/************************************************************************* -|* -|* X-Position des sichtbaren Bereichs als Bruchteil (< 1) -|* der gesamten Arbeitsbereichbreite zuruegeben -|* -\************************************************************************/ - +/** + * @returns X position of the visible area as fraction (< 1) of the whole + * working area. + */ double Window::GetVisibleX() { return ((double) maWinPos.X() / maViewSize.Width()); } -/************************************************************************* -|* -|* Y-Position des sichtbaren Bereichs als Bruchteil (< 1) -|* der gesamten Arbeitsbereichhoehe zuruegeben -|* -\************************************************************************/ - +/** + * @returns Y position of the visible area as fraction (< 1) of the whole + * working area. + */ double Window::GetVisibleY() { return ((double) maWinPos.Y() / maViewSize.Height()); } -/************************************************************************* -|* -|* X- und Y-Position des sichtbaren Bereichs als Bruchteile (< 1) -|* der gesamten Arbeitsbereichgroesse setzen -|* negative Werte werden ignoriert -|* -\************************************************************************/ - +/** + * Set x and y position of the visible area as fraction (< 1) of the whole + * working area. Negative values are ignored. + */ void Window::SetVisibleXY(double fX, double fY) { long nOldX = maWinPos.X(); @@ -798,13 +720,10 @@ void Window::SetVisibleXY(double fX, double fY) Update(); } -/************************************************************************* -|* -|* Breite des sichtbaren Bereichs im Verhaeltnis zur -|* gesamten Arbeitsbereichbreite zuruegeben -|* -\************************************************************************/ - +/** + * @returns width of the visible area in proportion to the width of the whole + * working area. + */ double Window::GetVisibleWidth() { Size aWinSize = PixelToLogic(GetOutputSizePixel()); @@ -813,13 +732,10 @@ double Window::GetVisibleWidth() return ((double) aWinSize.Width() / maViewSize.Width()); } -/************************************************************************* -|* -|* Hoehe des sichtbaren Bereichs im Verhaeltnis zur -|* gesamten Arbeitsbereichhoehe zuruegeben -|* -\************************************************************************/ - +/** + * @returns height of the visible area in proportion to the height of the whole + * working area. + */ double Window::GetVisibleHeight() { Size aWinSize = PixelToLogic(GetOutputSizePixel()); @@ -828,72 +744,54 @@ double Window::GetVisibleHeight() return ((double) aWinSize.Height() / maViewSize.Height()); } -/************************************************************************* -|* -|* Breite einer Scrollspalte im Verhaeltnis zur gesamten -|* Arbeitsbereichbreite zuruegeben -|* -\************************************************************************/ - +/** + * @returns width of a scroll column in proportion to the width of the whole + * working area. + */ double Window::GetScrlLineWidth() { return (GetVisibleWidth() * SCROLL_LINE_FACT); } -/************************************************************************* -|* -|* Breite einer Scrollspalte im Verhaeltnis zur gesamten -|* Arbeitsbereichhoehe zuruegeben -|* -\************************************************************************/ - +/** + * @returns height of a scroll column in proportion to the height of the whole + * working area. + */ double Window::GetScrlLineHeight() { return (GetVisibleHeight() * SCROLL_LINE_FACT); } -/************************************************************************* -|* -|* Breite einer Scrollpage im Verhaeltnis zur gesamten -|* Arbeitsbereichbreite zuruegeben -|* -\************************************************************************/ - +/** + * @returns width of a scroll page in proportion to the width of the whole + * working area. + */ double Window::GetScrlPageWidth() { return (GetVisibleWidth() * SCROLL_PAGE_FACT); } -/************************************************************************* -|* -|* Breite einer Scrollpage im Verhaeltnis zur gesamten -|* Arbeitsbereichhoehe zuruegeben -|* -\************************************************************************/ - +/** + * @returns height of a scroll page in proportion to the height of the whole + * working area. + */ double Window::GetScrlPageHeight() { return (GetVisibleHeight() * SCROLL_PAGE_FACT); } -/************************************************************************* -|* -|* Fenster deaktivieren -|* -\************************************************************************/ - +/** + * Deactivate window. + */ void Window::LoseFocus() { mnTicks = 0; ::Window::LoseFocus (); } -/************************************************************************* -|* -|* Fenster aktivieren -|* -\************************************************************************/ - +/** + * Activate window. + */ void Window::GrabFocus() { mnTicks = 0; @@ -901,19 +799,14 @@ void Window::GrabFocus() } -/************************************************************************* -|* -|* DataChanged -|* -\************************************************************************/ void Window::DataChanged( const DataChangedEvent& rDCEvt ) { ::Window::DataChanged( rDCEvt ); - // PRINTER bei allen Dokumenten weglassen, die keinen Printer benutzen. - // FONTS und FONTSUBSTITUTION weglassen, wenn keine Textausgaben - // vorhanden sind, bzw. wenn das Dokument keinen Text zulaesst. + /* Omit PRINTER by all documents which are not using a printer. + Omit FONTS and FONTSUBSTITUTION if no text output is available or if the + document does not allow text. */ if ( (rDCEvt.GetType() == DATACHANGED_PRINTER) || (rDCEvt.GetType() == DATACHANGED_DISPLAY) || @@ -935,16 +828,15 @@ void Window::DataChanged( const DataChangedEvent& rDCEvt ) mpViewShell->GetViewFrame()->GetDispatcher()-> Execute(SID_SIZE_PAGE, SFX_CALLMODE_ASYNCHRON | SFX_CALLMODE_RECORD); - // ScrollBars neu anordnen bzw. Resize ausloesen, da sich - // ScrollBar-Groesse geaendert haben kann. Dazu muss dann im - // Resize-Handler aber auch die Groesse der ScrollBars aus - // den Settings abgefragt werden. + /* Rearrange or initiate Resize for scroll bars since the size of + the scroll bars my have changed. Within this, inside the resize- + handler, the size of the scroll bars will be asked from the + Settings. */ Resize(); - // Daten neu Setzen, die aus den Systemeinstellungen bzw. aus - // den Settings uebernommen werden. Evtl. weitere Daten neu - // berechnen, da sich auch die Aufloesung hierdurch geaendert - // haben kann. + /* Re-set data, which are from system control or from Settings. May + have to re-set more data since the resolution may also has + changed. */ if( mpViewShell ) { const StyleSettings& rStyleSettings = GetSettings().GetStyleSettings(); @@ -994,34 +886,29 @@ void Window::DataChanged( const DataChangedEvent& rDCEvt ) ((rDCEvt.GetType() == DATACHANGED_SETTINGS) && (rDCEvt.GetFlags() & SETTINGS_STYLE)) ) { - // Virtuelle Device die auch von der Aufloesung oder von - // Systemeinstellungen abhaengen, sollten geupdatet werden. - // Ansonsten sollte zumindest bei DATACHANGED_DISPLAY - // die virtuellen Devices geupdatet werden, da es einige - // Systeme erlauben die Aufloesung und Farbtiefe waehrend - // der Laufzeit zu aendern oder eben bei Palettenaenderungen - // die virtuellen Device geupdatet werden muessen, da bei - // Ausgaben ein anderes Farbmatching stattfinden kann. + /* Virtual devices, which also depends on the resolution or the + system control, should be updated. Otherwise, we should update + the virtual devices at least at DATACHANGED_DISPLAY since some + systems allow to change the resolution and color depth during + runtime. Or the virtual devices have to be updated when the color + palette has changed since a different color matching can be used + when outputting. */ } if ( rDCEvt.GetType() == DATACHANGED_FONTS ) { - // Wenn das Dokument Font-AuswahlBoxen anbietet, muessen - // diese geupdatet werden. Wie dies genau aussehen muss, - // weiss ich leider auch nicht. Aber evtl. kann man das - // ja global handeln. Dies muessten wir evtl. mal - // mit PB absprechen, aber der ist derzeit leider Krank. - // Also bevor dies hier gehandelt wird, vorher mit - // PB und mir absprechen. + /* If the document provides font choose boxes, we have to update + them. I don't know how this looks like (also not really me, I + only translated the comment ;). We may can handle it global. We + have to discuss it with PB, but he is ill at the moment. + Before we handle it here, discuss it with PB and me. */ } if ( (rDCEvt.GetType() == DATACHANGED_FONTS) || (rDCEvt.GetType() == DATACHANGED_FONTSUBSTITUTION) ) { - // Formatierung neu durchfuehren, da Fonts die im Dokument - // vorkommen, nicht mehr vorhanden sein muessen oder - // jetzt vorhanden sind oder durch andere ersetzt wurden - // sind. + /* Do reformating since the fonts of the document may no longer + exist, or exist now, or are replaced with others. */ if( mpViewShell ) { DrawDocShell* pDocSh = mpViewShell->GetDocSh(); @@ -1032,13 +919,11 @@ void Window::DataChanged( const DataChangedEvent& rDCEvt ) if ( rDCEvt.GetType() == DATACHANGED_PRINTER ) { - // Wie hier die Behandlung aussehen soll, weiss ich leider - // selbst noch nicht. Evtl. mal einen Printer loeschen und - // schauen was gemacht werden muss. Evtl. muesste ich in - // VCL dafuer noch etwas einbauen, wenn der benutze Printer - // geloescht wird. Ansonsten wuerde ich hier evtl. die - // Formatierung neu berechnen, wenn der aktuelle Drucker - // zerstoert wurde. + /* I don't know how the handling should look like. Maybe we delete a + printer and look what we have to do. Maybe I have to add + something to the VCL, in case the used printer is deleted. + Otherwise I may recalculate the formatting here if the current + printer is destroyed. */ if( mpViewShell ) { DrawDocShell* pDocSh = mpViewShell->GetDocSh(); @@ -1047,7 +932,7 @@ void Window::DataChanged( const DataChangedEvent& rDCEvt ) } } - // Alles neu ausgeben + // Update everything Invalidate(); } } @@ -1055,11 +940,6 @@ void Window::DataChanged( const DataChangedEvent& rDCEvt ) -/************************************************************************* -|* -|* DropTargetHelper::AcceptDrop -|* -\************************************************************************/ sal_Int8 Window::AcceptDrop( const AcceptDropEvent& rEvt ) { @@ -1077,11 +957,6 @@ sal_Int8 Window::AcceptDrop( const AcceptDropEvent& rEvt ) return nRet; } -/************************************************************************* -|* -|* DropTargetHelper::ExecuteDrop -|* -\************************************************************************/ sal_Int8 Window::ExecuteDrop( const ExecuteDropEvent& rEvt ) { @@ -1106,11 +981,6 @@ void Window::SetUseDropScroll (bool bUseDropScroll) -/************************************************************************* -|* -|* Scrolling bei AcceptDrop-Events -|* -\************************************************************************/ void Window::DropScroll(const Point& rMousePos) { -- cgit