kexi
KexiUtils Namespace Reference
Classes | |
class | IdentifierValidator |
Validates input for identifier name. More... | |
class | WaitCursor |
class | Validator |
class | MultiValidator |
Functions | |
bool | isIdentifier (const QString &s) |
QString | string2FileName (const QString &s) |
QString | string2Identifier (const QString &s) |
QString | identifierExpectedMessage (const QString &valueName, const QVariant &v) |
void | setWaitCursor (bool noDelay) |
void | removeWaitCursor () |
QString | fileDialogFilterString (const KMimeType::Ptr &mime, bool kdeFormat) |
QString | fileDialogFilterString (const QString &mimeString, bool kdeFormat) |
QString | fileDialogFilterStrings (const QStringList &mimeStrings, bool kdeFormat) |
QColor | blendedColors (const QColor &c1, const QColor &c2, int factor1, int factor2) |
QColor | contrastColor (const QColor &c) |
QColor | bleachedColor (const QColor &c, int factor) |
void | serializeMap (const QMap< QString, QString > &map, QByteArray &array) |
void | serializeMap (const QMap< QString, QString > &map, QString &string) |
QMap< QString, QString > | deserializeMap (const QByteArray &array) |
QMap< QString, QString > | deserializeMap (const QString &string) |
QString | stringToFileName (const QString &string) |
void | simpleCrypt (QString &string) |
void | simpleDecrypt (QString &string) |
bool | hasParent (QObject *par, QObject *o) |
template<class type> | |
type * | findParent (QObject *o, const char *className) |
template<class type> | |
type * | findFirstChild (QObject *o, const char *className) |
QDateTime | stringToHackedQTime (const QString &s) |
Function Documentation
KEXIUTILS_EXPORT bool KexiUtils::isIdentifier | ( | const QString & | s | ) |
- Returns:
- true if s is a valid identifier, ie. starts with a letter or '_' character and contains only letters, numbers and '_' character.
Definition at line 27 of file identifier.cpp.
KEXIUTILS_EXPORT QString KexiUtils::string2FileName | ( | const QString & | s | ) |
KEXIUTILS_EXPORT QString KexiUtils::string2Identifier | ( | const QString & | s | ) |
- Returns:
- valid identifier based on s. Non-alphanumeric characters (or spaces) are replaced with '_'. If a number is at the beginning, '_' is added at start. Empty strings are not changed. Case remains unchanged.
Definition at line 181 of file identifier.cpp.
KEXIUTILS_EXPORT QString KexiUtils::identifierExpectedMessage | ( | const QString & | valueName, | |
const QVariant & | v | |||
) |
- Returns:
- useful message "Value of "valueName" column must be an identifier. "v" is not a valid identifier.". It is also used by IdentifierValidator.
Definition at line 204 of file identifier.cpp.
KEXIUTILS_EXPORT void KexiUtils::setWaitCursor | ( | bool | noDelay = false |
) |
Sets "wait" cursor with 1 second delay (or 0 seconds if noDelay is true). Does nothing if GUI is not GUI-aware. (see KApplication::guiEnabled())
Definition at line 47 of file kexiutils/utils.cpp.
KEXIUTILS_EXPORT void KexiUtils::removeWaitCursor | ( | ) |
Remove "wait" cursor previously set with setWaitCursor(), even if it's not yet visible. Does nothing if GUI is not GUI-aware. (see KApplication::guiEnabled())
Definition at line 51 of file kexiutils/utils.cpp.
KEXIUTILS_EXPORT QString KexiUtils::fileDialogFilterString | ( | const KMimeType::Ptr & | mime, | |
bool | kdeFormat = true | |||
) |
- Returns:
- filter string in QFileDialog format for a mime type pointed by mime If kdeFormat is true, QFileDialog-compatible filter string is generated, eg. "Image files (*.png *.xpm *.jpg)", otherwise KFileDialog -compatible filter string is generated, eg. "*.png *.xpm *.jpg|Image files (*.png *.xpm *.jpg)". "\\n" is appended if kdeFormat is true, otherwise ";;" is appended.
Definition at line 68 of file kexiutils/utils.cpp.
KEXIUTILS_EXPORT QString KexiUtils::fileDialogFilterStrings | ( | const QStringList & | mimeStrings, | |
bool | kdeFormat | |||
) |
Like QString fileDialogFilterString(const KMimeType::Ptr& mime, bool kdeFormat = true) but returns a list of filter strings.
Definition at line 103 of file kexiutils/utils.cpp.
KEXIUTILS_EXPORT QColor KexiUtils::blendedColors | ( | const QColor & | c1, | |
const QColor & | c2, | |||
int | factor1 = 1 , |
|||
int | factor2 = 1 | |||
) |
- Returns:
- a color being a result of blending c1 with c2 with factor1 and factor1 factors: (c1*factor1+c2*factor2)/(factor1+factor2).
Definition at line 112 of file kexiutils/utils.cpp.
KEXIUTILS_EXPORT QColor KexiUtils::contrastColor | ( | const QColor & | c | ) |
- Returns:
- a contrast color for a color c: If c is light color, darker color created using c.dark(200) is returned; otherwise lighter color created using c.light(200) is returned.
Definition at line 120 of file kexiutils/utils.cpp.
KEXIUTILS_EXPORT QColor KexiUtils::bleachedColor | ( | const QColor & | c, | |
int | factor | |||
) |
- Returns:
- a lighter color for a color c and a factor factor. For colors like Qt::red or Qt::green where hue and saturation are near to 255, hue is decreased so the result will be more bleached. For black color the result is dark gray rather than black.
Definition at line 132 of file kexiutils/utils.cpp.
KEXIUTILS_EXPORT void KexiUtils::serializeMap | ( | const QMap< QString, QString > & | map, | |
QByteArray & | array | |||
) |
Serializes map to array. KexiUtils::deserializeMap() can be used to deserialize this array back to map.
Definition at line 147 of file kexiutils/utils.cpp.
KEXIUTILS_EXPORT QMap< QString, QString > KexiUtils::deserializeMap | ( | const QByteArray & | array | ) |
- Returns:
- a map deserialized from a byte array array. array need to contain data previously serialized using KexiUtils::serializeMap().
Definition at line 167 of file kexiutils/utils.cpp.
KEXIUTILS_EXPORT QMap< QString, QString > KexiUtils::deserializeMap | ( | const QString & | string | ) |
- Returns:
- a map deserialized from string. string need to contain data previously serialized using KexiUtils::serializeMap().
Definition at line 175 of file kexiutils/utils.cpp.
KEXIUTILS_EXPORT QString KexiUtils::stringToFileName | ( | const QString & | string | ) |
- Returns:
- a valid filename converted from string by:
- replacing \, /, :, *, ?, ", <, >, |,
characters with a space - simplifing whitespace by removing redundant space characters using QString::simplifyWhiteSpace() Do not pass full paths here, but only filename strings.
- replacing \, /, :, *, ?, ", <, >, |,
Definition at line 189 of file kexiutils/utils.cpp.
KEXIUTILS_EXPORT void KexiUtils::simpleCrypt | ( | QString & | string | ) |
Performs a simple string encrypttion using rot47-like algorithm. Each character's unicode value is increased by 47 + i (where i is index of the character). The resulting string still contains redable characters. Do not use this for data that can be accessed by attackers!
Definition at line 196 of file kexiutils/utils.cpp.
KEXIUTILS_EXPORT void KexiUtils::simpleDecrypt | ( | QString & | string | ) |
Performs a simple string decrypttion using rot47-like algorithm, using opposite operations to KexiUtils::simpleCrypt().
Definition at line 202 of file kexiutils/utils.cpp.
bool KexiUtils::hasParent | ( | QObject * | par, | |
QObject * | o | |||
) | [inline] |
type* KexiUtils::findParent | ( | QObject * | o, | |
const char * | className | |||
) | [inline] |
- Returns:
- parent object of o that inherits className or NULL if no such parent
Definition at line 46 of file kexiutils/utils.h.
type* KexiUtils::findFirstChild | ( | QObject * | o, | |
const char * | className | |||
) |
- Returns:
- first found child of o, that inherit className. Returned pointer type is casted.
Definition at line 58 of file kexiutils/utils.h.
QDateTime KexiUtils::stringToHackedQTime | ( | const QString & | s | ) | [inline] |
QDateTime - a hack needed because QVariant(QTime) has broken isNull().
Definition at line 68 of file kexiutils/utils.h.