A cross platform button subclass for selecting color ramps. More...

#include <qgscolorrampbutton.h>

Inheritance diagram for QgsColorRampButton:

Public Slots
void	setButtonBackground (QgsColorRamp *colorramp=nullptr)
	Sets the background pixmap for the button based upon current color ramp.

void	setColorRamp (QgsColorRamp *colorramp)
	Sets the current color ramp for the button.

void	setColorRampFromName (const QString &name=QString())
	Sets the current color ramp for the button using a saved color ramp name.

void	setRandomColorRamp ()
	Sets the current color ramp for the button to random colors.

void	setToDefaultColorRamp ()
	Sets color ramp to the button's default color ramp, if set.

void	setToNull ()
	Sets color ramp to null.

Signals
void	colorRampChanged ()
	Emitted whenever a new color ramp is set for the button.

Public Member Functions
	QgsColorRampButton (QWidget *parent=nullptr, const QString &dialogTitle=QString())
	Construct a new color ramp button.

	~QgsColorRampButton () override

bool	acceptLiveUpdates () const
	Returns whether the button accepts live updates from QgsColorRampDialog.

QgsColorRamp *	colorRamp () const
	Returns a copy of the current color ramp.

QString	colorRampDialogTitle () const
	Returns the title for the color ramp dialog window.

QString	colorRampName () const
	Returns the name of the current color ramp when it's available in the style manager.

QString	context () const
	Returns the context string for the color ramp button.

QgsColorRamp *	defaultColorRamp () const
	Returns a copy of the default color ramp for the button, which is shown in the button's drop-down menu for the "default color ramp" option.

bool	isNull () const
	Returns `true` if the current color ramp is null.

bool	isRandomColorRamp () const
	Returns `true` if the current color ramp is random.

void	setAcceptLiveUpdates (const bool accept)
	Sets whether the button accepts live updates from QgsColorRampDialog.

void	setColorRampDialogTitle (const QString &title)
	Set the title for the color ramp dialog window.

void	setColorRampName (const QString &name)
	Sets the name of the current color ramp when it's available in the style manager.

void	setContext (const QString &context)
	Sets the context string for the color ramp button.

void	setDefaultColorRamp (QgsColorRamp *colorramp)
	Sets the default color ramp for the button, which is shown in the button's drop-down menu for the "default color ramp" option.

void	setShowGradientOnly (bool gradientonly)
	Sets whether the color ramp button only shows gradient type ramps.

void	setShowMenu (bool showMenu)
	Sets whether the drop-down menu should be shown for the button.

void	setShowNull (bool showNull)
	Sets whether a set to null (clear) option is shown in the button's drop-down menu.

void	setShowRandomColorRamp (bool showRandom)
	Sets whether a random colors option is shown in the button's drop-down menu.

bool	showGradientOnly () const
	Returns `true` if the color ramp button only shows gradient type ramps.

bool	showMenu () const
	Returns whether the drop-down menu is shown for the button.

bool	showNull () const
	Returns whether the set to null (clear) option is shown in the button's drop-down menu.

bool	showRandomColorRamp () const
	Returns whether random colors option is shown in the button's drop-down menu.

QSize	sizeHint () const override

Protected Member Functions
void	changeEvent (QEvent *e) override

bool	event (QEvent *e) override

void	mousePressEvent (QMouseEvent *e) override
	Reimplemented to detect right mouse button clicks on the color ramp button.

void	resizeEvent (QResizeEvent *event) override

void	showEvent (QShowEvent *e) override

Properties
bool	acceptLiveUpdates

QString	colorRampDialogTitle

QString	context

QgsColorRamp *	defaultColorRamp

bool	showMenu

Detailed Description

A cross platform button subclass for selecting color ramps.

Will open color ramp dialogs when clicked. Offers live updates to button from color ramp dialog. An attached drop-down menu allows for access to saved color ramps, as well as option to invert the current color ramp and create new ramps.

Definition at line 35 of file qgscolorrampbutton.h.

Constructor & Destructor Documentation

◆ QgsColorRampButton()

QgsColorRampButton::QgsColorRampButton	(	QWidget *	parent = `nullptr`,
		const QString &	dialogTitle = `QString()`
	)

Construct a new color ramp button.

Use parent to attach a parent QWidget to the dialog. Use dialogTitle string to define the title to show in the color ramp dialog

Definition at line 39 of file qgscolorrampbutton.cpp.

◆ ~QgsColorRampButton()

QgsColorRampButton::~QgsColorRampButton ( )

overridedefault

Member Function Documentation

◆ acceptLiveUpdates()

bool QgsColorRampButton::acceptLiveUpdates ( ) const

inline

Returns whether the button accepts live updates from QgsColorRampDialog.

Returns: true if the button will be accepted immediately when the dialog's color ramp changes

See also: setAcceptLiveUpdates

Definition at line 82 of file qgscolorrampbutton.h.

◆ changeEvent()

void QgsColorRampButton::changeEvent ( QEvent * e )

overrideprotected

Definition at line 438 of file qgscolorrampbutton.cpp.

◆ colorRamp()

QgsColorRamp * QgsColorRampButton::colorRamp ( ) const

Returns a copy of the current color ramp.

See also: setColorRamp()

Definition at line 579 of file qgscolorrampbutton.cpp.

◆ colorRampChanged

void QgsColorRampButton::colorRampChanged ( )

signal

Emitted whenever a new color ramp is set for the button.

The color ramp is always valid. In case the new color ramp is the same, no signal is emitted to avoid infinite loops.

◆ colorRampDialogTitle()

QString QgsColorRampButton::colorRampDialogTitle ( ) const

Returns the title for the color ramp dialog window.

Returns: title for the color ramp dialog

See also: setColorRampDialogTitle

Definition at line 589 of file qgscolorrampbutton.cpp.

◆ colorRampName()

QString QgsColorRampButton::colorRampName ( ) const

inline

Returns the name of the current color ramp when it's available in the style manager.

See also: setColorRampName

Definition at line 209 of file qgscolorrampbutton.h.

◆ context()

QString QgsColorRampButton::context ( ) const

inline

Returns the context string for the color ramp button.

The context string is passed to all color ramp preview icons shown in the button's drop-down menu, to (eventually) allow them to customize their display colors based on the context.

Returns: context context string for the color dialog button's color ramp preview icons

See also: setContext

Definition at line 183 of file qgscolorrampbutton.h.

◆ defaultColorRamp()

QgsColorRamp * QgsColorRampButton::defaultColorRamp ( ) const

Returns a copy of the default color ramp for the button, which is shown in the button's drop-down menu for the "default color ramp" option.

Returns: default color ramp for the button. Returns nullptr if the default color ramp option is disabled. Caller takes ownership of the returned object.

See also: setDefaultColorRamp

Definition at line 613 of file qgscolorrampbutton.cpp.

◆ event()

bool QgsColorRampButton::event ( QEvent * e )

overrideprotected

Definition at line 184 of file qgscolorrampbutton.cpp.

◆ isNull()

bool QgsColorRampButton::isNull ( ) const

Returns true if the current color ramp is null.

See also: setShowNull(); showNull()

Definition at line 633 of file qgscolorrampbutton.cpp.

◆ isRandomColorRamp()

bool QgsColorRampButton::isRandomColorRamp ( ) const

Returns true if the current color ramp is random.

See also: setShowNull(); showNull()

Definition at line 618 of file qgscolorrampbutton.cpp.

◆ mousePressEvent()

void QgsColorRampButton::mousePressEvent ( QMouseEvent * e )

overrideprotected

Reimplemented to detect right mouse button clicks on the color ramp button.

Definition at line 196 of file qgscolorrampbutton.cpp.

◆ resizeEvent()

void QgsColorRampButton::resizeEvent ( QResizeEvent * event )

overrideprotected

Definition at line 465 of file qgscolorrampbutton.cpp.

◆ setAcceptLiveUpdates()

void QgsColorRampButton::setAcceptLiveUpdates ( const bool accept )

inline

Sets whether the button accepts live updates from QgsColorRampDialog.

Live updates may cause changes that are not undoable on QColorRampDialog cancel.

Parameters

accept set to true to enable live updates

See also: acceptLiveUpdates

Definition at line 90 of file qgscolorrampbutton.h.

◆ setButtonBackground

void QgsColorRampButton::setButtonBackground ( QgsColorRamp * colorramp = nullptr )

slot

Sets the background pixmap for the button based upon current color ramp.

Parameters

colorramp Color ramp for button background. If no color ramp is specified, the button's current color ramp will be used

Definition at line 508 of file qgscolorrampbutton.cpp.

◆ setColorRamp

void QgsColorRampButton::setColorRamp ( QgsColorRamp * colorramp )

slot

Sets the current color ramp for the button.

Will emit a colorRampChanged() signal if the color ramp is different to the previous color ramp.

Parameters

colorramp New color ramp for the button. The ramp will be cloned and ownership is not transferred.

See also: setRandomColorRamp; setColorRampFromName; colorRamp

Definition at line 473 of file qgscolorrampbutton.cpp.

◆ setColorRampDialogTitle()

void QgsColorRampButton::setColorRampDialogTitle ( const QString & title )

Set the title for the color ramp dialog window.

Parameters

title Title for the color ramp dialog

See also: colorRampDialogTitle

Definition at line 584 of file qgscolorrampbutton.cpp.

◆ setColorRampFromName

void QgsColorRampButton::setColorRampFromName ( const QString & name = QString() )

slot

Sets the current color ramp for the button using a saved color ramp name.

Will emit a colorRampChanged() signal if the color ramp is different to the previous color ramp.

Parameters

name	Name of saved color ramp

See also: setColorRamp; setRandomColorRamp; colorRamp

Definition at line 487 of file qgscolorrampbutton.cpp.

◆ setColorRampName()

void QgsColorRampButton::setColorRampName ( const QString & name )

inline

Sets the name of the current color ramp when it's available in the style manager.

Parameters

name	Name of the saved color ramp

See also: colorRampName

Definition at line 203 of file qgscolorrampbutton.h.

◆ setContext()

void QgsColorRampButton::setContext ( const QString & context )

inline

Sets the context string for the color ramp button.

The context string is passed to all color ramp preview icons shown in the button's drop-down menu, to (eventually) allow them to customize their display colors based on the context.

Parameters

context context string for the color dialog button's color ramp preview icons

See also: context

Definition at line 174 of file qgscolorrampbutton.h.

◆ setDefaultColorRamp()

void QgsColorRampButton::setDefaultColorRamp ( QgsColorRamp * colorramp )

Sets the default color ramp for the button, which is shown in the button's drop-down menu for the "default color ramp" option.

Parameters

colorramp default color ramp for the button. Set to nullptr to disable the default color ramp option. The ramp will be cloned and ownership is not transferred.

See also: defaultColorRamp

Definition at line 608 of file qgscolorrampbutton.cpp.

◆ setRandomColorRamp

void QgsColorRampButton::setRandomColorRamp ( )

slot

Sets the current color ramp for the button to random colors.

Will emit a colorRampChanged() signal if the color ramp is different to the previous color ramp.

See also: setColorRamp; setColorRampFromName; colorRamp

Definition at line 499 of file qgscolorrampbutton.cpp.

◆ setShowGradientOnly()

void QgsColorRampButton::setShowGradientOnly ( bool gradientonly )

inline

Sets whether the color ramp button only shows gradient type ramps.

Parameters

gradientonly set to true to show only gradient type ramps

See also: showGradientOnly

Definition at line 190 of file qgscolorrampbutton.h.

◆ setShowMenu()

void QgsColorRampButton::setShowMenu ( bool showMenu )

Sets whether the drop-down menu should be shown for the button.

The default behavior is to show the menu.

Parameters

showMenu set to false to hide the drop-down menu

See also: showMenu

Definition at line 594 of file qgscolorrampbutton.cpp.

◆ setShowNull()

void QgsColorRampButton::setShowNull ( bool showNull )

Sets whether a set to null (clear) option is shown in the button's drop-down menu.

Parameters

showNull set to true to show a null option

See also: showNull(); isNull()

Definition at line 623 of file qgscolorrampbutton.cpp.

◆ setShowRandomColorRamp()

void QgsColorRampButton::setShowRandomColorRamp ( bool showRandom )

inline

Sets whether a random colors option is shown in the button's drop-down menu.

Parameters

showRandom set to true to show a random colors option

See also: showRandomColorRamp()

Definition at line 130 of file qgscolorrampbutton.h.

◆ setToDefaultColorRamp

void QgsColorRampButton::setToDefaultColorRamp ( )

slot

Sets color ramp to the button's default color ramp, if set.

See also: setDefaultColorRamp; defaultColorRamp; setToNull()

Definition at line 169 of file qgscolorrampbutton.cpp.

◆ setToNull

void QgsColorRampButton::setToNull ( )

slot

Sets color ramp to null.

See also: setToDefaultColorRamp()

Definition at line 179 of file qgscolorrampbutton.cpp.

◆ showEvent()

void QgsColorRampButton::showEvent ( QShowEvent * e )

overrideprotected

Definition at line 459 of file qgscolorrampbutton.cpp.

◆ showGradientOnly()

bool QgsColorRampButton::showGradientOnly ( ) const

inline

Returns true if the color ramp button only shows gradient type ramps.

See also: setShowGradientOnly

Definition at line 196 of file qgscolorrampbutton.h.

◆ showMenu()

bool QgsColorRampButton::showMenu ( ) const

Returns whether the drop-down menu is shown for the button.

Returns: true if drop-down menu is shown

See also: setShowMenu

Definition at line 603 of file qgscolorrampbutton.cpp.

◆ showNull()

bool QgsColorRampButton::showNull ( ) const

Returns whether the set to null (clear) option is shown in the button's drop-down menu.

See also: setShowNull(); isNull()

Definition at line 628 of file qgscolorrampbutton.cpp.

◆ showRandomColorRamp()

bool QgsColorRampButton::showRandomColorRamp ( ) const

inline

Returns whether random colors option is shown in the button's drop-down menu.

See also: setShowRandomColorRamp()

Definition at line 136 of file qgscolorrampbutton.h.

◆ sizeHint()

QSize QgsColorRampButton::sizeHint ( ) const

override

Definition at line 62 of file qgscolorrampbutton.cpp.

Property Documentation

◆ acceptLiveUpdates

bool QgsColorRampButton::acceptLiveUpdates

readwrite

Definition at line 39 of file qgscolorrampbutton.h.

◆ colorRampDialogTitle

QString QgsColorRampButton::colorRampDialogTitle

readwrite

Definition at line 38 of file qgscolorrampbutton.h.

◆ context

QString QgsColorRampButton::context

readwrite

Definition at line 42 of file qgscolorrampbutton.h.

◆ defaultColorRamp

QgsColorRamp * QgsColorRampButton::defaultColorRamp

readwrite

Definition at line 41 of file qgscolorrampbutton.h.

◆ showMenu

bool QgsColorRampButton::showMenu

readwrite

Definition at line 40 of file qgscolorrampbutton.h.

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

/build/qgis-3.41.0+git20241201+3c143d501a8+99sid/src/gui/qgscolorrampbutton.h
/build/qgis-3.41.0+git20241201+3c143d501a8+99sid/src/gui/qgscolorrampbutton.cpp

Public Slots

Signals

Public Member Functions

Protected Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ QgsColorRampButton()

◆ ~QgsColorRampButton()

Member Function Documentation

◆ acceptLiveUpdates()

◆ changeEvent()

◆ colorRamp()

◆ colorRampChanged

◆ colorRampDialogTitle()

◆ colorRampName()

◆ context()

◆ defaultColorRamp()

◆ event()

◆ isNull()

◆ isRandomColorRamp()

◆ mousePressEvent()

◆ resizeEvent()

◆ setAcceptLiveUpdates()

◆ setButtonBackground

◆ setColorRamp

◆ setColorRampDialogTitle()

◆ setColorRampFromName

◆ setColorRampName()

◆ setContext()

◆ setDefaultColorRamp()

◆ setRandomColorRamp

◆ setShowGradientOnly()

◆ setShowMenu()

◆ setShowNull()

◆ setShowRandomColorRamp()

◆ setToDefaultColorRamp

◆ setToNull

◆ showEvent()

◆ showGradientOnly()

◆ showMenu()

◆ showNull()

◆ showRandomColorRamp()

◆ sizeHint()

Property Documentation

◆ acceptLiveUpdates

◆ colorRampDialogTitle

◆ context

◆ defaultColorRamp

◆ showMenu