QGIS API Documentation  3.0.2-Girona (307d082)
Public Member Functions | Static Public Member Functions | List of all members
QgsPresetSchemeColorRamp Class Reference

A scheme based color ramp consisting of a list of predefined colors. More...

#include <qgscolorramp.h>

Inheritance diagram for QgsPresetSchemeColorRamp:
Inheritance graph
[legend]

Public Member Functions

 QgsPresetSchemeColorRamp (const QList< QColor > &colors=QList< QColor >())
 Constructor for QgsPresetSchemeColorRamp. More...
 
 QgsPresetSchemeColorRamp (const QgsNamedColorList &colors)
 Constructor for QgsPresetColorRamp. More...
 
QgsPresetSchemeColorRampclone () const override
 Creates a clone of the color ramp. More...
 
QColor color (double value) const override
 Returns the color corresponding to a specified value. More...
 
QList< QColor > colors () const
 Returns the list of colors used by the ramp. More...
 
int count () const override
 Returns number of defined colors, or -1 if undefined. More...
 
QgsNamedColorList fetchColors (const QString &context=QString(), const QColor &baseColor=QColor()) override
 Gets a list of colors from the scheme. More...
 
void invert () override
 Inverts the ordering of the color ramp. More...
 
bool isEditable () const override
 Returns whether the color scheme is editable. More...
 
QgsStringMap properties () const override
 Returns a string map containing all the color ramp's properties. More...
 
QString schemeName () const override
 Gets the name for the color scheme. More...
 
bool setColors (const QgsNamedColorList &colors, const QString &=QString(), const QColor &=QColor()) override
 Sets the list of colors used by the ramp. More...
 
QString type () const override
 Returns a string representing the color ramp type. More...
 
double value (int index) const override
 Returns relative value between [0,1] of color at specified index. More...
 
- Public Member Functions inherited from QgsColorRamp
virtual ~QgsColorRamp ()=default
 
- Public Member Functions inherited from QgsColorScheme
 QgsColorScheme ()=default
 Constructor for QgsColorScheme. More...
 
virtual ~QgsColorScheme ()=default
 
virtual SchemeFlags flags () const
 Returns the current flags for the color scheme. More...
 

Static Public Member Functions

static QgsColorRampcreate (const QgsStringMap &properties=QgsStringMap())
 Returns a new QgsPresetSchemeColorRamp color ramp created using the properties encoded in a string map. More...
 

Additional Inherited Members

- Public Types inherited from QgsColorScheme
enum  SchemeFlag { ShowInColorDialog = 0x01, ShowInColorButtonMenu = 0x02, ShowInAllContexts = ShowInColorDialog | ShowInColorButtonMenu }
 Flags for controlling behavior of color scheme. More...
 

Detailed Description

A scheme based color ramp consisting of a list of predefined colors.

Since
QGIS 3.0

Definition at line 471 of file qgscolorramp.h.

Constructor & Destructor Documentation

◆ QgsPresetSchemeColorRamp() [1/2]

QgsPresetSchemeColorRamp::QgsPresetSchemeColorRamp ( const QList< QColor > &  colors = QList< QColor >())

Constructor for QgsPresetSchemeColorRamp.

Parameters
colorslist of colors in ramp

Definition at line 810 of file qgscolorramp.cpp.

◆ QgsPresetSchemeColorRamp() [2/2]

QgsPresetSchemeColorRamp::QgsPresetSchemeColorRamp ( const QgsNamedColorList colors)

Constructor for QgsPresetColorRamp.

Parameters
colorslist of named colors in ramp
Note
not available in Python bindings - use setColors instead

Definition at line 821 of file qgscolorramp.cpp.

Member Function Documentation

◆ clone()

QgsPresetSchemeColorRamp * QgsPresetSchemeColorRamp::clone ( ) const
overridevirtual

Creates a clone of the color ramp.

Implements QgsColorRamp.

Definition at line 890 of file qgscolorramp.cpp.

◆ color()

QColor QgsPresetSchemeColorRamp::color ( double  value) const
overridevirtual

Returns the color corresponding to a specified value.

Parameters
valuevalue between [0, 1] inclusive
Returns
color for value

Implements QgsColorRamp.

Definition at line 865 of file qgscolorramp.cpp.

◆ colors()

QList< QColor > QgsPresetSchemeColorRamp::colors ( ) const

Returns the list of colors used by the ramp.

See also
setColors()

Definition at line 847 of file qgscolorramp.cpp.

◆ count()

int QgsPresetSchemeColorRamp::count ( ) const
overridevirtual

Returns number of defined colors, or -1 if undefined.

Implements QgsColorRamp.

Definition at line 907 of file qgscolorramp.cpp.

◆ create()

QgsColorRamp * QgsPresetSchemeColorRamp::create ( const QgsStringMap properties = QgsStringMap())
static

Returns a new QgsPresetSchemeColorRamp color ramp created using the properties encoded in a string map.

Parameters
propertiescolor ramp properties
See also
properties()

Definition at line 829 of file qgscolorramp.cpp.

◆ fetchColors()

QgsNamedColorList QgsPresetSchemeColorRamp::fetchColors ( const QString &  context = QString(),
const QColor &  baseColor = QColor() 
)
overridevirtual

Gets a list of colors from the scheme.

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

Parameters
contextstring specifying 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.
baseColorbase 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.
Returns
a list of QPairs of color and color name

Implements QgsColorScheme.

Definition at line 912 of file qgscolorramp.cpp.

◆ invert()

void QgsPresetSchemeColorRamp::invert ( )
overridevirtual

Inverts the ordering of the color ramp.

Reimplemented from QgsColorRamp.

Definition at line 879 of file qgscolorramp.cpp.

◆ isEditable()

bool QgsPresetSchemeColorRamp::isEditable ( ) const
inlineoverridevirtual

Returns whether the color scheme is editable.

Returns
true if scheme is editable
See also
setColors

Reimplemented from QgsColorScheme.

Definition at line 519 of file qgscolorramp.h.

◆ properties()

QgsStringMap QgsPresetSchemeColorRamp::properties ( ) const
overridevirtual

Returns a string map containing all the color ramp's properties.

Implements QgsColorRamp.

Definition at line 895 of file qgscolorramp.cpp.

◆ schemeName()

QString QgsPresetSchemeColorRamp::schemeName ( ) const
inlineoverridevirtual

Gets the name for the color scheme.

Returns
color scheme name

Implements QgsColorScheme.

Definition at line 517 of file qgscolorramp.h.

◆ setColors()

bool QgsPresetSchemeColorRamp::setColors ( const QgsNamedColorList colors,
const QString &  = QString(),
const QColor &  = QColor() 
)
inlineoverridevirtual

Sets the list of colors used by the ramp.

Parameters
colorslist of colors
See also
colors()

Reimplemented from QgsColorScheme.

Definition at line 501 of file qgscolorramp.h.

◆ type()

QString QgsPresetSchemeColorRamp::type ( ) const
inlineoverridevirtual

Returns a string representing the color ramp type.

Implements QgsColorRamp.

Definition at line 511 of file qgscolorramp.h.

◆ value()

double QgsPresetSchemeColorRamp::value ( int  index) const
overridevirtual

Returns relative value between [0,1] of color at specified index.

Implements QgsColorRamp.

Definition at line 858 of file qgscolorramp.cpp.


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