Class: QgsStyle

class qgis.core.QgsStyle

Bases: PyQt5.QtCore.QObject

Constructor for QgsStyle.

Methods

addColorRamp

Adds a color ramp to the style.

addFavorite

Adds the specified symbol to favorites

addSmartgroup

Adds a new smartgroup to the database and returns the id.

addSymbol

Adds a symbol to style and takes symbol’s ownership

addTag

Adds a new tag and returns the tag’s id

childEvent

clear

Removes all contents of the style

colorRamp

Returns a new copy of the specified color ramp.

colorRampCount

Returns count of color ramps

colorRampNames

Returns a list of names of color ramps

colorRampRef

Returns a const pointer to a symbol (doesn’t create new instance)

colorrampId

Returns the id in the style database for the given colorramp name returns 0 if not found

connectNotify

createDatabase

Creates an on-disk database

createMemoryDatabase

Creates a temporary memory database

createTables

Creates tables structure for new database

customEvent

defaultStyle

Returns default application-wide style

detagSymbol

Detags the symbol with the given list

disconnectNotify

errorString

Returns last error from load/save operation

exportXml

Exports the style as a XML file

fileName

Returns current file name of the style

findSymbols

Returns the names of the symbols which have a matching ‘substring’ in its definition

importXml

Imports the symbols and colorramps into the default style database from the given XML file

isSignalConnected

isXmlStyleFile

Tests if the file at path is a QGIS style XML file.

load

Loads a file into the style

receivers

remove

Removes the specified entity from the db

removeColorRamp

Removes color ramp from style (and delete it)

removeFavorite

Removes the specified symbol from favorites

removeSymbol

Removes symbol from style (and delete it)

rename

Renames the given entity with the specified id

renameColorRamp

Changes ramp’s name

renameSymbol

Renames a symbol from oldName to newName.

save

Saves style into a file (will use current filename if empty string is passed)

saveColorRamp

Adds the colorramp to the DB

saveSymbol

Adds the symbol to the DB with the tags

sender

senderSignalIndex

smartgroup

Returns the QgsSmartConditionMap for the given id

smartgroupId

Returns the DB id for the given smartgroup name

smartgroupNames

Returns the smart groups list

smartgroupOperator

Returns the operator for the smartgroup clumsy implementation TODO create a class for smartgroups

smartgroupsListMap

Returns the smart groups map with id as key and name as value

symbol

Returns a NEW copy of symbol

symbolCount

Returns count of symbols in style

symbolHasTag

Returns whether a given tag is associated with the symbol

symbolId

Returns the id in the style database for the given symbol name returns 0 if not found

symbolNames

Returns a list of names of symbols

symbolRef

Returns a const pointer to a symbol (doesn’t create new instance)

symbolsOfFavorite

Returns the symbol names which are flagged as favorite

symbolsOfSmartgroup

Returns the symbols for the smartgroup

symbolsWithTag

Returns the symbol names with which have the given tag

tag

Returns the tag name for the given id

tagId

Returns the DB id for the given tag name

tagSymbol

Tags the symbol with the tags in the list

tags

Returns a list of all tags in the style database

tagsOfSymbol

Returns the tags associated with the symbol

timerEvent

Signals

entityTagsChanged

Emitted whenever an entity’s tags are changed.

favoritedChanged

Emitted whenever an entity is either favorited or un-favorited.

groupsModified

Is emitted every time a tag or smartgroup has been added, removed, or renamed [signal]

rampAdded

Emitted whenever a color ramp has been added to the style and the database has been updated as a result.

rampChanged

Emitted whenever a color ramp’s definition is changed.

rampRemoved

Emitted whenever a color ramp has been removed from the style and the database has been updated as a result.

rampRenamed

Emitted whenever a color ramp has been renamed from oldName to newName

symbolChanged

Emitted whenever a symbol’s definition is changed.

symbolRemoved

Emitted whenever a symbol has been removed from the style and the database has been updated as a result.

symbolRenamed

Emitted whenever a symbol has been renamed from oldName to newName

symbolSaved

Emitted every time a new symbol has been added to the database.

Attributes

ColorrampEntity

SmartgroupEntity

SymbolEntity

TagEntity

ColorrampEntity = 2
SmartgroupEntity = 3
class StyleEntity

Bases: int

SymbolEntity = 0
TagEntity = 1
addColorRamp(self, name: str, colorRamp: QgsColorRamp, update: bool = False) → bool

Adds a color ramp to the style. Calling this method takes the ramp’s ownership.

Note

Adding a color ramp with the name of existing one replaces it.

Parameters
  • name (str) – is the name of the color ramp being added or updated

  • colorRamp (QgsColorRamp) – is the color ramp. Ownership is transferred.

  • update (bool = False) – set to true when the style DB has to be updated, by default it is false

Return type

bool

Returns

success status of the operation

addFavorite(self, type: QgsStyle.StyleEntity, name: str) → bool

Adds the specified symbol to favorites

Parameters
  • type (QgsStyle.StyleEntity) – is either SymbolEntity of ColorrampEntity

  • name (str) – is the name of the symbol or coloramp whose is to be added to favorites

Return type

bool

Returns

returns the success state as bool

addSmartgroup(self, name: str, op: str, matchTag: Iterable[str], noMatchTag: Iterable[str], matchName: Iterable[str], noMatchName: Iterable[str]) → int

Adds a new smartgroup to the database and returns the id.

Parameters
  • name (str) – is the name of the new Smart Group to be added

  • op (str) – is the operator between the conditions; AND/OR as QString

  • matchTag (Iterable[str]) – list of strings to match within tags

  • noMatchTag (Iterable[str]) – list of strings to exclude matches from tags

  • matchName (Iterable[str]) – list of string to match within names

  • noMatchName (Iterable[str]) – list of strings to exclude matches from names

New in version 3.4.

Return type

int

addSymbol(self, name: str, symbol: QgsSymbol, update: bool = False) → bool

Adds a symbol to style and takes symbol’s ownership

Note

Adding a symbol with the name of existing one replaces it.

Parameters
  • name (str) – is the name of the symbol being added or updated

  • symbol (QgsSymbol) – is the Vector symbol

  • update (bool = False) – set to true when the style DB has to be updated, by default it is false

Return type

bool

Returns

success status of the operation

addTag(self, tagName: str) → int

Adds a new tag and returns the tag’s id

Parameters

tagName (str) – the name of the new tag to be created

Return type

int

Returns

returns an int, which is the DB id of the new tag created, 0 if the tag couldn’t be created

childEvent()
clear(self)

Removes all contents of the style

colorRamp(self, name: str) → QgsColorRamp

Returns a new copy of the specified color ramp. The caller takes responsibility for deleting the returned object.

Parameters

name (str) –

Return type

QgsColorRamp

colorRampCount(self) → int

Returns count of color ramps

Return type

int

colorRampNames(self) → List[str]

Returns a list of names of color ramps

Return type

List[str]

colorRampRef(self, name: str) → QgsColorRamp

Returns a const pointer to a symbol (doesn’t create new instance)

Parameters

name (str) –

Return type

QgsColorRamp

colorrampId(self, name: str) → int

Returns the id in the style database for the given colorramp name returns 0 if not found

Parameters

name (str) –

Return type

int

connectNotify()
createDatabase(self, filename: str) → bool

Creates an on-disk database

This function creates a new on-disk permanent style database.

Return type

bool

Returns

returns the success state of the database creation

New in version 3.0.

Parameters

filename (str) –

createMemoryDatabase(self) → bool

Creates a temporary memory database

This function is used to create a temporary style database in case a permanent on-disk database is not needed.

Return type

bool

Returns

returns the success state of the temporary memory database creation

See also

createDatabase()

New in version 3.0.

createTables(self)

Creates tables structure for new database

This function is used to create the tables structure in a newly-created database.

Returns

returns the success state of the temporary memory database creation

See also

createDatabase()

New in version 3.0.

customEvent()
defaultStyle() → QgsStyle

Returns default application-wide style

Return type

QgsStyle

detagSymbol(self, type: QgsStyle.StyleEntity, symbol: str, tags: Iterable[str]) → bool

Detags the symbol with the given list

Removes the given tags for the specified symbol or colorramp

Parameters
  • type (QgsStyle.StyleEntity) – is either SymbolEntity or ColorrampEntity

  • symbol (str) – is the name of the symbol or colorramp

  • tags (Iterable[str]) – is the list of tags that are to be removed as QStringList

Returns

returns the success state of the operation

detagSymbol(self, type: QgsStyle.StyleEntity, symbol: str) -> bool Clears the symbol from all attached tags

Removes all tags for the specified symbol or colorramp

Parameters
  • type – is either SymbolEntity or ColorrampEntity

  • symbol – is the name of the symbol or colorramp

Return type

bool

Returns

returns the success state of the operation

disconnectNotify()
entityTagsChanged

Emitted whenever an entity’s tags are changed.

New in version 3.4: [signal]

errorString(self) → str

Returns last error from load/save operation

Return type

str

exportXml(self, filename: str) → bool

Exports the style as a XML file

Parameters

filename (str) –

Return type

bool

favoritedChanged

Emitted whenever an entity is either favorited or un-favorited.

New in version 3.4: [signal]

fileName(self) → str

Returns current file name of the style

Return type

str

findSymbols(self, type: QgsStyle.StyleEntity, qword: str) → List[str]

Returns the names of the symbols which have a matching ‘substring’ in its definition

Parameters
  • type (QgsStyle.StyleEntity) – is either SymbolEntity or ColorrampEntity

  • qword (str) – is the query string to search the symbols or colorramps.

Return type

List[str]

Returns

A QStringList of the matched symbols or colorramps

groupsModified

Is emitted every time a tag or smartgroup has been added, removed, or renamed [signal]

importXml(self, filename: str) → bool

Imports the symbols and colorramps into the default style database from the given XML file

Parameters

filename (str) –

Return type

bool

isSignalConnected()
isXmlStyleFile(path: str) → bool

Tests if the file at path is a QGIS style XML file.

This method samples only the first line in the file, so is safe to call on large xml files.

New in version 3.6.

Parameters

path (str) –

Return type

bool

load(self, filename: str) → bool

Loads a file into the style

This function will load an on-disk database and populate styles.

Parameters

filename (str) – location of the database to load styles from

Return type

bool

Returns

returns the success state of the database being loaded

rampAdded

Emitted whenever a color ramp has been added to the style and the database has been updated as a result.

See also

rampRemoved()

See also

symbolSaved()

New in version 3.4: [signal]

rampChanged

Emitted whenever a color ramp’s definition is changed. This does not include name or tag changes.

See also

rampAdded()

New in version 3.4: [signal]

rampRemoved

Emitted whenever a color ramp has been removed from the style and the database has been updated as a result.

See also

rampAdded()

See also

symbolRemoved()

New in version 3.4: [signal]

rampRenamed

Emitted whenever a color ramp has been renamed from oldName to newName

See also

symbolRenamed()

New in version 3.4: [signal]

receivers()
remove(self, type: QgsStyle.StyleEntity, id: int) → bool

Removes the specified entity from the db

Parameters
  • type (QgsStyle.StyleEntity) – is any of the style entities. Refer enum StyleEntity.

  • id (int) – is the DB id of the entity to be removed

Return type

bool

removeColorRamp(self, name: str) → bool

Removes color ramp from style (and delete it)

Parameters

name (str) –

Return type

bool

removeFavorite(self, type: QgsStyle.StyleEntity, name: str) → bool

Removes the specified symbol from favorites

Parameters
  • type (QgsStyle.StyleEntity) – is either SymbolEntity of ColorrampEntity

  • name (str) – is the name of the symbol or coloramp whose is to be removed from favorites

Return type

bool

Returns

returns the success state as bool

removeSymbol(self, name: str) → bool

Removes symbol from style (and delete it)

Parameters

name (str) –

Return type

bool

rename(self, type: QgsStyle.StyleEntity, id: int, newName: str) → bool

Renames the given entity with the specified id

Parameters
  • type (QgsStyle.StyleEntity) – is any of the style entities. Refer enum StyleEntity.

  • id (int) – is the DB id of the entity which is to be renamed

  • newName (str) – is the new name of the entity

Return type

bool

renameColorRamp(self, oldName: str, newName: str) → bool

Changes ramp’s name

Parameters
  • oldName (str) –

  • newName (str) –

Return type

bool

renameSymbol(self, oldName: str, newName: str) → bool

Renames a symbol from oldName to newName.

Returns true if symbol was successfully renamed.

Parameters
  • oldName (str) –

  • newName (str) –

Return type

bool

save(self, filename: str = '') → bool

Saves style into a file (will use current filename if empty string is passed)

Parameters

filename (str = '') –

Return type

bool

saveColorRamp(self, name: str, ramp: QgsColorRamp, favorite: bool, tags: Iterable[str]) → bool

Adds the colorramp to the DB

Parameters
  • name (str) – is the name of the colorramp as QString

  • ramp (QgsColorRamp) – is the pointer to the new QgsColorRamp being saved

  • favorite (bool) – is a boolean value to specify whether the colorramp should be added to favorites

  • tags (Iterable[str]) – is a list of tags that are associated with the color ramp as a QStringList.

Return type

bool

Returns

returns the success state of the save operation

saveSymbol(self, name: str, symbol: QgsSymbol, favorite: bool, tags: Iterable[str]) → bool

Adds the symbol to the DB with the tags

Parameters
  • name (str) – is the name of the symbol as QString

  • symbol (QgsSymbol) – is the pointer to the new QgsSymbol being saved

  • favorite (bool) – is a boolean value to specify whether the symbol should be added to favorites

  • tags (Iterable[str]) – is a list of tags that are associated with the symbol as a QStringList.

Return type

bool

Returns

returns the success state of the save operation

sender()
senderSignalIndex()
smartgroup(self, id: int) → object

Returns the QgsSmartConditionMap for the given id

Parameters

id (int) –

Return type

object

smartgroupId(self, smartgroup: str) → int

Returns the DB id for the given smartgroup name

Parameters

smartgroup (str) –

Return type

int

smartgroupNames(self) → List[str]

Returns the smart groups list

Return type

List[str]

smartgroupOperator(self, id: int) → str

Returns the operator for the smartgroup clumsy implementation TODO create a class for smartgroups

Parameters

id (int) –

Return type

str

smartgroupsListMap(self) → Dict[int, str]

Returns the smart groups map with id as key and name as value

Return type

Dict[int, str]

symbol(self, name: str) → QgsSymbol

Returns a NEW copy of symbol

Parameters

name (str) –

Return type

QgsSymbol

symbolChanged

Emitted whenever a symbol’s definition is changed. This does not include name or tag changes.

See also

symbolSaved()

New in version 3.4: [signal]

symbolCount(self) → int

Returns count of symbols in style

Return type

int

symbolHasTag(self, type: QgsStyle.StyleEntity, symbol: str, tag: str) → bool

Returns whether a given tag is associated with the symbol

Parameters
  • type (QgsStyle.StyleEntity) – is either SymbolEntity or ColorrampEntity

  • symbol (str) – is the name of the symbol or color ramp

  • tag (str) – the name of the tag to look for

Return type

bool

Returns

A boolean value identicating whether a tag was found attached to the symbol

symbolId(self, name: str) → int

Returns the id in the style database for the given symbol name returns 0 if not found

Parameters

name (str) –

Return type

int

symbolNames(self) → List[str]

Returns a list of names of symbols

Return type

List[str]

symbolRef(self, name: str) → QgsSymbol

Returns a const pointer to a symbol (doesn’t create new instance)

Parameters

name (str) –

Return type

QgsSymbol

symbolRemoved

Emitted whenever a symbol has been removed from the style and the database has been updated as a result.

See also

symbolSaved()

See also

rampRemoved()

New in version 3.4: [signal]

symbolRenamed

Emitted whenever a symbol has been renamed from oldName to newName

See also

rampRenamed()

New in version 3.4: [signal]

symbolSaved

Emitted every time a new symbol has been added to the database. Emitted whenever a symbol has been added to the style and the database has been updated as a result.

See also

symbolRemoved()

See also

rampAdded()

See also

symbolChanged() [signal]

symbolsOfFavorite(self, type: QgsStyle.StyleEntity) → List[str]

Returns the symbol names which are flagged as favorite

Parameters

type (QgsStyle.StyleEntity) – is either SymbolEntity or ColorampEntity

Return type

List[str]

Returns

A QStringList of the symbol or colorramp names flagged as favorite

symbolsOfSmartgroup(self, type: QgsStyle.StyleEntity, id: int) → List[str]

Returns the symbols for the smartgroup

Parameters
Return type

List[str]

symbolsWithTag(self, type: QgsStyle.StyleEntity, tagid: int) → List[str]

Returns the symbol names with which have the given tag

Parameters
  • type (QgsStyle.StyleEntity) – is either SymbolEntity or ColorampEntity

  • tagid (int) – is id of the tag which has been applied over the symbol as int

Return type

List[str]

Returns

A QStringList of the symbol or colorramp names for the given tag id

tag(self, id: int) → str

Returns the tag name for the given id

Parameters

id (int) –

Return type

str

tagId(self, tag: str) → int

Returns the DB id for the given tag name

Parameters

tag (str) –

Return type

int

tagSymbol(self, type: QgsStyle.StyleEntity, symbol: str, tags: Iterable[str]) → bool

Tags the symbol with the tags in the list

Applies the given tags to the given symbol or colorramp

Parameters
  • type (QgsStyle.StyleEntity) – is either SymbolEntity or ColorrampEntity

  • symbol (str) – is the name of the symbol or colorramp as QString

  • tags (Iterable[str]) – is the list of the tags that are to be applied as QStringList

Return type

bool

Returns

returns the success state of the operation

tags(self) → List[str]

Returns a list of all tags in the style database

See also

addTag()

New in version 2.16.

Return type

List[str]

tagsOfSymbol(self, type: QgsStyle.StyleEntity, symbol: str) → List[str]

Returns the tags associated with the symbol

Parameters
  • type (QgsStyle.StyleEntity) – is either SymbolEntity or ColorrampEntity

  • symbol (str) – is the name of the symbol or color ramp

Return type

List[str]

Returns

A QStringList of the tags that have been applied to that symbol/colorramp

timerEvent()