A base class for interactive color widgets. More...

#include <qgscolorwidgets.h>

Inheritance diagram for QgsColorWidget:

Public Types
enum	ColorComponent { Multiple = 0, Red, Green, Blue, Hue, Saturation, Value, Alpha }

Public Slots
virtual void	setColor (const QColor color, const bool emitSignals=false)
	Sets the color for the widget.
virtual void	setComponent (const ColorComponent component)
	Sets the color component which the widget controls.
virtual void	setComponentValue (const int value)
	Alters the widget's color by setting the value for the widget's color component.

Signals
void	colorChanged (const QColor color)
	Emitted when the widget's color changes.

Public Member Functions
	QgsColorWidget (QWidget *parent=0, const ColorComponent component=Multiple)
	Construct a new color widget.
virtual	~QgsColorWidget ()
QColor	color () const
	Returns the current color for the widget.
ColorComponent	component () const
	Returns the color component which the widget controls.
int	componentValue () const
	Returns the current value of the widget's color component.

Static Public Member Functions
static QPixmap	createDragIcon (const QColor color)
	Create an icon for dragging colors.

Protected Member Functions
int	componentRange () const
	Returns the range of valid values for the color widget's component.
int	componentRange (const ColorComponent component) const
	Returns the range of valid values a color component.
int	componentValue (const ColorComponent component) const
	Returns the value of a component of the widget's current color.
int	hue () const
	Returns the hue for the widget.
void	alterColor (QColor &color, const QgsColorWidget::ColorComponent component, const int newValue) const
	Alters a color by modifiying the value of a specific color component.
void	dragEnterEvent (QDragEnterEvent *e)
void	dropEvent (QDropEvent *e)

Static Protected Member Functions
static const QPixmap &	transparentBackground ()
	Generates a checkboard pattern pixmap for use as a background to transparent colors.

Protected Attributes
QColor	mCurrentColor
ColorComponent	mComponent
int	mExplicitHue
	QColor wipes the hue information when it is ambiguous (eg, for saturation = 0).

Detailed Description

A base class for interactive color widgets.

Widgets can either allow setting a single component of a color (eg the red or green components), or an entire color. The QgsColorWidget also keeps track of any explicitly set hue for the color, so that this information is not lost when the widget is set to a color with an ambiguous hue (eg black or white shades).

Note: Added in version 2.5

Member Enumeration Documentation

enum QgsColorWidget::ColorComponent

Specifies the color component which the widget alters

Enumerator:

Multiple	widget alters multiple color components
Red	red component of color
Green	green component of color
Blue	blue component of color
Hue	hue component of color (based on HSV model)
Saturation	saturation component of color (based on HSV model)
Value	value component of color (based on HSV model)
Alpha	alpha component (opacity) of color

Constructor & Destructor Documentation

QgsColorWidget::QgsColorWidget	(	QWidget *	parent = `0`,
		const ColorComponent	component = `Multiple`
	)

Construct a new color widget.

Parameters

parent	parent QWidget for the widget
component	color component the widget alters

QgsColorWidget::~QgsColorWidget ( )

virtual

Member Function Documentation

void QgsColorWidget::alterColor	(	QColor &	color,
		const QgsColorWidget::ColorComponent	component,
		const int	newValue
	)		const

protected

Alters a color by modifiying the value of a specific color component.

Parameters

color	color to alter
component	color component to alter
newValue	new value of color component. Values are automatically clipped to a valid range for the color component.

QColor QgsColorWidget::color ( void ) const

Returns the current color for the widget.

Returns: current widget color

See Also: setColor

void QgsColorWidget::colorChanged ( const QColor color )

signal

Emitted when the widget's color changes.

Parameters

color new widget color

ColorComponent QgsColorWidget::component ( ) const

inline

Returns the color component which the widget controls.

Returns: color component for widget

See Also: setComponent

int QgsColorWidget::componentRange ( ) const

protected

Returns the range of valid values for the color widget's component.

Returns: maximum value allowed for color component, or -1 if widget has multiple components

int QgsColorWidget::componentRange ( const ColorComponent component ) const

protected

Returns the range of valid values a color component.

Returns: maximum value allowed for color component

int QgsColorWidget::componentValue ( ) const

Returns the current value of the widget's color component.

Returns: value of color component, or -1 if widget has multiple components or an invalid color set

See Also: setComponentValue; component

int QgsColorWidget::componentValue ( const ColorComponent component ) const

protected

Returns the value of a component of the widget's current color.

This method correctly handles hue values when the color has an ambiguous hue (eg black or white shades)

Parameters

component color component to return

Returns: value of color component, or -1 if widget has an invalid color set

See Also: hue

QPixmap QgsColorWidget::createDragIcon ( const QColor color )

static

Create an icon for dragging colors.

Parameters

color for icon

void QgsColorWidget::dragEnterEvent ( QDragEnterEvent * e )

protected

void QgsColorWidget::dropEvent ( QDropEvent * e )

protected

int QgsColorWidget::hue ( ) const

protected

Returns the hue for the widget.

This may differ from the hue for the QColor returned by color(), as QColor returns a hue of -1 if the color's hue is ambiguous (eg, if the saturation is zero).

Returns: explicitly set hue for widget

void QgsColorWidget::setColor	(	const QColor	color,
		const bool	emitSignals = `false`
	)

virtualslot

Sets the color for the widget.

Parameters

color	widget color
emitSignals	set to true to emit the colorChanged signal after setting color

See Also: color

Reimplemented in QgsColorTextWidget, and QgsColorSliderWidget.

void QgsColorWidget::setComponent ( const ColorComponent component )

virtualslot

Sets the color component which the widget controls.

Parameters

component color component for widget

See Also: component

Reimplemented in QgsColorSliderWidget, and QgsColorBox.

void QgsColorWidget::setComponentValue ( const int value )

virtualslot

Alters the widget's color by setting the value for the widget's color component.

Parameters

value value for widget's color component. This value is automatically clipped to the range of valid values for the color component.

See Also: componentValue; setComponent

Note: this method has no effect if the widget is set to the QgsColorWidget::Multiple component

Reimplemented in QgsColorSliderWidget.

const QPixmap & QgsColorWidget::transparentBackground ( )

staticprotected

Generates a checkboard pattern pixmap for use as a background to transparent colors.

Returns: checkerboard pixmap

Member Data Documentation

ColorComponent QgsColorWidget::mComponent

protected

QColor QgsColorWidget::mCurrentColor

protected

int QgsColorWidget::mExplicitHue

protected

QColor wipes the hue information when it is ambiguous (eg, for saturation = 0).

So the hue is stored in mExplicit hue to keep it around, as it is useful when modifying colors

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

/tmp/buildd/qgis-2.6.0+wheezy1/src/gui/qgscolorwidgets.h
/tmp/buildd/qgis-2.6.0+wheezy1/src/gui/qgscolorwidgets.cpp

Public Types

Public Slots

Signals

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation