|
Eneboo - Documentación para desarrolladores
|
Conjunto de utilidades generales. Más...
#include <FLObjectFactory.h>
Conjunto de utilidades generales.
Conjunto de utilidades generales (conversión de datos, traducciones, incremento de contadores...)
| FLUtilInterface::FLUtilInterface | ( | QObject * | parent = 0 | ) | [inline] |
Constructor
Suma dias a una fecha.
| d | Fecha con la que operar |
| nd | Numero de dias que sumar. Si es negativo resta dias |
Suma meses a una fecha.
| d | Fecha con la que operar |
| nm | Numero de meses que sumar. Si es negativo resta meses |
Suma años a una fecha.
| d | Fecha con la que operar |
| nm | Numero de años que sumar. Si es negativo resta años |
| QString FLUtilInterface::buildNumber | ( | const QVariant & | v, |
| char | tipo, | ||
| int | partDecimal | ||
| ) | [inline, slot] |
Construye un string a partir de un número, especificando el formato y precisión
| v. | Número a convertir a QString |
| tipo. | Formato del número |
| partDecimal. | Precisión (número de cifras decimales) del número |
Calcula el dígito de control asociado a un número de cuenta bancaria
| n | Número de cuenta |
| QString FLUtilInterface::centenamillar | ( | long | n | ) | [inline, slot] |
Enunciado de las centenas de millar de un número.
| n | Número a tratar. Debe ser positivo |
| QString FLUtilInterface::centenas | ( | long | n | ) | [inline, slot] |
Enunciado de las centenas de un número.
| n | Número a tratar. Debe ser positivo |
Crea un diálogo de progreso
| l | Label del diálogo |
| tS | Número total de pasos a realizar |
| void FLUtilInterface::createProgressDialog | ( | ) | [inline, slot] |
Convierte fechas del tipo AAAA-MM-DD, AAAA-MM-DD o AAAAMMDD al tipo DD-MM-AAAA.
| f | Cadena de texto con la fecha a transformar |
Convierte fechas del tipo DD-MM-AAAA, DD/MM/AAAA o DDMMAAAA al tipo AAAA-MM-DD.
| f | Cadena de texto con la fecha a transformar |
Diferencia de dias desde una fecha a otra.
| d1 | Fecha de partida |
| d2 | Fecha de destino |
| QString FLUtilInterface::decenas | ( | long | n | ) | [inline, slot] |
Enunciado de las decenas de un número.
| n | Número a tratar. Debe ser positivo |
| QString FLUtilInterface::decenasmillar | ( | long | n | ) | [inline, slot] |
Enunciado de las decenas de millar de un número.
| n | Número a tratar. Debe ser positivo |
| void FLUtilInterface::destroyProgressDialog | ( | ) | [inline, slot] |
Destruye el diálogo de progreso
| QString FLUtilInterface::enLetra | ( | long | n | ) | [inline, slot] |
Obtiene la expresión en texto de como se enuncia un número, en castellano.
Dado un número entero, devuelve su expresión en texto de como se enuncia de forma hablada; por ejemplo dado el número 130, devolverá la cadena de texto "ciento treinta".
| n | Número a transladar a su forma hablada. Debe ser positivo |
Obtiene la expresión en texto de como se enuncia una cantidad monetaria, en castellano y en cualquier moneda indicada.
Dado un número doble, devuelve su expresión en texto de como se enuncia de forma hablada en la moneda indicada; por ejemplo dado el número 130.25, devolverá la cadena de texto "ciento treinta 'moneda' con veinticinco céntimos".
| n | Número a transladar a su forma hablada. Debe ser positivo |
| m | Nombre de la moneda |
| QString FLUtilInterface::enLetraMonedaEuro | ( | double | n | ) | [inline, slot] |
Obtiene la expresión en texto de como se enuncia una cantidad monetaria, en castellano y en Euros.
Dado un número doble, devuelve su expresión en texto de como se enuncia de forma hablada en euros; por ejemplo dado el número 130.25, devolverá la cadena de texto "ciento treinta euros con veinticinco céntimos".
| n | Número a transladar a su forma hablada. Debe ser positivo |
| bool FLUtilInterface::execSql | ( | const QString & | sql, |
| const QString & | connName = "default" |
||
| ) | [inline, slot] |
| uint FLUtilInterface::fastRand | ( | ) | const [inline, slot] |
| QString FLUtilInterface::fieldAliasToName | ( | const QString & | aN, |
| const QString & | tN, | ||
| const QString & | connName = "default" |
||
| ) | const [slot] |
Obtiene el nombre de un campo a partir de su alias.
| aN | Nombre del alias del campo |
| tN | Nombre de la tabla |
| connName | Nombre de la conexion |
| bool FLUtilInterface::fieldAllowNull | ( | const QString & | fN, |
| const QString & | tN, | ||
| const QString & | connName = "default" |
||
| ) | const [slot] |
Obtiene si el campo permite nulos.
| fN | Nombre del campo |
| tN | Nombre de la tabla |
| connName | Nombre de la conexion |
| QVariant FLUtilInterface::fieldDefaultValue | ( | const QString & | fN, |
| const QString & | tN, | ||
| const QString & | connName = "default" |
||
| ) | const [slot] |
Devuelve el valor por defecto para el campo.
| fN | Nombre del campo |
| tN | Nombre de la tabla |
| connName | Nombre de la conexion |
| bool FLUtilInterface::fieldIsCompoundKey | ( | const QString & | fN, |
| const QString & | tN, | ||
| const QString & | connName = "default" |
||
| ) | const [slot] |
Obtiene si el campo es clave compuesta.
| fN | Nombre del campo |
| tN | Nombre de la tabla |
| connName | Nombre de la conexion |
| bool FLUtilInterface::fieldIsPrimaryKey | ( | const QString & | fN, |
| const QString & | tN, | ||
| const QString & | connName = "default" |
||
| ) | const [slot] |
Obtiene si el campo es clave primaria.
| fN | Nombre del campo |
| tN | Nombre de la tabla |
| connName | Nombre de la conexion |
| int FLUtilInterface::fieldLength | ( | const QString & | fN, |
| const QString & | tN, | ||
| const QString & | connName = "default" |
||
| ) | const [slot] |
Obtiene la longitud de un campo a partir de su nombre.
| fN | Nombre del campo |
| tN | Nombre de la tabla |
| connName | Nombre de la conexion |
| QString FLUtilInterface::fieldNameToAlias | ( | const QString & | fN, |
| const QString & | tN, | ||
| const QString & | connName = "default" |
||
| ) | const [slot] |
Obtiene el alias de un campo a partir de su nombre.
| fN | Nombre del campo |
| tN | Nombre de la tabla |
| connName | Nombre de la conexion |
| int FLUtilInterface::fieldType | ( | const QString & | fN, |
| const QString & | tN, | ||
| const QString & | connName = "default" |
||
| ) | const [slot] |
Obtiene el tipo de un campo a partir de su nombre.
| fN | Nombre del campo |
| tN | Nombre de la tabla |
| connName | Nombre de la conexion |
| QStringList FLUtilInterface::findFiles | ( | const QStringList & | paths, |
| const QString & | filter = "*", |
||
| bool | breakOnFirstMatch = false |
||
| ) | [inline, slot] |
Busca ficheros recursivamente en las rutas indicadas y según el patrón indicado
Ejemplo:
C++: QStringList filesFound = FLUtil::findFiles(QStringList() << "/home/user/Documents", "*.odt *.gif"); for (QStringList::Iterator it = filesFound.begin(); it != filesFound.end(); ++it) qWarning(*it);
QSA: var util = new FLUtil; var filesFound = util.findFiles( [ "/home/user/Documents" ], "*.odt *.gif");
for(var i = 0; i < filesFound.length; ++i) debug(filesFound[i]);
| paths | Rutas de búsqueda |
| filter | Patrón de filtrado para los ficheros. Admite varios separados por espacios "*.gif *.png". Por defecto todos, "*" |
| breakOnFirstMatch | Si es TRUE al encontrar el primer fichero que cumpla el patrón indicado, termina la búsqueda y devuelve el nombre de ese fichero |
Formatea una cadena de texto poniéndole separadores de miles.
La cadena que se pasa se supone que un número, convirtiendola con QString::toDouble(), si la cadena no es número el resultado es imprevisible.
| s | Cadena de texto a la que se le quieren poder separadores de miles |
| QString FLUtilInterface::formatValue | ( | int | t, |
| const QVariant & | v, | ||
| const bool | upper = false, |
||
| const QString & | connName = "default" |
||
| ) | const [slot] |
Devuelve el contenido del valor de de un campo formateado para ser reconocido por la base de datos actual, dentro de la clausura WHERE de SQL.
Este método toma como parametros los metadatos del campo definidos con FLFieldMetaData. Además de TRUE y FALSE como posibles valores de un campo lógico también acepta los valores Sí y No (o su traducción al idioma correspondiente). Las fechas son adaptadas al forma AAAA-MM-DD, que es el formato reconocido por PostgreSQL .
| t | Tipo de datos del valor |
| v | Valor que se quiere formatear para el campo indicado |
| upper | Si TRUE convierte a mayúsculas el valor (si es de tipo cadena) |
| connName | Nombre de la conexion |
| QString FLUtilInterface::getIdioma | ( | ) | [inline, slot] |
Devuelve una cadena de dos caracteres con el código de idioma del sistema
| QString FLUtilInterface::getOS | ( | ) | [inline, slot] |
Devuelve el sistema operativo sobre el que se ejecuta el programa
Comprueba si la cabecera de un fichero de definición corresponde con las soportadas por AbanQ.
Este método no sirve para los scripts, sólo para los ficheros de definición; mtd, ui, qry, xml, ts y kut.
| head | Cadena de caracteres con la cabecera del fichero, bastaría con las tres o cuatro primeras linea del fichero no vacías |
Devuelve la longitud de una cadena
| srt. | Cadena |
| QString FLUtilInterface::letraDni | ( | long | n | ) | [inline, slot] |
Calcula la letra asociada a un número de DNI
| n | Número de DNI |
| QVariant FLUtilInterface::nextCounter | ( | const QString & | name, |
| FLSqlCursorInterface * | cursor_ | ||
| ) | [inline, slot] |
Este método devuelve el siguiente valor de un campo tipo contador de una tabla.
Este método es muy util cuando se insertan registros en los que la referencia es secuencial y no nos acordamos de cual fue el ultimo numero usado. El valor devuelto es un QVariant del tipo de campo es el que se busca la ultima referencia. Lo más aconsejable es que el tipo del campo sea 'String' porque así se le puede dar formato y ser usado para generar un código de barras. De todas formas la función soporta tanto que el campo sea de tipo 'String' como de tipo 'double'.
| name | Nombre del campo |
| cursor_ | Cursor a la tabla donde se encuentra el campo. |
| QString FLUtilInterface::nextSequence | ( | int | nivel, |
| const QString & | secuencia, | ||
| const QString & | ultimo | ||
| ) | [inline, slot] |
Devuelve el siguiente valor de la secuencia segun la profundidad indicada por nivel. Para explicar el funcionamiento pondremos un ejemplo. Supongamos una secuencia tipo A-N. A indica que se coloque en esa posicion una secuencia en letras y N una secuencia en numero. La numeración de niveles va de derecha a izquierda asi el nivel 1 es N y el nivel 2 A. Si hacemos un nextSequence a nivel 1 el valor de vuelto será un A que estubiera y un N sumando 1 al anterior. Si el nivel es 2 obtendremos un A + 1, trasformado a letras, y todos los niveles a la derecha de este se ponen a 1 o su correspondiente en letra que seria A.
| nivel | Indica la profundidad a la que se hace el incremento. |
| secuencia | Estructura de la secuencia. |
| ultimo | Ultimo valor de la secuencia para poder dar el siguiente valor. |
| QStringList FLUtilInterface::nombreCampos | ( | const QString & | tabla | ) | [inline, slot] |
Devuelve una lista de los nombres de los campos de una tabla, separados por comas
| tabla. | Nombre de la tabla |
Devuelve si el numero de tarjeta de Credito es valido.
El parametro que se pasa es la cadena de texto que contiene el numero de tarjeta.
| num | Cadena de texto con el numero de tarjeta |
| QVariant FLUtilInterface::partDecimal | ( | double | n | ) | [inline, slot] |
Obtiene la parte decimal de un número.
Dado un número devuelve la parte decimal correspondiente, es decir, cifras en la parte derecha de la coma decimal.
| n | Número del que obtener la parte decimal. Debe ser positivo |
| QVariant FLUtilInterface::partInteger | ( | double | n | ) | [inline, slot] |
Obtiene la parte entera de un número.
Dado un número devuelve la parte entera correspondiente, es decir, cifras en la parte izquierda de la coma decimal.
| n | Número del que obtener la parte entera. Debe ser positivo |
| bool FLUtilInterface::quickSqlDelete | ( | const QString & | t, |
| const QString & | w, | ||
| const QString & | connName = "default" |
||
| ) | [inline, slot] |
Versión rápida de sqlDelete. Ejecuta directamente la consulta sin realizar comprobaciones y sin disparar señales de commits. Usar con precaución.
| QVariant FLUtilInterface::quickSqlSelect | ( | const QString & | f, |
| const QString & | s, | ||
| const QString & | w, | ||
| const QString & | connName = "default" |
||
| ) | [inline, slot] |
Versión rápida de sqlSelect. Ejecuta directamente la consulta sin realizar comprobaciones. Usar con precaución.
Lee el valor de un setting en la tabla flsettings
| key. | Clave identificadora del setting |
| QVariant FLUtilInterface::readSettingEntry | ( | const QString & | key, |
| const QString & | def = QString::null, |
||
| bool * | ok = 0 |
||
| ) | [inline, slot] |
Lee el valor de un setting en el directorio de la instalación de AbanQ
| key. | Clave identificadora del setting |
| def. | Valor por defecto en el caso de que el setting no esté establecido |
| ok. | Indicador de que la lectura es correcta |
| QString FLUtilInterface::roundFieldValue | ( | const QVariant & | n, |
| const QString & | table, | ||
| const QString & | field | ||
| ) | [inline, slot] |
Redondea un valor en función de la precisión especificada para un campo tipo double de la base de datos
| n. | Número a redondear |
| table. | Nombre de la tabla |
| field. | Nombre del campo |
| QString FLUtilInterface::roundFieldValue | ( | double | n, |
| const QString & | table, | ||
| const QString & | field | ||
| ) | [inline, slot] |
| QString FLUtilInterface::roundFieldValue | ( | int | n, |
| const QString & | table, | ||
| const QString & | field | ||
| ) | [inline, slot] |
| void FLUtilInterface::saveIconFile | ( | const QString & | data, |
| const QString & | pathFile | ||
| ) | [inline, slot] |
Guarda la imagen de icono de un botón de un formulario en un ficher png. Utilizado para documentación
| data | Contenido de la imagen en una cadena de caracteres |
| pathFile | Ruta completa al fichero donde se guadará la imagen |
Salva en un fichero con formato PNG la imagen o captura de pantalla de un formulario.
| n | Nombre del fichero que contiene la descricpción del formulario. |
| pathFile | Ruta y nombre del fichero donde guardar la imagen |
Convierte una cadena que es una serie de letras en su correspondiente valor numerico.
| letter | Cadena con la serie. |
Convierte un número a su correspondiente secuencia de Letras.
| number | Número a convertir |
| void FLUtilInterface::setFastRandSeed | ( | uint | seed | ) | [inline, slot] |
Generación "casi-aleatoria" de números aleatorios por el método rápido xorshf96
| void FLUtilInterface::setLabelText | ( | const QString & | l | ) | [inline, slot] |
Cambia el texto de la etiqueta del diálogo
| l | Etiqueta |
| void FLUtilInterface::setProgress | ( | int | p | ) | [inline, slot] |
Establece el grado de progreso del diálogo
| p | Grado de progreso |
| void FLUtilInterface::setTotalSteps | ( | int | tS | ) | [inline, slot] |
Establece el número total de pasos del diálogo
| ts | Número total de pasos |
Obtiene la clave SHA1 de una cadena de texto.
| str | Cadena de la que obtener la clave SHA1 |
Obtiene la imagen o captura de pantalla de un formulario.
| n | Nombre del fichero que contiene la descricpción del formulario. |
| bool FLUtilInterface::sqlDelete | ( | const QString & | t, |
| const QString & | w, | ||
| const QString & | connName = "default" |
||
| ) | [inline, slot] |
Borra uno o más registros en una tabla mediante un objeto FLSqlCursor
| t | Nombre de la tabla |
| w | Sentencia where para identificar los registros a borrar. |
| connName | Nombre de la conexion |
| bool FLUtilInterface::sqlInsert | ( | const QString & | t, |
| const QString & | fL, | ||
| const QString & | vL, | ||
| const QString & | connName = "default" |
||
| ) | [inline, slot] |
Realiza la inserción de un registro en una tabla mediante un objeto FLSqlCursor
| t | Nombre de la tabla |
| fL | Lista separada con comas de los nombres de los campos |
| vL | Lista separada con comas de los valores correspondientes |
| connName | Nombre de la conexion |
| QVariant FLUtilInterface::sqlSelect | ( | const QString & | f, |
| const QString & | s, | ||
| const QString & | w, | ||
| const QString & | tL = QString::null, |
||
| const QString & | connName = "default" |
||
| ) | [inline, slot] |
Ejecuta una query de tipo select, devolviendo los resultados del primer registro encontrado
| f | Sentencia from de la query |
| s | Sentencia select de la query, que será el nombre del campo a devolver |
| w | Sentencia where de la query |
| tL | Sentencia tableslist de la query. Necesario cuando en la sentencia from se incluya más de una tabla |
| connName | Nombre de la conexion |
| bool FLUtilInterface::sqlUpdate | ( | const QString & | t, |
| const QString & | fL, | ||
| const QString & | vL, | ||
| const QString & | w, | ||
| const QString & | connName = "default" |
||
| ) | [inline, slot] |
Realiza la modificación de uno o más registros en una tabla mediante un objeto FLSqlCursor
| t | Nombre de la tabla |
| fL | Lista separada con comas de los nombres de los campos |
| vL | Lista separada con comas de los valores correspondientes |
| w | Sentencia where para identificar los registros a editar. |
| connName | Nombre de la conexion |
| QString FLUtilInterface::tableNameToAlias | ( | const QString & | tN, |
| const QString & | connName = "default" |
||
| ) | const [slot] |
Obtiene el alias de una tabla a partir de su nombre.
| tN | Nombre de la tabla |
| connName | Nombre de la conexion |
Traducción de una cadena al idioma local
Se hace una llamada a la función tr() de la clase QObject para hacer la traducción. Se utiliza para traducciones desde fuera de objetos QObject
| contexto | Contexto en el que se encuentra la cadena, generalmente se refiere a la clase en la que está definida |
| s | Cadena de texto a traducir |
| QString FLUtilInterface::unidades | ( | long | n | ) | [inline, slot] |
Enunciado de las unidades de un número.
| n | Número a tratar. Debe ser positivo |
| QString FLUtilInterface::unidadesmillar | ( | long | n | ) | [inline, slot] |
Enunciado de las unidades de millar de un número.
| n | Número a tratar. Debe ser positivo |
Pasa una cadena a codificación utf-8
| s,: | Cadena |
| bool FLUtilInterface::writeDBSettingEntry | ( | const QString & | key, |
| const QString & | value | ||
| ) | [inline, slot] |
Establece el valor de un setting en la tabla flsettings
| key. | Clave identificadora del setting |
| Valor | del setting |
| bool FLUtilInterface::writeSettingEntry | ( | const QString & | key, |
| const QString & | value | ||
| ) | [inline, slot] |
Establece el valor de un setting en el directorio de instalación de AbanQ
| key. | Clave identificadora del setting |
| Valor | del setting |
1.7.4