class KDualColorButton

A widget for selecting two related colors. More...

Definition#include <kdualcolorbtn.h>
InheritsQWidget (qt) [public ]
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Types

Public Methods

Public Slots

Signals

Protected Methods


Detailed Description

KDualColorButton allows the user to select two cascaded colors (usually a foreground and background color). Other features include drag and drop from other KDE color widgets, a reset to black and white control, and a swap colors control.

When the user clicks on the foreground or background rectangle the rectangle is first sunken and the currentChanged() signal is emitted. Further clicks will present a color dialog and emit either the fgChanged() or bgChanged() if a new color is selected.

Note: With drag and drop when dropping a color the current selected color will be set, while when dragging a color it will use whatever color rectangle the mouse was pressed inside.

enum DualColor { Foreground, Background }; }

DualColor

 KDualColorButton (QWidget *parent=0, const char *name=0)

KDualColorButton

Constructs a new KDualColorButton using the default black and white colors.

 KDualColorButton (QWidget *parent, const char *name, QWidget* dialogParent)

KDualColorButton

Constructs a new KDualColorButton using the default black and white colors.

BIC: merge with the above next Wednesday, dialogParent defaults to 0L

 KDualColorButton (const QColor &fgColor, const QColor &bgColor, QWidget *parent=0, const char *name=0)

KDualColorButton

Constructs a new KDualColorButton with the supplied foreground and background colors.

 KDualColorButton (const QColor &fgColor, const QColor &bgColor, QWidget *parent, const char *name, QWidget* dialogParent)

KDualColorButton

Constructs a new KDualColorButton with the supplied foreground and background colors.

BIC: merge with the above next Wednesday, dialogParent defaults to 0L

 ~KDualColorButton ()

~KDualColorButton

QColor  foreground ()

foreground

[const]

Returns the current foreground color.

QColor  background ()

background

[const]

Returns the current background color.

DualColor  current ()

current

[const]

Returns the current color item selected by the user.

QColor  currentColor ()

currentColor

[const]

Returns the color of the selected item.

QSize  sizeHint ()

sizeHint

[const virtual]

Returns the minimum size needed to display the widget and all its controls.

Reimplemented from QWidget.

void  setForeground (const QColor &c)

setForeground

[slot]

Sets the foreground color.

void  setBackground (const QColor &c)

setBackground

[slot]

Sets the background color.

void  setCurrent (DualColor s)

setCurrent

[slot]

Sets the current selected color item.

void  setCurrentColor (const QColor &c)

setCurrentColor

[slot]

Sets the color of the selected item.

void  fgChanged (const QColor &c)

fgChanged

[signal]

Emitted when the foreground color is changed.

void  bgChanged (const QColor &c)

bgChanged

[signal]

Emitted when the background color is changed.

void  currentChanged (KDualColorButton::DualColor s)

currentChanged

[signal]

Emitted when the user changes the current color selection.

void  metrics (QRect &fgRect, QRect &bgRect)

metrics

[protected: virtual]

Sets the supplied rectangles to the proper size and position for the current widget size. You can reimplement this to change the layout of the widget. Restrictions are that the swap control will always be at the top right, the reset control will always be at the bottom left, and you must leave at least a 14x14 space in those corners.

void  paintEvent (QPaintEvent *ev)

paintEvent

[protected: virtual]

Reimplemented from QWidget.

void  mousePressEvent (QMouseEvent *ev)

mousePressEvent

[protected: virtual]

Reimplemented from QWidget.

void  mouseMoveEvent (QMouseEvent *ev)

mouseMoveEvent

[protected: virtual]

Reimplemented from QWidget.

void  mouseReleaseEvent (QMouseEvent *ev)

mouseReleaseEvent

[protected: virtual]

Reimplemented from QWidget.

void  dragEnterEvent (QDragEnterEvent *ev)

dragEnterEvent

[protected: virtual]

Reimplemented from QWidget.

void  dropEvent (QDropEvent *ev)

dropEvent

[protected: virtual]

Reimplemented from QWidget.