KLFColorChooseWidget Class Reference

#include <klfcolorchooser.h>

Inheritance diagram for KLFColorChooseWidget:

Collaboration diagram for KLFColorChooseWidget:

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 ( )

inlinevirtual

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 )

protectedvirtualslot

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 )

protectedvirtualslot

Definition at line 718 of file klfcolorchooser.cpp.

References color(), and internalColorChanged().

Referenced by KLFColorChooseWidget().

void KLFColorChooseWidget::internalColorNameSet ( const QString &  colorname )

protectedvirtualslot

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

readwrite

Definition at line 333 of file klfcolorchooser.h.

QColor KLFColorChooseWidget::color

readwrite

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