Abstract base class for color schemes. More...

#include <qgscolorscheme.h>

Inheritance diagram for QgsColorScheme:

[legend]

Public Types
enum	SchemeFlag { ShowInColorDialog = 0x01, ShowInColorButtonMenu = 0x02, ShowInAllContexts = ShowInColorDialog \| ShowInColorButtonMenu }
	Flags for controlling behaviour of color scheme. More...

Public Member Functions
	QgsColorScheme ()

virtual	~QgsColorScheme ()

virtual QgsColorScheme *	clone () const =0
	Clones a color scheme. More...

virtual QgsNamedColorList	fetchColors (const QString &context=QString(), const QColor &baseColor=QColor())=0
	Gets a list of colors from the scheme. More...

virtual SchemeFlags	flags () const
	Returns the current flags for the color scheme. More...

virtual bool	isEditable () const
	Returns whether the color scheme is editable. More...

virtual QString	schemeName () const =0
	Gets the name for the color scheme. More...

virtual bool	setColors (const QgsNamedColorList &colors, const QString &context=QString(), const QColor &baseColor=QColor())
	Sets the colors for the scheme. More...

Detailed Description

Abstract base class for color schemes.

A color scheme for display in QgsColorButtonV2. Color schemes return lists of colors with an optional associated color name. The colors returned can be generated using an optional base color.

Note: Added in version 2.5

Definition at line 41 of file qgscolorscheme.h.

Member Enumeration Documentation

◆ SchemeFlag

enum QgsColorScheme::SchemeFlag

Flags for controlling behaviour of color scheme.

Enumerator
ShowInColorDialog	show scheme in color picker dialog
ShowInColorButtonMenu	show scheme in color button drop down menu
ShowInAllContexts	show scheme in all contexts

Definition at line 47 of file qgscolorscheme.h.

Constructor & Destructor Documentation

◆ QgsColorScheme()

QgsColorScheme::QgsColorScheme ( )

Definition at line 27 of file qgscolorscheme.cpp.

◆ ~QgsColorScheme()

QgsColorScheme::~QgsColorScheme ( )

virtual

Definition at line 32 of file qgscolorscheme.cpp.

Member Function Documentation

◆ clone()

virtual QgsColorScheme* QgsColorScheme::clone ( ) const

pure virtual

Clones a color scheme.

Returns: copy of color scheme

Implemented in QgsProjectColorScheme, QgsCustomColorScheme, QgsRecentColorScheme, and QgsUserColorScheme.

◆ fetchColors()

virtual QgsNamedColorList QgsColorScheme::fetchColors	(	const QString &	context = `QString()`,
		const QColor &	baseColor = `QColor()`
	)

pure virtual

Gets a list of colors from the scheme.

The colors can optionally be generated using the supplied context and base color.

Parameters

context	string specifiying an optional context for the returned colors. For instance, a "recent colors" scheme may filter returned colors by context so that colors used only in a "composer" context are returned.
baseColor	base color for the scheme's colors. Some color schemes may take advantage of this to filter or modify their returned colors to colors related to the base color.