---

QwtPixFrame Class Reference

A frame containing a pixmap into which can be drawn. More...

#include <qwt_pixframe.h>

Inherits QFrame.

Inherited by QwtPlotPixFrame.

Inheritance diagram for QwtPixFrame

[legend]List of all members.

Public Methods
	QwtPixFrame (QWidget *parent, const char *name =0)
	~QwtPixFrame ()
void	setPixmap (const QPixmap &pix)
const QPixmap*	pixmap () const
void	fillPixmap (const QColor &c)
void	clearPixmap ()
void	updatePixmap ()
void	updatePixmapRect (const QRect &r)
void	setPixmapBackground (const QColor &c)
void	setVariableSize (bool tf)
const QColor&	pixmapBackground () const
Signals
void	pixmapResized ()
Protected Methods
void	adjustPixmap ()
void	adjustFrame ()
virtual void	paintEvent (QPaintEvent *e)
virtual void	resizeEvent (QResizeEvent *e)
virtual void	frameChanged ()
Protected Attributes
QPixmap	d_pix
bool	d_adjustPixmap

---

Detailed Description

A frame containing a pixmap into which can be drawn.

QwtPixFrame is a frame which contains a pixmap. The size of the pixmap is dynamically adjusted in order to fit the frame's contents.

Example

#include "../include/qwt_pixframe.h>

class ParentClass : ...
{
        ...
        QwtPixFrame *pixframe;
        ...
        void newPicture();
        ...
private slots:
        void repaintPixmap();
}

//
//     Connect pixmapResized() to a slot
//
ParentClass::ParentClass(...)
{
        ...
        connect(pixframe, SIGNAL(pixmapResized()), SLOT(repaintPixmap()));
}

//
// Repaint when the pixmap has been resized
//
ParentClass::repaintPixmap()
{
        QPainter p;
        p.begin(pixframe->pixmap());
  redraw_picture(&p, pixframe->pixmap().rect());
        p.end();
        // Note: No updatePixmap() required here
}

//
// Renew the pixmap's contents independently
//
ParentClass::newPicture()
{
        // Change the pixmap's contents
        draw_new_picture(pixframe->pixmap());
         // Generate paint event
        pixframe->updatePixmap();
}

---

Constructor & Destructor Documentation

QwtPixFrame::QwtPixFrame ( QWidget * parent, const char * name = 0 )

CTOR.

QwtPixFrame::~QwtPixFrame ( )

DTOR.

---

Member Function Documentation

void QwtPixFrame::adjustFrame ( ) [protected]

Resize the frame according to the pixmap size.

void QwtPixFrame::adjustPixmap ( ) [protected]

Resize the pixmap according to the frame size.

void QwtPixFrame::clearPixmap ( )

Clear the contents of the pixmap and fill it with its background color.

void QwtPixFrame::fillPixmap ( const QColor & c )

Fill the pixmap with a specified color. Parameters: c   Fill color

void QwtPixFrame::frameChanged ( ) [protected, virtual]

Notify a change of the frame.

void QwtPixFrame::paintEvent ( QPaintEvent * e ) [protected, virtual]

Paint event.

const QPixmap * QwtPixFrame::pixmap ( ) const

Returns: a pointer to the enclosed pixmap

const QColor & QwtPixFrame::pixmapBackground ( ) const

Returns: the pixmap's background color See also: setPixmapBackground(const QColor &c)

void QwtPixFrame::pixmapResized ( ) [signal]

A signal which is emitted when the size of the pixmap has been changed. When resized, the pixmap is cleared and filled with its background color.

void QwtPixFrame::setPixmap ( const QPixmap & pix )

Assign a pixmap. If the variable size feature is enabled (disabled by default), the size of the frame will not change when a new pixmap has been assigned.

void QwtPixFrame::setPixmapBackground ( const QColor & c )

Assign a background color the the pixmap. Parameters: c   New background color

void QwtPixFrame::setVariableSize ( bool tf )

Set resizing policy. Parameters: tf   Adjust pixmap size (TRUE) or frame size (FALSE). If tf is TRUE, the pixmap will be adjusted when the frame is resized or when the frame style is changed. If set to FALSE, the size of the pixmap will remain constant and the frame size will be adjusted. The default value is TRUE.

void QwtPixFrame::updatePixmap ( )

Maps the pixmap to the screen. This function synchronizes the screen contents with the current contents of the pixmap. It generates a paint event which updates the widget. Warning: When the widget gets resized, a paint event is generated automatically after the pixmapResized() signal has been emitted. It is not necessary to call updatePixmap() within a slot which is connected to pixmapResized().

void QwtPixFrame::updatePixmapRect ( const QRect & r )

Repaint a part of the pixmap. Parameters: r   part of the pixmap to be redrawn in pixmap coordinates

---

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

• qwt_pixframe.h
• qwt_pixframe.cpp

---