Class: QgsRendererCategory

class qgis.core.QgsRendererCategory

Bases: sip.wrapper

Constructor for QgsRendererCategory.

QgsRendererCategory(value: Any, symbol: QgsSymbol, label: str, render: bool = True) Constructor for a new QgsRendererCategory, with the specified value and symbol.

If value is a list, then the category will match any of the values from this list.

The ownership of symbol is transferred to the category.

The label argument specifies the label used for this category in legends and the layer tree.

The render argument indicates whether the category should initially be rendered and appear checked in the layer tree.

QgsRendererCategory(cat: QgsRendererCategory) Copy constructor.

Represents an individual category (class) from a QgsCategorizedSymbolRenderer.

Methods

dump

Returns a string representing the categories settings, used for debugging purposes only.

label

Returns the label for this category, which is used to represent the category within legends and the layer tree.

renderState

Returns True if the category is currently enabled and should be rendered.

setLabel

Sets the label for this category, which is used to represent the category within legends and the layer tree.

setRenderState

Sets whether the category is currently enabled and should be rendered.

setSymbol

Sets the symbol which will be used to render this category.

setValue

Sets the value corresponding to this category.

swap

param other

symbol

Returns the symbol which will be used to render this category.

toSld

Converts the category to a matching SLD rule, within the specified DOM document and element.

value

Returns the value corresponding to this category.

dump(self) → str

Returns a string representing the categories settings, used for debugging purposes only.

Return type

str

label(self) → str

Returns the label for this category, which is used to represent the category within legends and the layer tree.

See also

setLabel()

Return type

str

renderState(self) → bool

Returns True if the category is currently enabled and should be rendered.

See also

setRenderState()

New in version 2.5.

Return type

bool

setLabel(self, label: str)

Sets the label for this category, which is used to represent the category within legends and the layer tree.

See also

label()

Parameters

label (str) –

setRenderState(self, render: bool)

Sets whether the category is currently enabled and should be rendered.

See also

renderState()

New in version 2.5.

Parameters

render (bool) –

setSymbol(self, s: QgsSymbol)

Sets the symbol which will be used to render this category.

Ownership of the symbol is transferred to the category.

See also

symbol()

Parameters

s (QgsSymbol) –

setValue(self, value: Any)

Sets the value corresponding to this category.

If value is a list, then the category will match any of the values from this list.

See also

value()

Parameters

value (Any) –

swap(self, other: QgsRendererCategory)
Parameters

other (QgsRendererCategory) –

symbol(self)QgsSymbol

Returns the symbol which will be used to render this category.

See also

setSymbol()

Return type

QgsSymbol

toSld(self, doc: QDomDocument, element: QDomElement, props: Dict[str, str])

Converts the category to a matching SLD rule, within the specified DOM document and element.

Parameters
  • doc (QDomDocument) –

  • element (QDomElement) –

  • props (Dict[str) –

value(self) → Any

Returns the value corresponding to this category.

If the returned value is a list, then the category will match any of the values from this list.

See also

setValue()

Return type

Any