QRuntimeWindowSurface Class Reference

#include <qgraphicssystem_runtime_p.h>

Inheritance diagram for QRuntimeWindowSurface:

Public Functions
virtual void	beginPaint (const QRegion &)
	This function is called before painting onto the surface begins, with the region in which the painting will occur. More...
virtual QImage *	buffer (const QWidget *widget)
	Returns a QImage pointer which represents the actual buffer the widget is drawn into or 0 if this is unavailable. More...
virtual void	endPaint (const QRegion &)
	This function is called after painting onto the surface has ended, with the region in which the painting was performed. More...
virtual WindowSurfaceFeatures	features () const
virtual void	flush (QWidget *widget, const QRegion &region, const QPoint &offset)
	Flushes the given region from the specified widget onto the screen. More...
virtual QPixmap	grabWidget (const QWidget *widget, const QRect &rectangle=QRect()) const
	Returns a QPixmap generated from the part of the backing store corresponding to widget. More...
virtual QPoint	offset (const QWidget *widget) const
	Returns the offset of widget in the coordinates of this window surface. More...
virtual QPaintDevice *	paintDevice ()
	Implement this function to return the appropriate paint device. More...
	QRuntimeWindowSurface (const QRuntimeGraphicsSystem *gs, QWidget *window)
virtual bool	scroll (const QRegion &area, int dx, int dy)
	Scrolls the given area dx pixels to the right and dy downward; both dx and dy may be negative. More...
virtual void	setGeometry (const QRect &rect)
	Sets the currently allocated area to be the given rect. More...
	~QRuntimeWindowSurface ()
Public Functions inherited from QWindowSurface
QRect	geometry () const
	Returns the currently allocated area on the screen. More...
bool	hasFeature (WindowSurfaceFeature feature) const
	QWindowSurface (QWidget *window, bool setDefaultSurface=true)
	Constructs an empty surface for the given top-level window. More...
QRect	rect (const QWidget *widget) const
	Returns the rectangle for widget in the coordinates of this window surface. More...
void	setStaticContents (const QRegion &region)
QRegion	staticContents () const
QWidget *	window () const
	Returns a pointer to the top-level window associated with this surface. More...
virtual	~QWindowSurface ()
	Destroys this surface. More...

Public Variables
QScopedPointer< QWindowSurface >	m_pendingWindowSurface
QScopedPointer< QWindowSurface >	m_windowSurface

Properties
const QRuntimeGraphicsSystem *	m_graphicsSystem

Additional Inherited Members
Public Types inherited from QWindowSurface
enum	WindowSurfaceFeature { PartialUpdates = 0x00000001, PreservedContents = 0x00000002, StaticContents = 0x00000004, AllFeatures = 0xffffffff }
Protected Functions inherited from QWindowSurface
bool	hasStaticContents () const

Detailed Description

Definition at line 112 of file qgraphicssystem_runtime_p.h.

Constructors and Destructors

QRuntimeWindowSurface()

QRuntimeWindowSurface::QRuntimeWindowSurface	(	const QRuntimeGraphicsSystem *	gs,
		QWidget *	window
	)

Definition at line 254 of file qgraphicssystem_runtime.cpp.

    : QWindowSurface(window), m_graphicsSystem(gs)
{

}

~QRuntimeWindowSurface()

QRuntimeWindowSurface::~QRuntimeWindowSurface

(

)

Definition at line 260 of file qgraphicssystem_runtime.cpp.

{
    if (QApplicationPrivate::graphics_system)
        m_graphicsSystem->removeWindowSurface(this);
}

Functions

beginPaint()

void QRuntimeWindowSurface::beginPaint ( const QRegion &  region )

virtual

This function is called before painting onto the surface begins, with the region in which the painting will occur.

See also

endPaint(), paintDevice()

Reimplemented from QWindowSurface.

Definition at line 297 of file qgraphicssystem_runtime.cpp.

{
    m_windowSurface->beginPaint(rgn);
}

buffer()

QImage * QRuntimeWindowSurface::buffer ( const QWidget *  widget )

virtual

Returns a QImage pointer which represents the actual buffer the widget is drawn into or 0 if this is unavailable.

You must call beginPaint() before you call this function and the returned pointer is only valid until endPaint() is called.

Reimplemented from QWindowSurface.

Definition at line 307 of file qgraphicssystem_runtime.cpp.

{
    return m_windowSurface->buffer(widget);
}

endPaint()

void QRuntimeWindowSurface::endPaint ( const QRegion &  region )

virtual

This function is called after painting onto the surface has ended, with the region in which the painting was performed.

See also

beginPaint(), paintDevice()

Reimplemented from QWindowSurface.

Definition at line 302 of file qgraphicssystem_runtime.cpp.

{
    m_windowSurface->endPaint(rgn);
}

features()

QWindowSurface::WindowSurfaceFeatures QRuntimeWindowSurface::features ( ) const

virtual

Reimplemented from QWindowSurface.

Definition at line 322 of file qgraphicssystem_runtime.cpp.

{
    return m_windowSurface->features();
}

flush()

void QRuntimeWindowSurface::flush ( QWidget *  widget, const QRegion &  region, const QPoint &  offset  )

virtual

Flushes the given region from the specified widget onto the screen.

Note that the offset parameter is currently unused.

Implements QWindowSurface.

Definition at line 271 of file qgraphicssystem_runtime.cpp.

{
    m_windowSurface->flush(widget, region, offset);

    int destroyPolicy = m_graphicsSystem->windowSurfaceDestroyPolicy();
    if(m_pendingWindowSurface &&
        destroyPolicy == QRuntimeGraphicsSystem::DestroyAfterFirstFlush) {
#ifdef QT_DEBUG
        qDebug() << "QRuntimeWindowSurface::flush() - destroy pending window surface";
#endif
        m_pendingWindowSurface.reset();
    }
}

grabWidget()

QPixmap QRuntimeWindowSurface::grabWidget ( const QWidget *  widget, const QRect &  rectangle = QRect()  ) const

virtual

Returns a QPixmap generated from the part of the backing store corresponding to widget.

Returns a null QPixmap if an error occurs. The contents of the pixmap are only defined for the regions of widget that have received paint events since the last resize of the backing store.

If rectangle is a null rectangle (the default), the entire widget is grabbed. Otherwise, the grabbed area is limited to rectangle.

The default implementation uses QWindowSurface::buffer().

See also

QPixmap::grabWidget()

Reimplemented from QWindowSurface.

Definition at line 312 of file qgraphicssystem_runtime.cpp.

{
    return m_windowSurface->grabWidget(widget, rectangle);
}

offset()

QPoint QRuntimeWindowSurface::offset ( const QWidget *  widget ) const

virtual

Returns the offset of widget in the coordinates of this window surface.

Reimplemented from QWindowSurface.

Definition at line 317 of file qgraphicssystem_runtime.cpp.

{
    return m_windowSurface->offset(widget);
}

paintDevice()

QPaintDevice * QRuntimeWindowSurface::paintDevice ( )

virtual

Implement this function to return the appropriate paint device.

Implements QWindowSurface.

Definition at line 266 of file qgraphicssystem_runtime.cpp.

{
    return m_windowSurface->paintDevice();
}

scroll()

bool QRuntimeWindowSurface::scroll ( const QRegion &  area, int  dx, int  dy  )

virtual

Scrolls the given area dx pixels to the right and dy downward; both dx and dy may be negative.

Returns true if the area was scrolled successfully; false otherwise.

Reimplemented from QWindowSurface.

Definition at line 292 of file qgraphicssystem_runtime.cpp.

{
    return m_windowSurface->scroll(area, dx, dy);
}

setGeometry()

void QRuntimeWindowSurface::setGeometry ( const QRect &  rect )

virtual

Sets the currently allocated area to be the given rect.

This function is called whenever area covered by the top-level window changes.

See also

geometry()

Reimplemented from QWindowSurface.

Definition at line 286 of file qgraphicssystem_runtime.cpp.

{
    QWindowSurface::setGeometry(rect);
    m_windowSurface->setGeometry(rect);
}

Properties

m_graphicsSystem

const QRuntimeGraphicsSystem* QRuntimeWindowSurface::m_graphicsSystem

private

Definition at line 138 of file qgraphicssystem_runtime_p.h.

Referenced by flush(), and ~QRuntimeWindowSurface().

m_pendingWindowSurface

QScopedPointer<QWindowSurface> QRuntimeWindowSurface::m_pendingWindowSurface

Definition at line 135 of file qgraphicssystem_runtime_p.h.

Referenced by flush(), and QRuntimeGraphicsSystem::setGraphicsSystem().

m_windowSurface

QScopedPointer<QWindowSurface> QRuntimeWindowSurface::m_windowSurface

Definition at line 134 of file qgraphicssystem_runtime_p.h.

Referenced by beginPaint(), buffer(), QRuntimeGraphicsSystem::createWindowSurface(), endPaint(), features(), flush(), grabWidget(), offset(), paintDevice(), scroll(), setGeometry(), and QRuntimeGraphicsSystem::setGraphicsSystem().

---

The documentation for this class was generated from the following files:

• /src/gui/painting/qgraphicssystem_runtime_p.h
• /src/gui/painting/qgraphicssystem_runtime.cpp