Qt 4.8: QWellArray Class Reference

int cellh

Definition: qcolordialog.cpp:163

◆ cellRect()

QRect QWellArray::cellRect ( ) const

inline

Definition at line 127 of file qcolordialog.cpp.

128 { return QRect(0, 0, cellw, cellh); }

int cellw

Definition: qcolordialog.cpp:162

int cellh

Definition: qcolordialog.cpp:163

QRect

The QRect class defines a rectangle in the plane using integer precision.

Definition: qrect.h:58

◆ cellWidth()

int QWellArray::cellWidth ( ) const

inline

Definition at line 103 of file qcolordialog.cpp.

Referenced by QColorWell::mouseMoveEvent(), and paintEvent().

104 { return cellw; }

int cellw

Definition: qcolordialog.cpp:162

◆ columnAt()

int QWellArray::columnAt ( int x ) const

inline

Definition at line 112 of file qcolordialog.cpp.

Referenced by QColorWell::dragMoveEvent(), QColorWell::dropEvent(), QColorWell::mouseMoveEvent(), mousePressEvent(), and paintEvent().

113 { if (isRightToLeft()) return ncols - (x / cellw) - 1; return x / cellw; }

int cellw

Definition: qcolordialog.cpp:162

int ncols

Definition: qcolordialog.cpp:161

QWidget::x

int x() const

QWidget::isRightToLeft

bool isRightToLeft() const

Definition: qwidget.h:428

◆ columnX()

int QWellArray::columnX ( int column ) const

inline

Definition at line 118 of file qcolordialog.cpp.

Referenced by cellGeometry(), and paintEvent().

119 { if (isRightToLeft()) return cellw * (ncols - column - 1); return cellw * column; }

int cellw

Definition: qcolordialog.cpp:162

int ncols

Definition: qcolordialog.cpp:161

QWidget::isRightToLeft

bool isRightToLeft() const

Definition: qwidget.h:428

◆ focusInEvent()

void QWellArray::focusInEvent ( QFocusEvent * event )

protectedvirtual

This event handler can be reimplemented in a subclass to receive keyboard focus events (focus received) for the widget.

The event is passed in the event parameter

A widget normally must setFocusPolicy() to something other than Qt::NoFocus in order to receive focus events. (Note that the application programmer can call setFocus() on any widget, even those that do not normally accept focus.)

The default implementation updates the widget (except for windows that do not specify a focusPolicy()).

See also: focusOutEvent(), setFocusPolicy(), keyPressEvent(), keyReleaseEvent(), event(), QFocusEvent

Reimplemented from QWidget.

Definition at line 350 of file qcolordialog.cpp.

Referenced by updateCell().

 {
     updateCell(curRow, curCol);
 }

◆ focusOutEvent()

void QWellArray::focusOutEvent ( QFocusEvent * event )

protectedvirtual

This event handler can be reimplemented in a subclass to receive keyboard focus events (focus lost) for the widget.

The events is passed in the event parameter.

A widget normally must setFocusPolicy() to something other than Qt::NoFocus in order to receive focus events. (Note that the application programmer can call setFocus() on any widget, even those that do not normally accept focus.)

The default implementation updates the widget (except for windows that do not specify a focusPolicy()).

See also: focusInEvent(), setFocusPolicy(), keyPressEvent(), keyReleaseEvent(), event(), QFocusEvent

Reimplemented from QWidget.

Definition at line 383 of file qcolordialog.cpp.

Referenced by updateCell().

 {
     updateCell(curRow, curCol);
 }

◆ gridSize()

QSize QWellArray::gridSize ( ) const

inline

Definition at line 130 of file qcolordialog.cpp.

Referenced by sizeHint().

131 { return QSize(ncols * cellw, nrows * cellh); }

int cellw

Definition: qcolordialog.cpp:162

int cellh

Definition: qcolordialog.cpp:163

int ncols

Definition: qcolordialog.cpp:161

QWellArray::nrows

int nrows

Definition: qcolordialog.cpp:160

QSize

The QSize class defines the size of a two-dimensional object using integer point precision.

Definition: qsize.h:53

◆ keyPressEvent()

void QWellArray::keyPressEvent ( QKeyEvent * event )

protectedvirtual

This event handler, for event event, can be reimplemented in a subclass to receive key press events for the widget.

A widget must call setFocusPolicy() to accept focus initially and have focus in order to receive a key press event.

If you reimplement this handler, it is very important that you call the base class implementation if you do not act upon the key.

The default implementation closes popup widgets if the user presses Esc. Otherwise the event is ignored, so that the widget's parent can interpret it.

Note that QKeyEvent starts with isAccepted() == true, so you do not need to call QKeyEvent::accept() - just do not call the base class implementation if you act upon the key.

See also: keyReleaseEvent(), setFocusPolicy(), focusInEvent(), focusOutEvent(), event(), QKeyEvent, {Tetrix Example}

Reimplemented from QWidget.

Definition at line 390 of file qcolordialog.cpp.

Referenced by updateCell().

 {
     switch(e->key()) {                        // Look at the key code
     case Qt::Key_Left:                                // If 'left arrow'-key,
         if(curCol > 0)                        // and cr't not in leftmost col
             setCurrent(curRow, curCol - 1);        // set cr't to next left column
         break;
     case Qt::Key_Right:                                // Correspondingly...
         if(curCol < numCols()-1)
             setCurrent(curRow, curCol + 1);
         break;
     case Qt::Key_Up:
         if(curRow > 0)
             setCurrent(curRow - 1, curCol);
         break;
     case Qt::Key_Down:
         if(curRow < numRows()-1)
             setCurrent(curRow + 1, curCol);
         break;
 #if 0
     // bad idea that shouldn't have been implemented; very counterintuitive
     case Qt::Key_Return:
     case Qt::Key_Enter:
         /*
           ignore the key, so that the dialog get it, but still select
           the current row/col
         */
         e->ignore();
         // fallthrough intended
 #endif
     case Qt::Key_Space:
         setSelected(curRow, curCol);
         break;
     default:                                // If not an interesting key,
         e->ignore();                        // we don't accept the event
         return;
     }
 
 }

◆ mousePressEvent()

void QWellArray::mousePressEvent ( QMouseEvent * event )

protectedvirtual

This event handler, for event event, can be reimplemented in a subclass to receive mouse press events for the widget.

If you create new widgets in the mousePressEvent() the mouseReleaseEvent() may not end up where you expect, depending on the underlying window system (or X11 window manager), the widgets' location and maybe more.

The default implementation implements the closing of popup widgets when you click outside the window. For other widget types it does nothing.

See also: mouseReleaseEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), event(), QMouseEvent, {Scribble Example}

Reimplemented from QWidget.

Reimplemented in QColorWell.

Definition at line 285 of file qcolordialog.cpp.

Referenced by QColorWell::mousePressEvent(), QColorWell::QColorWell(), and updateCell().

 {
     // The current cell marker is set to the cell the mouse is pressed in
     QPoint pos = e->pos();
     setCurrent(rowAt(pos.y()), columnAt(pos.x()));
 }

◆ mouseReleaseEvent()

void QWellArray::mouseReleaseEvent ( QMouseEvent * event )

protectedvirtual

This event handler, for event event, can be reimplemented in a subclass to receive mouse release events for the widget.

See also: mousePressEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), event(), QMouseEvent, {Scribble Example}

Reimplemented from QWidget.

Reimplemented in QColorWell.

Definition at line 292 of file qcolordialog.cpp.

Referenced by QColorWell::mouseReleaseEvent(), QColorWell::QColorWell(), and updateCell().

 {
     // The current cell marker is set to the cell the mouse is clicked in
     setSelected(curRow, curCol);
 }

◆ numCols()

int QWellArray::numCols ( ) const

inline

Definition at line 124 of file qcolordialog.cpp.

Referenced by cellBrush(), keyPressEvent(), paintCellContents(), and setCellBrush().

125 {return ncols; }

int ncols

Definition: qcolordialog.cpp:161

◆ numRows()

int QWellArray::numRows ( ) const

inline

Definition at line 121 of file qcolordialog.cpp.

Referenced by cellBrush(), QColorWell::dropEvent(), keyPressEvent(), QColorWell::mouseMoveEvent(), QColorWell::paintCellContents(), and setCellBrush().

122 { return nrows; }

QWellArray::nrows

int nrows

Definition: qcolordialog.cpp:160

◆ paintCell()

void QWellArray::paintCell	(	QPainter *	p,
		int	row,
		int	col,
		const QRect &	rect
	)

protectedvirtual

Definition at line 243 of file qcolordialog.cpp.

Referenced by paintEvent(), and updateCell().

 {
     int b = 3; //margin
 
     const QPalette & g = palette();
     QStyleOptionFrame opt;
     int dfw = style()->pixelMetric(QStyle::PM_DefaultFrameWidth);
     opt.lineWidth = dfw;
     opt.midLineWidth = 1;
     opt.rect = rect.adjusted(b, b, -b, -b);
     opt.palette = g;
     opt.state = QStyle::State_Enabled | QStyle::State_Sunken;
     style()->drawPrimitive(QStyle::PE_Frame, &opt, p, this);
     b += dfw;
 
     if ((row == curRow) && (col == curCol)) {
         if (hasFocus()) {
             QStyleOptionFocusRect opt;
             opt.palette = g;
             opt.rect = rect;
             opt.state = QStyle::State_None | QStyle::State_KeyboardFocusChange;
             style()->drawPrimitive(QStyle::PE_FrameFocusRect, &opt, p, this);
         }
     }
     paintCellContents(p, row, col, opt.rect.adjusted(dfw, dfw, -dfw, -dfw));
 }

◆ paintCellContents()

void QWellArray::paintCellContents	(	QPainter *	p,
		int	row,
		int	col,
		const QRect &	r
	)

protectedvirtual

Reimplement this function to change the contents of the well array.

Reimplemented in QColorWell.

Definition at line 273 of file qcolordialog.cpp.

Referenced by paintCell(), QColorWell::QColorWell(), and updateCell().

 {
     if (d) {
         p->fillRect(r, d->brush[row*numCols()+col]);
     } else {
         p->fillRect(r, Qt::white);
         p->setPen(Qt::black);
         p->drawLine(r.topLeft(), r.bottomRight());
         p->drawLine(r.topRight(), r.bottomLeft());
     }
 }

◆ paintEvent()

void QWellArray::paintEvent ( QPaintEvent * event )

protectedvirtual

This event handler can be reimplemented in a subclass to receive paint events passed in event.

A paint event is a request to repaint all or part of a widget. It can happen for one of the following reasons:

repaint() or update() was invoked,
the widget was obscured and has now been uncovered, or
many other reasons.

Many widgets can simply repaint their entire surface when asked to, but some slow widgets need to optimize by painting only the requested region: QPaintEvent::region(). This speed optimization does not change the result, as painting is clipped to that region during event processing. QListView and QTableView do this, for example.

Qt also tries to speed up painting by merging multiple paint events into one. When update() is called several times or the window system sends several paint events, Qt merges these events into one event with a larger region (see QRegion::united()). The repaint() function does not permit this optimization, so we suggest using update() whenever possible.

When the paint event occurs, the update region has normally been erased, so you are painting on the widget's background.

The background can be set using setBackgroundRole() and setPalette().

Since Qt 4.0, QWidget automatically double-buffers its painting, so there is no need to write double-buffering code in paintEvent() to avoid flicker.

Note for the X11 platform: It is possible to toggle global double buffering by calling qt_x11_set_global_double_buffer(). For example,

...
extern void qt_x11_set_global_double_buffer(bool);
qt_x11_set_global_double_buffer(false);
...

Note: Generally, you should refrain from calling update() or repaint() inside a paintEvent(). For example, calling update() or repaint() on children inside a paintevent() results in undefined behavior; the child may or may not get a paint event.

Warning: If you are using a custom paint engine without Qt's backingstore, Qt::WA_PaintOnScreen must be set. Otherwise, QWidget::paintEngine() will never be called; the backingstore will be used instead.

See also: event(), repaint(), update(), QPainter, QPixmap, QPaintEvent, {Analog Clock Example}

Reimplemented from QWidget.

Definition at line 171 of file qcolordialog.cpp.

Referenced by updateCell().

 {
     QRect r = e->rect();
     int cx = r.x();
     int cy = r.y();
     int ch = r.height();
     int cw = r.width();
     int colfirst = columnAt(cx);
     int collast = columnAt(cx + cw);
     int rowfirst = rowAt(cy);
     int rowlast = rowAt(cy + ch);
 
     if (isRightToLeft()) {
         int t = colfirst;
         colfirst = collast;
         collast = t;
     }
 
     QPainter painter(this);
     QPainter *p = &painter;
     QRect rect(0, 0, cellWidth(), cellHeight());
 
 
     if (collast < 0 || collast >= ncols)
         collast = ncols-1;
     if (rowlast < 0 || rowlast >= nrows)
         rowlast = nrows-1;
 
     // Go through the rows
     for (int r = rowfirst; r <= rowlast; ++r) {
         // get row position and height
         int rowp = rowY(r);
 
         // Go through the columns in the row r
         // if we know from where to where, go through [colfirst, collast],
         // else go through all of them
         for (int c = colfirst; c <= collast; ++c) {
             // get position and width of column c
             int colp = columnX(c);
             // Translate painter and draw the cell
             rect.translate(colp, rowp);
             paintCell(p, r, c, rect);
             rect.translate(-colp, -rowp);
         }
     }
 }

◆ rowAt()

int QWellArray::rowAt ( int y ) const

inline

Definition at line 109 of file qcolordialog.cpp.

Referenced by QColorWell::dragMoveEvent(), QColorWell::dropEvent(), QColorWell::mouseMoveEvent(), mousePressEvent(), and paintEvent().

110 { return y / cellh; }

QWidget::y

int y() const

int cellh

Definition: qcolordialog.cpp:163

◆ rowY()

int QWellArray::rowY ( int row ) const

inline

Definition at line 115 of file qcolordialog.cpp.

Referenced by cellGeometry(), and paintEvent().

116 { return cellh * row; }