QGIS API Documentation  3.37.0-Master (a5b4d9743e8)
Public Slots | Signals | Public Member Functions | Static Public Member Functions | Protected Member Functions | List of all members
QgsColorDialog Class Reference

A custom QGIS dialog for selecting a color. More...

#include <qgscolordialog.h>

Inheritance diagram for QgsColorDialog:
Inheritance graph
[legend]

Public Slots

void setColor (const QColor &color)
 Sets the current color for the dialog. More...
 

Signals

void currentColorChanged (const QColor &color)
 Emitted when the dialog's color changes. More...
 

Public Member Functions

 QgsColorDialog (QWidget *parent=nullptr, Qt::WindowFlags fl=QgsGuiUtils::ModalDialogFlags, const QColor &color=QColor())
 Create a new color picker dialog. More...
 
QColor color () const
 Returns the current color for the dialog. More...
 
void setAllowOpacity (bool allowOpacity)
 Sets whether opacity modification (transparency) is permitted for the color dialog. More...
 
void setTitle (const QString &title)
 Sets the title for the color dialog. More...
 

Static Public Member Functions

static QColor getColor (const QColor &initialColor, QWidget *parent, const QString &title=QString(), bool allowOpacity=false)
 Returns a color selection from a color dialog. More...
 

Protected Member Functions

void closeEvent (QCloseEvent *e) override
 

Detailed Description

A custom QGIS dialog for selecting a color.

Has many improvements over the standard Qt color picker dialog, including hue wheel supports, color swatches, and a color sampler.

Definition at line 35 of file qgscolordialog.h.

Constructor & Destructor Documentation

◆ QgsColorDialog()

QgsColorDialog::QgsColorDialog ( QWidget *  parent = nullptr,
Qt::WindowFlags  fl = QgsGuiUtils::ModalDialogFlags,
const QColor &  color = QColor() 
)

Create a new color picker dialog.

Parameters
parentparent widget
flwindow flags
colorinitial color for dialog

Definition at line 30 of file qgscolordialog.cpp.

Member Function Documentation

◆ closeEvent()

void QgsColorDialog::closeEvent ( QCloseEvent *  e)
overrideprotected

Definition at line 150 of file qgscolordialog.cpp.

◆ color()

QColor QgsColorDialog::color ( ) const

Returns the current color for the dialog.

Returns
dialog color

Definition at line 62 of file qgscolordialog.cpp.

◆ currentColorChanged

void QgsColorDialog::currentColorChanged ( const QColor &  color)
signal

Emitted when the dialog's color changes.

Parameters
colorcurrent color

◆ getColor()

QColor QgsColorDialog::getColor ( const QColor &  initialColor,
QWidget *  parent,
const QString &  title = QString(),
bool  allowOpacity = false 
)
static

Returns a color selection from a color dialog.

Parameters
initialColorthe initial color of the selection dialog.
parentparent widget
titlethe title of the dialog.
allowOpacityset to true to allow modification of color opacity value (transparency)
Returns
Selected color on accepted() or initialColor on rejected().

Definition at line 78 of file qgscolordialog.cpp.

◆ setAllowOpacity()

void QgsColorDialog::setAllowOpacity ( bool  allowOpacity)

Sets whether opacity modification (transparency) is permitted for the color dialog.

Defaults to true.

Parameters
allowOpacityset to false to disable opacity modification

Definition at line 72 of file qgscolordialog.cpp.

◆ setColor

void QgsColorDialog::setColor ( const QColor &  color)
slot

Sets the current color for the dialog.

Parameters
colordesired color

Definition at line 132 of file qgscolordialog.cpp.

◆ setTitle()

void QgsColorDialog::setTitle ( const QString &  title)

Sets the title for the color dialog.

Parameters
titletitle for dialog box

Definition at line 67 of file qgscolordialog.cpp.


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