KLFColorChooseWidget Class Reference

#include <klfcolorchooser.h>

List of all members.

Public Slots
void	setColor (const QColor &color)
void	setAlphaEnabled (bool alpha_enabled)
void	setCurrentToCustomColor ()
void	updatePalettes ()
void	updatePaletteRecent ()
void	updatePaletteStandard ()
void	updatePaletteCustom ()
Signals
void	colorChanged (const QColor &color)
Public Member Functions
	KLFColorChooseWidget (QWidget *parent=0)
virtual	~KLFColorChooseWidget ()
QColor	color () const
bool	alphaEnabled () const
Static Public Member Functions
static void	ensureColorListsInstance ()
static void	setRecentCustomColors (QList< QColor > recentcolors, QList< QColor > customcolors)
static void	addRecentColor (const QColor &col)
static QList< QColor >	recentColors ()
static QList< QColor >	customColors ()
Protected Slots
virtual void	internalColorChanged (const QColor &newcolor)
virtual void	internalColorNameSelected (QListWidgetItem *item)
virtual void	internalColorNameSet (const QString &colorname)
Properties
QColor	color
bool	alphaEnabled

---

Detailed Description

A widget that displays a full-featured selection of sliders, spin boxes and standard color controls that prompts the user to select a color.

Set the color with setColor(), and retrieve it with color(). When the user changes the color, a colorChanged() signal is emitted.

You can allow or forbid the user to select transparent colors with setAlphaEnabled().

For the "recent colors" and "custom colors" feature to work, you will have to manually save those color lists into your application settings:

• upon starting up your application, read those color lists from some settings (eg. QSettings) and set them with the static function setRecentCustomColors().
• upon shutting down your application, save the recentColors() and customColors() to your settings.

Definition at line 328 of file klfcolorchooser.h.

---

Constructor & Destructor Documentation

KLFColorChooseWidget::KLFColorChooseWidget

(

QWidget *

parent = 0

)

Definition at line 595 of file klfcolorchooser.cpp.

References QList::append(), colorChanged(), QColor::colorNames(), ensureColorListsInstance(), QPixmap::fill(), KLFFlowLayout::FlushBegin, internalColorChanged(), internalColorNameSelected(), internalColorNameSet(), QPalette::setColor(), setCurrentToCustomColor(), KLFFlowLayout::setFlush(), QList::size(), updatePaletteCustom(), updatePaletteRecent(), updatePalettes(), and updatePaletteStandard().

virtual KLFColorChooseWidget::~KLFColorChooseWidget

(

)

[inline, virtual]

Definition at line 336 of file klfcolorchooser.h.

---

Member Function Documentation

void KLFColorChooseWidget::addRecentColor

(

const QColor &

col

)

[static]

Definition at line 875 of file klfcolorchooser.cpp.

References ensureColorListsInstance().

bool KLFColorChooseWidget::alphaEnabled

(

)

const [inline]

Definition at line 340 of file klfcolorchooser.h.

QColor KLFColorChooseWidget::color

(

)

const [inline]

Definition at line 338 of file klfcolorchooser.h.

Referenced by internalColorNameSelected(), and internalColorNameSet().

void KLFColorChooseWidget::colorChanged

(

const QColor &

color

)

[signal]

Referenced by internalColorChanged(), and KLFColorChooseWidget().

QList< QColor > KLFColorChooseWidget::customColors

(

)

[static]

Definition at line 588 of file klfcolorchooser.cpp.

References ensureColorListsInstance().

void KLFColorChooseWidget::ensureColorListsInstance

(

)

[static]

Definition at line 864 of file klfcolorchooser.cpp.

Referenced by addRecentColor(), customColors(), KLFColorChooseWidget(), recentColors(), and setRecentCustomColors().

void KLFColorChooseWidget::internalColorChanged

(

const QColor &

newcolor

)

[protected, virtual, slot]

Definition at line 694 of file klfcolorchooser.cpp.

References colorChanged(), QColor::name(), QColor::setAlpha(), and QList::size().

Referenced by internalColorNameSelected(), internalColorNameSet(), KLFColorChooseWidget(), and setColor().

void KLFColorChooseWidget::internalColorNameSelected

(

QListWidgetItem *

item

)

[protected, virtual, slot]

Definition at line 718 of file klfcolorchooser.cpp.

References color(), and internalColorChanged().

Referenced by KLFColorChooseWidget().

void KLFColorChooseWidget::internalColorNameSet

(

const QString &

colorname

)

[protected, virtual, slot]

Definition at line 726 of file klfcolorchooser.cpp.

References color(), QRegExp::exactMatch(), internalColorChanged(), klfDbg, and QString::startsWith().

Referenced by KLFColorChooseWidget().

QList< QColor > KLFColorChooseWidget::recentColors

(

)

[static]

Definition at line 582 of file klfcolorchooser.cpp.

References ensureColorListsInstance().

void KLFColorChooseWidget::setAlphaEnabled

(

bool

alpha_enabled

)

[slot]

Definition at line 792 of file klfcolorchooser.cpp.

References QColor::setAlpha(), and setColor().

void KLFColorChooseWidget::setColor

(

const QColor &

color

)

[slot]

Definition at line 782 of file klfcolorchooser.cpp.

References internalColorChanged(), and QColor::rgb().

Referenced by setAlphaEnabled().

void KLFColorChooseWidget::setCurrentToCustomColor

(

)

[slot]

Definition at line 835 of file klfcolorchooser.cpp.

References updatePaletteCustom().

Referenced by KLFColorChooseWidget().

void KLFColorChooseWidget::setRecentCustomColors	(	QList< QColor >	recentcolors,
		QList< QColor >	customcolors
	)		[static]

Definition at line 573 of file klfcolorchooser.cpp.

References ensureColorListsInstance().

void KLFColorChooseWidget::updatePaletteCustom

(

)

[slot]

Definition at line 856 of file klfcolorchooser.cpp.

Referenced by KLFColorChooseWidget(), setCurrentToCustomColor(), and updatePalettes().

void KLFColorChooseWidget::updatePaletteRecent

(

)

[slot]

Definition at line 848 of file klfcolorchooser.cpp.

Referenced by KLFColorChooseWidget(), and updatePalettes().

void KLFColorChooseWidget::updatePalettes

(

)

[slot]

Definition at line 841 of file klfcolorchooser.cpp.

References updatePaletteCustom(), updatePaletteRecent(), and updatePaletteStandard().

Referenced by KLFColorChooseWidget().

void KLFColorChooseWidget::updatePaletteStandard

(

)

[slot]

Definition at line 852 of file klfcolorchooser.cpp.

Referenced by KLFColorChooseWidget(), and updatePalettes().

---

Property Documentation

bool KLFColorChooseWidget::alphaEnabled [read, write]

Definition at line 333 of file klfcolorchooser.h.

QColor KLFColorChooseWidget::color [read, write]

Definition at line 332 of file klfcolorchooser.h.

---

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

• src/klftools/klfcolorchooser.h
• src/klftools/klfcolorchooser.cpp