QGIS API Documentation  3.20.0-Odense (decaadbb31)
Public Slots | Signals | Public Member Functions | Protected Member Functions | List of all members
QgsGradientStopEditor Class Reference

An interactive editor for previewing a gradient color ramp and modifying the position of color stops along the gradient. More...

#include <qgsgradientstopeditor.h>

Inheritance diagram for QgsGradientStopEditor:
Inheritance graph
[legend]

Public Slots

void deleteSelectedStop ()
 Deletes the current selected stop. More...
 
void setColor1 (const QColor &color)
 Sets the color for the first stop. More...
 
void setColor2 (const QColor &color)
 Sets the color for the last stop. More...
 
void setSelectedStopColor (const QColor &color)
 Sets the color for the current selected stop. More...
 
void setSelectedStopDetails (const QColor &color, double offset)
 Sets the color and offset for the current selected stop. More...
 
void setSelectedStopOffset (double offset)
 Sets the offset for the current selected stop. More...
 

Signals

void changed ()
 Emitted when the gradient ramp is changed by a user. More...
 
void selectedStopChanged (const QgsGradientStop &stop)
 Emitted when the current selected stop changes. More...
 

Public Member Functions

 QgsGradientStopEditor (QWidget *parent=nullptr, QgsGradientColorRamp *ramp=nullptr)
 Constructor for QgsGradientStopEditor. More...
 
QgsGradientColorRamp gradientRamp () const
 Returns the current ramp created by the editor. More...
 
void paintEvent (QPaintEvent *event) override
 
QgsGradientStop selectedStop () const
 Returns details about the currently selected stop. More...
 
void selectStop (int index)
 Sets the currently selected stop. More...
 
void setGradientRamp (const QgsGradientColorRamp &ramp)
 Sets the current ramp shown in the editor. More...
 
QSize sizeHint () const override
 

Protected Member Functions

void dragEnterEvent (QDragEnterEvent *e) override
 
void dropEvent (QDropEvent *e) override
 
void keyPressEvent (QKeyEvent *event) override
 
void mouseDoubleClickEvent (QMouseEvent *event) override
 
void mouseMoveEvent (QMouseEvent *event) override
 
void mousePressEvent (QMouseEvent *event) override
 

Detailed Description

An interactive editor for previewing a gradient color ramp and modifying the position of color stops along the gradient.

Since
QGIS 2.16

Definition at line 33 of file qgsgradientstopeditor.h.

Constructor & Destructor Documentation

◆ QgsGradientStopEditor()

QgsGradientStopEditor::QgsGradientStopEditor ( QWidget *  parent = nullptr,
QgsGradientColorRamp ramp = nullptr 
)

Constructor for QgsGradientStopEditor.

Parameters
parentparent widget
rampoptional initial gradient ramp

Definition at line 32 of file qgsgradientstopeditor.cpp.

Member Function Documentation

◆ changed

void QgsGradientStopEditor::changed ( )
signal

Emitted when the gradient ramp is changed by a user.

◆ deleteSelectedStop

void QgsGradientStopEditor::deleteSelectedStop ( )
slot

Deletes the current selected stop.

This slot has no effect if either the first or last stop is selected, as they cannot be deleted.

Definition at line 226 of file qgsgradientstopeditor.cpp.

◆ dragEnterEvent()

void QgsGradientStopEditor::dragEnterEvent ( QDragEnterEvent *  e)
overrideprotected

Definition at line 443 of file qgsgradientstopeditor.cpp.

◆ dropEvent()

void QgsGradientStopEditor::dropEvent ( QDropEvent *  e)
overrideprotected

Definition at line 456 of file qgsgradientstopeditor.cpp.

◆ gradientRamp()

QgsGradientColorRamp QgsGradientStopEditor::gradientRamp ( ) const
inline

Returns the current ramp created by the editor.

See also
setGradientRamp()

Definition at line 57 of file qgsgradientstopeditor.h.

◆ keyPressEvent()

void QgsGradientStopEditor::keyPressEvent ( QKeyEvent *  event)
overrideprotected

Definition at line 347 of file qgsgradientstopeditor.cpp.

◆ mouseDoubleClickEvent()

void QgsGradientStopEditor::mouseDoubleClickEvent ( QMouseEvent *  event)
overrideprotected

Definition at line 332 of file qgsgradientstopeditor.cpp.

◆ mouseMoveEvent()

void QgsGradientStopEditor::mouseMoveEvent ( QMouseEvent *  event)
overrideprotected

Definition at line 257 of file qgsgradientstopeditor.cpp.

◆ mousePressEvent()

void QgsGradientStopEditor::mousePressEvent ( QMouseEvent *  event)
overrideprotected

Definition at line 317 of file qgsgradientstopeditor.cpp.

◆ paintEvent()

void QgsGradientStopEditor::paintEvent ( QPaintEvent *  event)
override

Definition at line 75 of file qgsgradientstopeditor.cpp.

◆ selectedStop()

QgsGradientStop QgsGradientStopEditor::selectedStop ( ) const

Returns details about the currently selected stop.

See also
selectStop()

Definition at line 159 of file qgsgradientstopeditor.cpp.

◆ selectedStopChanged

void QgsGradientStopEditor::selectedStopChanged ( const QgsGradientStop stop)
signal

Emitted when the current selected stop changes.

Parameters
stopdetails about newly selected stop

◆ selectStop()

void QgsGradientStopEditor::selectStop ( int  index)

Sets the currently selected stop.

Parameters
indexindex of stop, where 0 corresponds to the first stop
See also
selectedStop()

Definition at line 136 of file qgsgradientstopeditor.cpp.

◆ setColor1

void QgsGradientStopEditor::setColor1 ( const QColor &  color)
slot

Sets the color for the first stop.

Parameters
colornew stop color
See also
setColor2()
setSelectedStopColor()

Definition at line 243 of file qgsgradientstopeditor.cpp.

◆ setColor2

void QgsGradientStopEditor::setColor2 ( const QColor &  color)
slot

Sets the color for the last stop.

Parameters
colornew stop color
See also
setColor1()
setSelectedStopColor()

Definition at line 250 of file qgsgradientstopeditor.cpp.

◆ setGradientRamp()

void QgsGradientStopEditor::setGradientRamp ( const QgsGradientColorRamp ramp)

Sets the current ramp shown in the editor.

Parameters
rampcolor ramp
See also
gradientRamp()

Definition at line 60 of file qgsgradientstopeditor.cpp.

◆ setSelectedStopColor

void QgsGradientStopEditor::setSelectedStopColor ( const QColor &  color)
slot

Sets the color for the current selected stop.

Parameters
colornew stop color
See also
setSelectedStopOffset()
setSelectedStopDetails()
setColor1()
setColor2()

Definition at line 175 of file qgsgradientstopeditor.cpp.

◆ setSelectedStopDetails

void QgsGradientStopEditor::setSelectedStopDetails ( const QColor &  color,
double  offset 
)
slot

Sets the color and offset for the current selected stop.

Parameters
colornew stop color
offsetnew stop offset
See also
setSelectedStopColor()
setSelectedStopOffset()

Definition at line 205 of file qgsgradientstopeditor.cpp.

◆ setSelectedStopOffset

void QgsGradientStopEditor::setSelectedStopOffset ( double  offset)
slot

Sets the offset for the current selected stop.

This slot has no effect if either the first or last stop is selected, as they cannot be repositioned.

Parameters
offsetnew stop offset
See also
setSelectedStopColor()
setSelectedStopDetails()

Definition at line 194 of file qgsgradientstopeditor.cpp.

◆ sizeHint()

QSize QgsGradientStopEditor::sizeHint ( ) const
override

Definition at line 69 of file qgsgradientstopeditor.cpp.


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