QGIS API Documentation  2.8.2-Wien
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
Public Types | Public Member Functions | List of all members
QgsColorScheme Class Reference

Abstract base class for color schemes. More...

#include <qgscolorscheme.h>

Inheritance diagram for QgsColorScheme:
Inheritance graph
[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 QgsColorSchemeclone () const =0
 Clones a color scheme.
virtual QgsNamedColorList fetchColors (const QString &context=QString(), const QColor &baseColor=QColor())=0
 Gets a list of colors from the scheme.
virtual SchemeFlags flags () const
 Returns the current flags for the color scheme.
virtual bool isEditable () const
 Returns whether the color scheme is editable.
virtual QString schemeName () const =0
 Gets the name for the color scheme.
virtual bool setColors (const QgsNamedColorList &colors, const QString &context=QString(), const QColor &baseColor=QColor())
 Sets the colors for the scheme.

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 39 of file qgscolorscheme.h.

Member Enumeration Documentation

Flags for controlling behaviour of color scheme.

Enumerator:
ShowInColorDialog 
ShowInColorButtonMenu 
ShowInAllContexts 

Definition at line 45 of file qgscolorscheme.h.

Constructor & Destructor Documentation

QgsColorScheme::QgsColorScheme ( )

Definition at line 27 of file qgscolorscheme.cpp.

QgsColorScheme::~QgsColorScheme ( )
virtual

Definition at line 32 of file qgscolorscheme.cpp.

Member Function Documentation

virtual QgsColorScheme* QgsColorScheme::clone ( ) const
pure virtual

Clones a color scheme.

Returns
copy of color scheme

Implemented in QgsProjectColorScheme, QgsCustomColorScheme, QgsRecentColorScheme, and QgsUserColorScheme.

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
contextstring 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.
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

Implemented in QgsProjectColorScheme, QgsCustomColorScheme, QgsRecentColorScheme, and QgsGplColorScheme.

virtual SchemeFlags QgsColorScheme::flags ( ) const
inlinevirtual

Returns the current flags for the color scheme.

Returns
current flags

Reimplemented in QgsProjectColorScheme, QgsCustomColorScheme, and QgsRecentColorScheme.

Definition at line 65 of file qgscolorscheme.h.

virtual bool QgsColorScheme::isEditable ( ) const
inlinevirtual

Returns whether the color scheme is editable.

Returns
true if scheme is editable
See Also
setColors

Reimplemented in QgsProjectColorScheme, QgsCustomColorScheme, and QgsUserColorScheme.

Definition at line 84 of file qgscolorscheme.h.

virtual QString QgsColorScheme::schemeName ( ) const
pure virtual

Gets the name for the color scheme.

Returns
color scheme name

Implemented in QgsProjectColorScheme, QgsCustomColorScheme, QgsRecentColorScheme, and QgsUserColorScheme.

bool QgsColorScheme::setColors ( const QgsNamedColorList colors,
const QString &  context = QString(),
const QColor &  baseColor = QColor() 
)
virtual

Sets the colors for the scheme.

This method is only valid for editable color schemes.

Parameters
colorslist of colors for the scheme
contextto set colors for
baseColorbase color to set colors for
Returns
true if colors were set successfully
See Also
isEditable

Reimplemented in QgsProjectColorScheme, QgsCustomColorScheme, and QgsGplColorScheme.

Definition at line 37 of file qgscolorscheme.cpp.


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