QGIS API Documentation
2.18.21-Las Palmas (9fba24a)
|
#include <qgsstylev2.h>
Public Types | |
enum | StyleEntity { SymbolEntity, GroupEntity, TagEntity, ColorrampEntity, SmartgroupEntity } |
Enum for Entities involved in a style. More... | |
Signals | |
void | symbolSaved (const QString &name, QgsSymbolV2 *symbol) |
Public Member Functions | |
QgsStyleV2 () | |
~QgsStyleV2 () | |
bool | addColorRamp (const QString &name, QgsVectorColorRampV2 *colorRamp, bool update=false) |
add color ramp to style. takes ramp's ownership More... | |
int | addGroup (const QString &groupName, int parent=0) |
adds a new group and returns the group's id More... | |
int | addSmartgroup (const QString &name, const QString &op, const QgsSmartConditionMap &conditions) |
adds new smartgroup to the database and returns the id More... | |
bool | addSymbol (const QString &name, QgsSymbolV2 *symbol, bool update=false) |
add symbol to style. takes symbol's ownership More... | |
int | addTag (const QString &tagName) |
adds a new tag and returns the tag's id More... | |
QgsSymbolGroupMap | childGroupNames (const QString &parent="") |
return a map of groupid and names for the given parent group More... | |
void | clear () |
remove all contents of the style More... | |
QgsVectorColorRampV2 * | colorRamp (const QString &name) |
return a NEW copy of color ramp More... | |
int | colorRampCount () |
return count of color ramps More... | |
int | colorrampId (const QString &name) |
return the id in the style database for the given colorramp name returns 0 if not found More... | |
QStringList | colorRampNames () |
return a list of names of color ramps More... | |
const QgsVectorColorRampV2 * | colorRampRef (const QString &name) const |
return a const pointer to a symbol (doesn't create new instance) More... | |
bool | detagSymbol (StyleEntity type, const QString &symbol, const QStringList &tags) |
detags the symbol with the given list More... | |
QString | errorString () |
return last error from load/save operation More... | |
bool | exportXML (const QString &filename) |
Exports the style as a XML file. More... | |
QString | fileName () |
return current file name of the style More... | |
QStringList | findSymbols (StyleEntity type, const QString &qword) |
return the names of the symbols which have a matching 'substring' in its defintion More... | |
bool | group (StyleEntity type, const QString &name, int groupid) |
applies the specified group to the symbol or colorramp specified by StyleEntity More... | |
int | groupId (const QString &group) |
return the DB id for the given group name More... | |
QList< int > | groupIds () const |
return the ids of all the groups in the style More... | |
QString | groupName (int groupId) const |
return the group name for the given DB id More... | |
QStringList | groupNames () |
return the all the groups in the style More... | |
bool | importXML (const QString &filename) |
Imports the symbols and colorramps into the default style database from the given XML file. More... | |
bool | load (const QString &filename) |
load a file into the style More... | |
void | remove (StyleEntity type, int id) |
remove the specified entity from the db More... | |
bool | removeColorRamp (const QString &name) |
remove color ramp from style (and delete it) More... | |
bool | removeSymbol (const QString &name) |
remove symbol from style (and delete it) More... | |
void | rename (StyleEntity type, int id, const QString &newName) |
rename the given entity with the specified id More... | |
bool | renameColorRamp (const QString &oldName, const QString &newName) |
change ramp's name More... | |
bool | renameSymbol (const QString &oldName, const QString &newName) |
change symbol's name More... | |
bool | save (QString filename=QString()) |
save style into a file (will use current filename if empty string is passed) More... | |
bool | saveColorRamp (const QString &name, QgsVectorColorRampV2 *ramp, int groupid, const QStringList &tags) |
add the colorramp to the DB More... | |
bool | saveSymbol (const QString &name, QgsSymbolV2 *symbol, int groupid, const QStringList &tags) |
add the symbol to the DB with the tags More... | |
QgsSmartConditionMap | smartgroup (int id) |
returns the QgsSmartConditionMap for the given id More... | |
int | smartgroupId (const QString &smartgroup) |
return the DB id for the given smartgroup name More... | |
QStringList | smartgroupNames () |
returns the smart groups list More... | |
QString | smartgroupOperator (int id) |
returns the operator for the smartgroup More... | |
QgsSymbolGroupMap | smartgroupsListMap () |
returns the smart groups map with id as key and name as value More... | |
QgsSymbolV2 * | symbol (const QString &name) |
return a NEW copy of symbol More... | |
int | symbolCount () |
return count of symbols in style More... | |
int | symbolId (const QString &name) |
return the id in the style database for the given symbol name returns 0 if not found More... | |
QStringList | symbolNames () |
return a list of names of symbols More... | |
const QgsSymbolV2 * | symbolRef (const QString &name) const |
return a const pointer to a symbol (doesn't create new instance) More... | |
QStringList | symbolsOfGroup (StyleEntity type, int groupid) |
returns the symbolnames of a given groupid More... | |
QStringList | symbolsOfSmartgroup (StyleEntity type, int id) |
returns the symbols for the smartgroup More... | |
QStringList | symbolsWithTag (StyleEntity type, int tagid) |
returns the symbol names with which have the given tag More... | |
int | tagId (const QString &tag) |
return the DB id for the given tag name More... | |
QStringList | tags () const |
Returns a list of all tags in the style database. More... | |
QStringList | tagsOfSymbol (StyleEntity type, const QString &symbol) |
return the tags associated with the symbol More... | |
bool | tagSymbol (StyleEntity type, const QString &symbol, const QStringList &tags) |
tags the symbol with the tags in the list More... | |
Public Member Functions inherited from QObject | |
QObject (QObject *parent) | |
QObject (QObject *parent, const char *name) | |
virtual | ~QObject () |
bool | blockSignals (bool block) |
QObject * | child (const char *objName, const char *inheritsClass, bool recursiveSearch) const |
const QObjectList & | children () const |
const char * | className () const |
bool | connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const |
void | deleteLater () |
void | destroyed (QObject *obj) |
bool | disconnect (const QObject *receiver, const char *method) |
bool | disconnect (const char *signal, const QObject *receiver, const char *method) |
void | dumpObjectInfo () |
void | dumpObjectTree () |
QList< QByteArray > | dynamicPropertyNames () const |
virtual bool | event (QEvent *e) |
virtual bool | eventFilter (QObject *watched, QEvent *event) |
T | findChild (const QString &name) const |
QList< T > | findChildren (const QRegExp ®Exp) const |
QList< T > | findChildren (const QString &name) const |
bool | inherits (const char *className) const |
void | insertChild (QObject *object) |
void | installEventFilter (QObject *filterObj) |
bool | isA (const char *className) const |
bool | isWidgetType () const |
void | killTimer (int id) |
virtual const QMetaObject * | metaObject () const |
void | moveToThread (QThread *targetThread) |
const char * | name () const |
const char * | name (const char *defaultName) const |
QString | objectName () const |
QObject * | parent () const |
QVariant | property (const char *name) const |
void | removeChild (QObject *object) |
void | removeEventFilter (QObject *obj) |
void | setName (const char *name) |
void | setObjectName (const QString &name) |
void | setParent (QObject *parent) |
bool | setProperty (const char *name, const QVariant &value) |
bool | signalsBlocked () const |
int | startTimer (int interval) |
QThread * | thread () const |
Static Public Member Functions | |
static QgsStyleV2 * | defaultStyle () |
return default application-wide style More... | |
Static Public Member Functions inherited from QObject | |
bool | connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type) |
bool | connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type) |
bool | disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method) |
bool | disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method) |
QString | tr (const char *sourceText, const char *disambiguation, int n) |
QString | trUtf8 (const char *sourceText, const char *disambiguation, int n) |
Protected Member Functions | |
char * | getGroupRemoveQuery (int id) |
prepares the complex query for removing a group, so that the children are not abandoned More... | |
int | getId (const QString &table, const QString &name) |
gets the id from the table for the given name from the database, 0 if not found More... | |
QString | getName (const QString &table, int id) const |
gets the name from the table for the given id from the database, empty if not found More... | |
bool | openDB (const QString &filename) |
convenience function to open the DB and return a sqlite3 object More... | |
bool | runEmptyQuery (char *query, bool freeQuery=true) |
convenience function that would run queries which don't generate return values More... | |
bool | updateSymbol (StyleEntity type, const QString &name) |
updates the properties of an existing symbol/colorramp More... | |
Protected Member Functions inherited from QObject | |
bool | checkConnectArgs (const char *signal, const QObject *object, const char *method) |
virtual void | childEvent (QChildEvent *event) |
virtual void | connectNotify (const char *signal) |
virtual void | customEvent (QEvent *event) |
virtual void | disconnectNotify (const char *signal) |
int | receivers (const char *signal) const |
QObject * | sender () const |
int | senderSignalIndex () const |
virtual void | timerEvent (QTimerEvent *event) |
Protected Attributes | |
QgsVectorColorRampV2Map | mColorRamps |
sqlite3 * | mCurrentDB |
QString | mErrorString |
QString | mFileName |
QgsSymbolV2Map | mSymbols |
Static Protected Attributes | |
static QgsStyleV2 * | mDefaultStyle = nullptr |
Additional Inherited Members | |
Static Protected Member Functions inherited from QObject | |
QByteArray | normalizeSignalSlot (const char *signalSlot) |
Properties inherited from QObject | |
objectName | |
Definition at line 69 of file qgsstylev2.h.
Enum for Entities involved in a style.
The enumerator is used for identifying the entity being operated on when generic database functions are being run.
Enumerator | |
---|---|
SymbolEntity | |
GroupEntity | |
TagEntity | |
ColorrampEntity | |
SmartgroupEntity |
Definition at line 83 of file qgsstylev2.h.
QgsStyleV2::QgsStyleV2 | ( | ) |
Definition at line 41 of file qgsstylev2.cpp.
QgsStyleV2::~QgsStyleV2 | ( | ) |
Definition at line 46 of file qgsstylev2.cpp.
bool QgsStyleV2::addColorRamp | ( | const QString & | name, |
QgsVectorColorRampV2 * | colorRamp, | ||
bool | update = false |
||
) |
add color ramp to style. takes ramp's ownership
name | is the name of the color ramp being added or updated |
colorRamp | is the Vector color ramp |
update | set to true when the style DB has to be updated, by default it is false |
Definition at line 186 of file qgsstylev2.cpp.
int QgsStyleV2::addGroup | ( | const QString & | groupName, |
int | parent = 0 |
||
) |
adds a new group and returns the group's id
groupName | the name of the new group as QString |
parent | is the id of the parent group when a subgrouo is to be created. By default it is 0 indicating it is not a sub-group |
Definition at line 624 of file qgsstylev2.cpp.
int QgsStyleV2::addSmartgroup | ( | const QString & | name, |
const QString & | op, | ||
const QgsSmartConditionMap & | conditions | ||
) |
adds new smartgroup to the database and returns the id
name | is the name of the new Smart Group to be added |
op | is the operator between the conditions; AND/OR as QString |
conditions | are the smart group conditions |
Definition at line 1085 of file qgsstylev2.cpp.
bool QgsStyleV2::addSymbol | ( | const QString & | name, |
QgsSymbolV2 * | symbol, | ||
bool | update = false |
||
) |
add symbol to style. takes symbol's ownership
name | is the name of the symbol being added or updated |
symbol | is the Vector symbol |
update | set to true when the style DB has to be updated, by default it is false |
Definition at line 81 of file qgsstylev2.cpp.
int QgsStyleV2::addTag | ( | const QString & | tagName | ) |
adds a new tag and returns the tag's id
tagName | the name of the new tag to be created |
Definition at line 641 of file qgsstylev2.cpp.
QgsSymbolGroupMap QgsStyleV2::childGroupNames | ( | const QString & | parent = "" | ) |
return a map of groupid and names for the given parent group
Definition at line 491 of file qgsstylev2.cpp.
void QgsStyleV2::clear | ( | ) |
remove all contents of the style
Definition at line 70 of file qgsstylev2.cpp.
QgsVectorColorRampV2 * QgsStyleV2::colorRamp | ( | const QString & | name | ) |
return a NEW copy of color ramp
Definition at line 257 of file qgsstylev2.cpp.
int QgsStyleV2::colorRampCount | ( | ) |
return count of color ramps
Definition at line 268 of file qgsstylev2.cpp.
int QgsStyleV2::colorrampId | ( | const QString & | name | ) |
return the id in the style database for the given colorramp name returns 0 if not found
Definition at line 1060 of file qgsstylev2.cpp.
QStringList QgsStyleV2::colorRampNames | ( | ) |
return a list of names of color ramps
Definition at line 273 of file qgsstylev2.cpp.
const QgsVectorColorRampV2 * QgsStyleV2::colorRampRef | ( | const QString & | name | ) | const |
return a const pointer to a symbol (doesn't create new instance)
Definition at line 263 of file qgsstylev2.cpp.
|
static |
return default application-wide style
Definition at line 51 of file qgsstylev2.cpp.
bool QgsStyleV2::detagSymbol | ( | StyleEntity | type, |
const QString & | symbol, | ||
const QStringList & | tags | ||
) |
detags the symbol with the given list
Removes the given tags for the specified symbol or colorramp
type | is either SymbolEntity or ColorrampEntity |
symbol | is the name of the symbol or colorramp |
tags | is the list of tags that are to be removed as QStringList |
Definition at line 922 of file qgsstylev2.cpp.
|
inline |
return last error from load/save operation
Definition at line 288 of file qgsstylev2.h.
bool QgsStyleV2::exportXML | ( | const QString & | filename | ) |
Exports the style as a XML file.
Definition at line 1362 of file qgsstylev2.cpp.
|
inline |
return current file name of the style
Definition at line 291 of file qgsstylev2.h.
QStringList QgsStyleV2::findSymbols | ( | StyleEntity | type, |
const QString & | qword | ||
) |
return the names of the symbols which have a matching 'substring' in its defintion
type | is either SymbolEntity or ColorrampEntity |
qword | is the query string to search the symbols or colorramps. |
Definition at line 796 of file qgsstylev2.cpp.
|
protected |
prepares the complex query for removing a group, so that the children are not abandoned
Definition at line 705 of file qgsstylev2.cpp.
gets the id from the table for the given name from the database, 0 if not found
Definition at line 1019 of file qgsstylev2.cpp.
gets the name from the table for the given id from the database, empty if not found
Definition at line 1037 of file qgsstylev2.cpp.
bool QgsStyleV2::group | ( | StyleEntity | type, |
const QString & | name, | ||
int | groupid | ||
) |
applies the specified group to the symbol or colorramp specified by StyleEntity
type | is either SymbolEntity of ColorrampEntity |
name | is the name of the symbol or coloramp whose group is to be set |
groupid | is the id of the group to which the entity is assigned |
Definition at line 775 of file qgsstylev2.cpp.
int QgsStyleV2::groupId | ( | const QString & | group | ) |
return the DB id for the given group name
Definition at line 1065 of file qgsstylev2.cpp.
QList< int > QgsStyleV2::groupIds | ( | ) | const |
return the ids of all the groups in the style
Definition at line 477 of file qgsstylev2.cpp.
QString QgsStyleV2::groupName | ( | int | groupId | ) | const |
return the group name for the given DB id
Definition at line 1070 of file qgsstylev2.cpp.
QStringList QgsStyleV2::groupNames | ( | ) |
return the all the groups in the style
Definition at line 463 of file qgsstylev2.cpp.
bool QgsStyleV2::importXML | ( | const QString & | filename | ) |
Imports the symbols and colorramps into the default style database from the given XML file.
Definition at line 1406 of file qgsstylev2.cpp.
bool QgsStyleV2::load | ( | const QString & | filename | ) |
load a file into the style
Definition at line 291 of file qgsstylev2.cpp.
|
protected |
convenience function to open the DB and return a sqlite3 object
Definition at line 278 of file qgsstylev2.cpp.
void QgsStyleV2::remove | ( | StyleEntity | type, |
int | id | ||
) |
remove the specified entity from the db
type | is any of the style entites. Refer enum StyleEntity. |
id | is the DB id of the entity to be removed |
Definition at line 723 of file qgsstylev2.cpp.
bool QgsStyleV2::removeColorRamp | ( | const QString & | name | ) |
remove color ramp from style (and delete it)
Definition at line 239 of file qgsstylev2.cpp.
bool QgsStyleV2::removeSymbol | ( | const QString & | name | ) |
remove symbol from style (and delete it)
Definition at line 136 of file qgsstylev2.cpp.
void QgsStyleV2::rename | ( | StyleEntity | type, |
int | id, | ||
const QString & | newName | ||
) |
rename the given entity with the specified id
type | is any of the style entites. Refer enum StyleEntity. |
id | is the DB id of the entity which is to be renamed |
newName | is the new name of the entity |
Definition at line 677 of file qgsstylev2.cpp.
change ramp's name
Definition at line 435 of file qgsstylev2.cpp.
change symbol's name
Definition at line 403 of file qgsstylev2.cpp.
|
protected |
convenience function that would run queries which don't generate return values
query | query to run |
freeQuery | release query memory |
Definition at line 754 of file qgsstylev2.cpp.
save style into a file (will use current filename if empty string is passed)
Definition at line 357 of file qgsstylev2.cpp.
bool QgsStyleV2::saveColorRamp | ( | const QString & | name, |
QgsVectorColorRampV2 * | ramp, | ||
int | groupid, | ||
const QStringList & | tags | ||
) |
add the colorramp to the DB
name | is the name of the colorramp as QString |
ramp | is the pointer to the new QgsVectorColorRampV2 being saved |
groupid | is the id of the group to which the Color Ramp belongs. Pass 0 if it doesn't belong to any group or not known. |
tags | is a list of tags that are associated with the color ramp as a QStringList. |
Definition at line 210 of file qgsstylev2.cpp.
bool QgsStyleV2::saveSymbol | ( | const QString & | name, |
QgsSymbolV2 * | symbol, | ||
int | groupid, | ||
const QStringList & | tags | ||
) |
add the symbol to the DB with the tags
name | is the name of the symbol as QString |
symbol | is the pointer to the new QgsSymbolV2 being saved |
groupid | is the id of the group to which the symbol belongs. Pass 0 if it doesn't belong to any group or not known. |
tags | is a list of tags that are associated with the symbol as a QStringList. |
Definition at line 105 of file qgsstylev2.cpp.
QgsSmartConditionMap QgsStyleV2::smartgroup | ( | int | id | ) |
returns the QgsSmartConditionMap for the given id
Definition at line 1290 of file qgsstylev2.cpp.
int QgsStyleV2::smartgroupId | ( | const QString & | smartgroup | ) |
return the DB id for the given smartgroup name
Definition at line 1080 of file qgsstylev2.cpp.
QStringList QgsStyleV2::smartgroupNames | ( | ) |
returns the smart groups list
Definition at line 1151 of file qgsstylev2.cpp.
QString QgsStyleV2::smartgroupOperator | ( | int | id | ) |
returns the operator for the smartgroup
Definition at line 1331 of file qgsstylev2.cpp.
QgsSymbolGroupMap QgsStyleV2::smartgroupsListMap | ( | ) |
returns the smart groups map with id as key and name as value
Definition at line 1125 of file qgsstylev2.cpp.
QgsSymbolV2 * QgsStyleV2::symbol | ( | const QString & | name | ) |
return a NEW copy of symbol
Definition at line 164 of file qgsstylev2.cpp.
int QgsStyleV2::symbolCount | ( | ) |
return count of symbols in style
Definition at line 175 of file qgsstylev2.cpp.
int QgsStyleV2::symbolId | ( | const QString & | name | ) |
return the id in the style database for the given symbol name returns 0 if not found
Definition at line 1055 of file qgsstylev2.cpp.
QStringList QgsStyleV2::symbolNames | ( | ) |
return a list of names of symbols
Definition at line 180 of file qgsstylev2.cpp.
const QgsSymbolV2 * QgsStyleV2::symbolRef | ( | const QString & | name | ) | const |
return a const pointer to a symbol (doesn't create new instance)
Definition at line 170 of file qgsstylev2.cpp.
|
signal |
QStringList QgsStyleV2::symbolsOfGroup | ( | StyleEntity | type, |
int | groupid | ||
) |
returns the symbolnames of a given groupid
type | is either SymbolEntity or ColorampEntity |
groupid | is id of the group to which the symbols belong to, as int |
Definition at line 538 of file qgsstylev2.cpp.
QStringList QgsStyleV2::symbolsOfSmartgroup | ( | StyleEntity | type, |
int | id | ||
) |
returns the symbols for the smartgroup
Definition at line 1176 of file qgsstylev2.cpp.
QStringList QgsStyleV2::symbolsWithTag | ( | StyleEntity | type, |
int | tagid | ||
) |
returns the symbol names with which have the given tag
type | is either SymbolEntity or ColorampEntity |
tagid | is id of the tag which has been applied over the symbol as int |
Definition at line 575 of file qgsstylev2.cpp.
int QgsStyleV2::tagId | ( | const QString & | tag | ) |
return the DB id for the given tag name
Definition at line 1075 of file qgsstylev2.cpp.
QStringList QgsStyleV2::tags | ( | ) | const |
Returns a list of all tags in the style database.
Definition at line 656 of file qgsstylev2.cpp.
QStringList QgsStyleV2::tagsOfSymbol | ( | StyleEntity | type, |
const QString & | symbol | ||
) |
return the tags associated with the symbol
type | is either SymbolEntity or ColorrampEntity |
symbol | is the name of the symbol or color ramp |
Definition at line 980 of file qgsstylev2.cpp.
bool QgsStyleV2::tagSymbol | ( | StyleEntity | type, |
const QString & | symbol, | ||
const QStringList & | tags | ||
) |
tags the symbol with the tags in the list
Applies the given tags to the given symbol or colorramp
type | is either SymbolEntity or ColorrampEntity |
symbol | is the name of the symbol or colorramp as QString |
tags | is the list of the tags that are to be applied as QStringList |
Definition at line 870 of file qgsstylev2.cpp.
|
protected |
updates the properties of an existing symbol/colorramp
type | is either SymbolEntity or ColorrampEntity |
name | is the name of an existing symbol or a color ramp |
Definition at line 1502 of file qgsstylev2.cpp.
|
protected |
Definition at line 337 of file qgsstylev2.h.
|
protected |
Definition at line 342 of file qgsstylev2.h.
|
staticprotected |
Definition at line 344 of file qgsstylev2.h.
|
protected |
Definition at line 339 of file qgsstylev2.h.
|
protected |
Definition at line 340 of file qgsstylev2.h.
|
protected |
Definition at line 336 of file qgsstylev2.h.