Qt:Документация 4.3.2/q3canvasview
Материал из Wiki.crossplatform.ru
![]() | Внимание: Актуальная версия перевода документации находится здесь |
__NOTOC__
Главная · Все классы · Основные классы · Классы по группам · Модули · Функции |
[править] Q3CanvasView Class Reference
[ Qt3Support module]
The Q3CanvasView class provides an on-screen view of a Q3Canvas. Далее...
#include <Q3CanvasView>
This class is part of the Qt 3 support library. It is provided to keep old source code working. Мы настоятельно не рекомендуем использовать этот класс в новом коде. See Porting to Qt 4 for more information.
Note to Qt Desktop Light Edition users: This class is only available in the Qt Desktop Edition.
Inherits Q3ScrollView.
[править] Открытые функции
- Q3CanvasView ( QWidget * parent = 0, const char * name = 0, Qt::WindowFlags f = 0 )
- Q3CanvasView ( Q3Canvas * canvas, QWidget * parent = 0, const char * name = 0, Qt::WindowFlags f = 0 )
- ~Q3CanvasView ()
- Q3Canvas * canvas () const
- const QMatrix & inverseWorldMatrix () const
- void setCanvas ( Q3Canvas * canvas )
- bool setWorldMatrix ( const QMatrix & wm )
- const QMatrix & worldMatrix () const
- 46 public functions inherited from Q3ScrollView
- 4 public functions inherited from Q3Frame
- 13 открытых функций, унаследованных от QFrame
- 201 свойство, унаследованное от QWidget
- 29 открытых функций, унаследованных от QObject
- 12 открытых функций, унаследованных от QPaintDevice
[править] Защищенные функции
- virtual void drawContents ( QPainter * p, int cx, int cy, int cw, int ch )
- virtual QSize sizeHint () const
- 17 protected functions inherited from Q3ScrollView
- 5 protected functions inherited from Q3Frame
- 38 защищенных функций, унаследованных от QWidget
- 7 защищенных функций, унаследованных от QObject
- 1 защищенная функция, унаследованных от QPaintDevice
[править] Дополнительные унаследованные члены
- 10 properties inherited from Q3ScrollView
- 2 properties inherited from Q3Frame
- 6 свойств, унаследованных от QFrame
- 56 свойств, унаследованных от QWidget
- 1 свойство, унаследованное от QObject
- 8 public slots inherited from Q3ScrollView
- 19 открытых слотов, унаследованных от QWidget
- 1 открытый слот, унаследованный от QObject
- 5 signals inherited from Q3ScrollView
- 1 сигнал, унаследованный от QWidget
- 1 сигнал, унаследованный от QObject
- 4 статических открытых члена, унаследованных от QWidget
- 5 статических открытых членов, унаследованных от QObject
- 1 защищенный слот, унаследованый от QWidget
[править] Подробное описание
The Q3CanvasView class provides an on-screen view of a Q3Canvas.
A Q3CanvasView is widget which provides a view of a Q3Canvas.
If you want users to be able to interact with a canvas view, subclass Q3CanvasView. You might then reimplement Q3ScrollView::contentsMousePressEvent(). Пример:
void MyCanvasView::contentsMousePressEvent(QMouseEvent* e) { Q3CanvasItemList l = canvas()->collisions(e->pos()); for (Q3CanvasItemList::Iterator it=l.begin(); it!=l.end(); ++it) { if ((*it)->rtti() == Q3CanvasRectangle::RTTI) qDebug("A Q3CanvasRectangle lies somewhere at this point"); } }
The canvas view shows canvas canvas(); this can be changed using setCanvas().
A transformation matrix can be used to transform the view of the canvas in various ways, for example, zooming in or out or rotating. Пример:
QMatrix wm; wm.scale(2, 2); // Zooms in by 2 times wm.rotate(90); // Rotates 90 degrees counter clockwise // around the origin. wm.translate(0, -canvas->height()); // moves the canvas down so what was visible // before is still visible. myCanvasView->setWorldMatrix(wm);
Use setWorldMatrix() to set the canvas view's world matrix: you must ensure that the world matrix is invertible. The current world matrix is retrievable with worldMatrix(), and its inversion is retrievable with inverseWorldMatrix().
Пример:
The following code finds the part of the canvas that is visible in this view, i.e. the bounding rectangle of the view in canvas coordinates.
QRect rc = QRect(myCanvasView->contentsX(), myCanvasView->contentsY(), myCanvasView->visibleWidth(), myCanvasView->visibleHeight()); QRect canvasRect = myCanvasView->inverseWorldMatrix().mapRect(rc);
See also QMatrix, QPainter::setWorldMatrix(), QtCanvas, and Porting to Graphics View.
[править] Описание функций-членов
[править] Q3CanvasView::Q3CanvasView ( QWidget * parent = 0, const char * name = 0, Qt::WindowFlags f = 0 )
Constructs a Q3CanvasView with parent parent, and name name, using the widget flags f. The canvas view is not associated with a canvas, so you must to call setCanvas() to view a canvas.
[править] Q3CanvasView::Q3CanvasView ( Q3Canvas * canvas, QWidget * parent = 0, const char * name = 0, Qt::WindowFlags f = 0 )
Constructs a Q3CanvasView which views canvas canvas, with parent parent, and name name, using the widget flags f.
[править] Q3CanvasView::~Q3CanvasView ()
Destroys the canvas view. The associated canvas is not deleted.
[править] Q3Canvas * Q3CanvasView::canvas () const
Returns a pointer to the canvas which the Q3CanvasView is currently showing.
See also setCanvas().
[править] void Q3CanvasView::drawContents ( QPainter * p, int cx, int cy, int cw, int ch ) [virtual protected]
Repaints part of the Q3Canvas that the canvas view is showing starting at cx by cy, with a width of cw and a height of ch using the painter p.
Reimplemented from Q3ScrollView.
[править] const QMatrix & Q3CanvasView::inverseWorldMatrix () const
Returns a reference to the inverse of the canvas view's current transformation matrix.
See also setWorldMatrix() and worldMatrix().
[править] void Q3CanvasView::setCanvas ( Q3Canvas * canvas )
Sets the canvas that the Q3CanvasView is showing to the canvas canvas.
See also canvas().
[править] bool Q3CanvasView::setWorldMatrix ( const QMatrix & wm )
Sets the transformation matrix of the Q3CanvasView to wm. The matrix must be invertible (i.e. if you create a world matrix that zooms out by 2 times, then the inverse of this matrix is one that will zoom in by 2 times).
When you use this, you should note that the performance of the Q3CanvasView will decrease considerably.
Returns false if wm is not invertable; otherwise returns true.
See also worldMatrix(), inverseWorldMatrix(), and QMatrix::isInvertible().
[править] QSize Q3CanvasView::sizeHint () const [virtual protected]
Suggests a size sufficient to view the entire canvas.
Reimplemented from QWidget.
[править] const QMatrix & Q3CanvasView::worldMatrix () const
Returns a reference to the canvas view's current transformation matrix.
See also setWorldMatrix() and inverseWorldMatrix().
Copyright © 2007 Trolltech | Trademarks | Qt 4.3.2
|