Subgroup: Color

Class: QgsColorSwatchGridAction

class qgis.gui.QgsColorSwatchGridAction(scheme: QgsColorScheme, menu: QMenu = None, context: str = '', parent: QWidget = None)

Bases: PyQt5.QtWidgets.QWidgetAction

Construct a new color swatch grid action.

Parameters:
  • scheme – QgsColorScheme for colors to show in grid
  • menu – parent menu
  • context – context string provided to color scheme
  • parent – parent widget

A color swatch grid which can be embedded into a menu.

New in version 2.5: Methods

baseColor Gets the base color for the color grid
childEvent
connectNotify
context Gets the current context for the color grid
createWidget
createdWidgets
customEvent
deleteWidget
disconnectNotify
dismissOnColorSelection Returns whether the parent menu will be dismissed after a color is selected from the action’s color widget.
event
eventFilter
isSignalConnected
receivers
refreshColors Reload colors from scheme and redraws the widget
sender
senderSignalIndex
setBaseColor Sets the base color for the color grid
setContext Sets the current context for the color grid
setDismissOnColorSelection Sets whether the parent menu should be dismissed and closed when a color is selected from the action’s color widget.
timerEvent

Signals

colorChanged Emitted when a color has been selected from the widget

Attributes

baseColor(self) → QColor

Gets the base color for the color grid

Returns:base color which is passed to scheme for color generation

See also

setBaseColor()

childEvent()
colorChanged

Emitted when a color has been selected from the widget

Parameters:color – selected color [signal]
connectNotify()
context(self) → str

Gets the current context for the color grid

Returns:context string which is passed to scheme for color generation

See also

setContext()

createWidget()
createdWidgets()
customEvent()
deleteWidget()
disconnectNotify()
dismissOnColorSelection(self) → bool

Returns whether the parent menu will be dismissed after a color is selected from the action’s color widget.

New in version 2.14.

event()
eventFilter()
isSignalConnected()
receivers()
refreshColors(self)

Reload colors from scheme and redraws the widget

sender()
senderSignalIndex()
setBaseColor(self, baseColor: Union[QColor, Qt.GlobalColor, QGradient])

Sets the base color for the color grid

Parameters:baseColor – base color to pass to scheme for color generation

See also

baseColor()

setContext(self, context: str)

Sets the current context for the color grid

Parameters:context – string which is passed to scheme for color generation

See also

context()

setDismissOnColorSelection(self, dismiss: bool)

Sets whether the parent menu should be dismissed and closed when a color is selected from the action’s color widget.

Parameters:dismiss – set to true (default) to immediately close the menu when a color is selected from the widget. If set to false, the colorChanged signal will be emitted but the menu will stay open.

New in version 2.14.

timerEvent()