|
|
|
/* This file is part of the KDE project
|
|
|
|
Copyright (C) 2001 Wilco Greven <greven@kde.org>
|
|
|
|
Copyright (C) 2004-2005 Wilfried Huss <Wilfried.Huss@gmx.at>
|
|
|
|
Copyright (C) 2005 Stefan Kebekus <kebekus@kde.org>
|
|
|
|
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
|
|
modify it under the terms of the GNU Library General Public
|
|
|
|
License as published by the Free Software Foundation; either
|
|
|
|
version 2 of the License, or (at your option) any later version.
|
|
|
|
|
|
|
|
This library is distributed in the hope that it will be useful,
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
Library General Public License for more details.
|
|
|
|
|
|
|
|
You should have received a copy of the GNU Library General Public License
|
|
|
|
along with this library; see the file COPYING.LIB. If not, write to
|
|
|
|
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
|
|
Boston, MA 02110-1301, USA.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef PAGEVIEW_H
|
|
|
|
#define PAGEVIEW_H
|
|
|
|
|
|
|
|
#include "documentWidget.h"
|
|
|
|
|
|
|
|
#include <tqptrvector.h>
|
|
|
|
#include <tqscrollview.h>
|
|
|
|
|
|
|
|
class PageNumber;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* PageView is a customized TQScrollView, which can hold one
|
|
|
|
* page. This page will be centered on the viewport.
|
|
|
|
*/
|
|
|
|
class PageView : public TQScrollView
|
|
|
|
{
|
|
|
|
TQ_OBJECT
|
|
|
|
|
|
|
|
|
|
|
|
public:
|
|
|
|
PageView( TQWidget* parent = 0, const char* name = 0 );
|
|
|
|
~PageView() {}
|
|
|
|
|
|
|
|
void addChild( TQPtrVector<DocumentWidget> *wdgList );
|
|
|
|
|
|
|
|
/** Sets the number of columns into which the widgets are
|
|
|
|
aligned. If nothing is set, '2' is the default. */
|
|
|
|
void setNrColumns( TQ_UINT8 cols );
|
|
|
|
void setNrRows( TQ_UINT8 rows );
|
|
|
|
|
|
|
|
void setContinuousViewMode(bool continuous);
|
|
|
|
bool fullScreenMode() { return fullScreen; }
|
|
|
|
bool singlePageFullScreenMode();
|
|
|
|
bool overviewMode() { return !continuousViewmode && (nrRows > 1 || nrCols > 1); }
|
|
|
|
|
|
|
|
/** Returns the number of columns into which the widgets are aligned.
|
|
|
|
|
|
|
|
This method returns the number of colums actually used to display
|
|
|
|
the widgets.
|
|
|
|
|
|
|
|
@warning This method need not return the number columns set in the
|
|
|
|
setViewMode() method. For instance, if the viewmode
|
|
|
|
KVSPrefs::EnumViewMode::ContinuousFacing is set, but there is only
|
|
|
|
one widget, then only one column is used, and the method returns
|
|
|
|
the number one.
|
|
|
|
|
|
|
|
If there aren't any widgets, the number 1 is returned.
|
|
|
|
|
|
|
|
@returns Number of columns used, or 1 if there aren't any
|
|
|
|
widgets. The number i returned always satisfies 1 <= i <= nrCols,
|
|
|
|
where nrCols is the private variable of the same nane.
|
|
|
|
*/
|
|
|
|
TQ_UINT8 getNrColumns() const { return (widgetList==0) ? 1 : TQMIN(nrCols, TQMAX(1, widgetList->size())); }
|
|
|
|
|
|
|
|
TQ_UINT8 getNrRows() const { return nrRows; }
|
|
|
|
bool isContinuous() const { return continuousViewmode; }
|
|
|
|
|
|
|
|
/** Return true if the top resp. bottom of the page is visible. */
|
|
|
|
bool atTop() const;
|
|
|
|
bool atBottom() const;
|
|
|
|
|
|
|
|
/** Distance between pages in pixels (this is independent of
|
|
|
|
the zoom level). */
|
|
|
|
int distanceBetweenPages() { return distanceBetweenWidgets; }
|
|
|
|
|
|
|
|
/** Moves the viewport so that the widget is at the top left corner. */
|
|
|
|
void moveViewportToWidget(TQWidget* widget, int y = 0);
|
|
|
|
|
|
|
|
bool isMoveToolEnabled() const { return moveTool; }
|
|
|
|
|
|
|
|
public slots:
|
|
|
|
void calculateCurrentPageNumber();
|
|
|
|
|
|
|
|
bool readUp();
|
|
|
|
bool readDown();
|
|
|
|
void scrollUp();
|
|
|
|
void scrollDown();
|
|
|
|
void scrollRight();
|
|
|
|
void scrollLeft();
|
|
|
|
void scrollBottom();
|
|
|
|
void scrollTop();
|
|
|
|
|
|
|
|
void setFullScreenMode(bool fullScreen);
|
|
|
|
/** Turn the scrollbars on/off. */
|
|
|
|
void slotShowScrollbars(bool);
|
|
|
|
|
|
|
|
/** Set layout of the page widgets according to the current viewmode and zoomlevel.
|
|
|
|
Set zoomChanged = true if the the layout needs updateing because the zoomlevel has changed. */
|
|
|
|
void layoutPages(bool zoomChanged = false);
|
|
|
|
|
|
|
|
void slotEnableMoveTool(bool enable);
|
|
|
|
|
|
|
|
signals:
|
|
|
|
void viewSizeChanged(const TQSize& size);
|
|
|
|
void pageSizeChanged(const TQSize& size);
|
|
|
|
|
|
|
|
void currentPageChanged(const PageNumber&);
|
|
|
|
|
|
|
|
/** This signal is emitted when the scrollView receives a mouse
|
|
|
|
wheel event. */
|
|
|
|
void wheelEventReceived( TQWheelEvent * );
|
|
|
|
|
|
|
|
protected:
|
|
|
|
void keyPressEvent( TQKeyEvent* );
|
|
|
|
|
|
|
|
/** Reimplemented from TQScrollView to make sure that the page is
|
|
|
|
centered when it fits in the viewport. */
|
|
|
|
void viewportResizeEvent( TQResizeEvent* );
|
|
|
|
void viewportPaintEvent(TQPaintEvent*);
|
|
|
|
|
|
|
|
/** Reimplemented from TQScrollView, because the kviepart needs to
|
|
|
|
handle the wheel events itself. The wheel event is passed on by
|
|
|
|
emitting the singal "wheelEventReceived". Nothing else is done. */
|
|
|
|
void contentsWheelEvent ( TQWheelEvent * );
|
|
|
|
|
|
|
|
void contentsMousePressEvent(TQMouseEvent*);
|
|
|
|
void contentsMouseReleaseEvent(TQMouseEvent*);
|
|
|
|
void contentsMouseMoveEvent(TQMouseEvent*);
|
|
|
|
|
|
|
|
private slots:
|
|
|
|
void calculateCurrentPageNumber(int x, int y);
|
|
|
|
|
|
|
|
private:
|
|
|
|
/** Stores the mouse position between two mouse events. This is used
|
|
|
|
to implement the "grab and drag the viewport contents" feature. */
|
|
|
|
TQPoint dragGrabPos;
|
|
|
|
|
|
|
|
TQPtrVector<DocumentWidget>* widgetList;
|
|
|
|
|
|
|
|
/** Used internally by the centerContents()-method. Set with the
|
|
|
|
setNrColumns() method */
|
|
|
|
TQ_UINT8 nrCols;
|
|
|
|
TQ_UINT8 nrRows;
|
|
|
|
|
|
|
|
bool continuousViewmode;
|
|
|
|
bool fullScreen;
|
|
|
|
|
|
|
|
/** This int remembers the style of the frame of the centering
|
|
|
|
scrollview when fullscreen mode is switched on. It is then
|
|
|
|
restored when it is switched off. */
|
|
|
|
int oldFrameStyle;
|
|
|
|
|
|
|
|
/** color of the viewport's background. This is also
|
|
|
|
stored on entering the fullscreen mode. */
|
|
|
|
TQColor backgroundColor;
|
|
|
|
|
|
|
|
/** Distance between pages in pixels
|
|
|
|
(this is independent of the zoom level). */
|
|
|
|
static const int distanceBetweenWidgets=10;
|
|
|
|
|
|
|
|
bool moveTool;
|
|
|
|
};
|
|
|
|
|
|
|
|
#endif
|