QgsColorPreviewWidget Class Reference

A preview box which displays one or two colors as swatches. More...

#include <qgscolorwidgets.h>

Inheritance diagram for QgsColorPreviewWidget:

Public Slots
virtual void	setColor2 (const QColor &color)
	Sets the second color for the widget.
Public Slots inherited from QgsColorWidget
virtual void	setColor (const QColor &color, bool emitSignals=false)
	Sets the color for the widget.
virtual void	setComponent (QgsColorWidget::ColorComponent component)
	Sets the color component which the widget controls.
virtual Q_DECL_DEPRECATED void	setComponentValue (int value)
	Alters the widget's color by setting the value for the widget's color component.
virtual void	setComponentValueF (float value)
	Alters the widget's color by setting the value for the widget's color component.

Public Member Functions
	QgsColorPreviewWidget (QWidget *parent=nullptr)
	Construct a new color preview widget.
QColor	color2 () const
	Returns the secondary color for the widget.
void	paintEvent (QPaintEvent *event) override
QSize	sizeHint () const override
Public Member Functions inherited from QgsColorWidget
	QgsColorWidget (QWidget *parent=nullptr, ColorComponent component=Multiple)
	Construct a new color widget.
QColor	color () const
	Returns the current color for the widget.
ColorComponent	component () const
	Returns the color component which the widget controls.
Q_DECL_DEPRECATED int	componentValue () const
	Returns the current value of the widget's color component.
float	componentValueF () const
	Returns the current value of the widget's color component.

Protected Member Functions
void	mouseMoveEvent (QMouseEvent *e) override
void	mousePressEvent (QMouseEvent *e) override
void	mouseReleaseEvent (QMouseEvent *e) override
Protected Member Functions inherited from QgsColorWidget
QColor::Spec	colorSpec () const
	Returns color widget type of color, either RGB, HSV, CMYK, or Invalid if this component value is Multiple or Alpha.
int	componentRange () const
	Returns the range of valid values for the color widget's component.
Q_DECL_DEPRECATED int	componentValue (ColorComponent component) const
	Returns the value of a component of the widget's current color.
float	componentValueF (ColorComponent component) const
	Returns the value of a component of the widget's current color.
void	dragEnterEvent (QDragEnterEvent *e) override
void	dropEvent (QDropEvent *e) override
Q_DECL_DEPRECATED int	hue () const
	Returns the hue for the widget.
float	hueF () const
	Returns the hue for the widget.
void	mouseMoveEvent (QMouseEvent *e) override
void	mousePressEvent (QMouseEvent *e) override
void	mouseReleaseEvent (QMouseEvent *e) override

Additional Inherited Members
Public Types inherited from QgsColorWidget
enum	ColorComponent {   Multiple = 0 , Red , Green , Blue ,   Hue , Saturation , Value , Alpha ,   Cyan , Magenta , Yellow , Black }
	Specifies the color component which the widget alters. More...
enum class	ComponentUnit { Scaled0to255 , Percent , Degree }
	Specified the color component unit. More...
Signals inherited from QgsColorWidget
void	colorChanged (const QColor &color)
	Emitted when the widget's color changes.
void	hovered ()
	Emitted when mouse hovers over widget.
Static Public Member Functions inherited from QgsColorWidget
static ComponentUnit	componentUnit (ColorComponent component)
	Returns color component unit.
static QPixmap	createDragIcon (const QColor &color)
	Create an icon for dragging colors.
Static Protected Member Functions inherited from QgsColorWidget
static Q_DECL_DEPRECATED void	alterColor (QColor &color, QgsColorWidget::ColorComponent component, int newValue)
	Alters a color by modifying the value of a specific color component.
static void	alterColorF (QColor &color, QgsColorWidget::ColorComponent component, float newValue)
	Alters a color by modifying the value of a specific color component.
static QColor::Spec	colorSpec (QgsColorWidget::ColorComponent component)
	Returns component type of color, either RGB, HSV, CMYK, or Invalid if component value is Multiple or Alpha.
static int	componentRange (ColorComponent component)
	Returns the range of valid values a color component.
static const QPixmap &	transparentBackground ()
	Generates a checkboard pattern pixmap for use as a background to transparent colors.
Protected Attributes inherited from QgsColorWidget
ColorComponent	mComponent
QColor	mCurrentColor
float	mExplicitHue = 0
	QColor wipes the hue information when it is ambiguous (e.g., for saturation = 0).

Detailed Description

A preview box which displays one or two colors as swatches.

Definition at line 824 of file qgscolorwidgets.h.

Constructor & Destructor Documentation

QgsColorPreviewWidget()

QgsColorPreviewWidget::QgsColorPreviewWidget

(

QWidget *

parent = nullptr

)

Construct a new color preview widget.

Parameters

parent

parent QWidget for the widget

Definition at line 1712 of file qgscolorwidgets.cpp.

Member Function Documentation

color2()

QColor QgsColorPreviewWidget::color2 ( ) const

inline

Returns the secondary color for the widget.

Returns

secondary widget color, or an invalid color if the widget has no secondary color

See also

color

setColor2

Definition at line 845 of file qgscolorwidgets.h.

mouseMoveEvent()

void QgsColorPreviewWidget::mouseMoveEvent ( QMouseEvent *  e )

overrideprotected

Definition at line 1817 of file qgscolorwidgets.cpp.

mousePressEvent()

void QgsColorPreviewWidget::mousePressEvent ( QMouseEvent *  e )

overrideprotected

Definition at line 1785 of file qgscolorwidgets.cpp.

mouseReleaseEvent()

void QgsColorPreviewWidget::mouseReleaseEvent ( QMouseEvent *  e )

overrideprotected

Definition at line 1794 of file qgscolorwidgets.cpp.

paintEvent()

void QgsColorPreviewWidget::paintEvent ( QPaintEvent *  event )

override

Definition at line 1750 of file qgscolorwidgets.cpp.

setColor2

void QgsColorPreviewWidget::setColor2 ( const QColor &  color )

virtualslot

Sets the second color for the widget.

Parameters

color

secondary widget color. Set to an invalid color to prevent drawing of a secondary color

See also

setColor

color2

Definition at line 1775 of file qgscolorwidgets.cpp.

sizeHint()

QSize QgsColorPreviewWidget::sizeHint ( ) const

override

Definition at line 1770 of file qgscolorwidgets.cpp.

---

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

• /build/qgis-3.41.0+git20241225+af5edcb665c+99sid/src/gui/qgscolorwidgets.h
• /build/qgis-3.41.0+git20241225+af5edcb665c+99sid/src/gui/qgscolorwidgets.cpp