Eneboo - Documentación para desarrolladores
|
Conjunto de utilidades generales. Más...
#include <FLObjectFactory.h>
Conjunto de utilidades generales.
Conjunto de utilidades generales (conversin 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 aos a una fecha.
d | Fecha con la que operar |
nm | Numero de aos que sumar. Si es negativo resta aos |
QString FLUtilInterface::buildNumber | ( | const QVariant & | v, |
char | tipo, | ||
int | partDecimal | ||
) | [inline, slot] |
Construye un string a partir de un nmero, especificando el formato y precisin
v. | Nmero a convertir a QString |
tipo. | Formato del nmero |
partDecimal. | Precisin (nmero de cifras decimales) del nmero |
Calcula el dgito de control asociado a un nmero de cuenta bancaria
n | Nmero de cuenta |
QString FLUtilInterface::centenamillar | ( | long | n | ) | [inline, slot] |
Enunciado de las centenas de millar de un nmero.
n | Nmero a tratar. Debe ser positivo |
QString FLUtilInterface::centenas | ( | long | n | ) | [inline, slot] |
Enunciado de las centenas de un nmero.
n | Nmero a tratar. Debe ser positivo |
Crea un dilogo de progreso
l | Label del dilogo |
tS | Nmero 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 nmero.
n | Nmero a tratar. Debe ser positivo |
QString FLUtilInterface::decenasmillar | ( | long | n | ) | [inline, slot] |
Enunciado de las decenas de millar de un nmero.
n | Nmero a tratar. Debe ser positivo |
void FLUtilInterface::destroyProgressDialog | ( | ) | [inline, slot] |
Destruye el dilogo de progreso
QString FLUtilInterface::enLetra | ( | long | n | ) | [inline, slot] |
Obtiene la expresin en texto de como se enuncia un nmero, en castellano.
Dado un nmero entero, devuelve su expresin en texto de como se enuncia de forma hablada; por ejemplo dado el nmero 130, devolver la cadena de texto "ciento treinta".
n | Nmero a transladar a su forma hablada. Debe ser positivo |
Obtiene la expresin en texto de como se enuncia una cantidad monetaria, en castellano y en cualquier moneda indicada.
Dado un nmero doble, devuelve su expresin en texto de como se enuncia de forma hablada en la moneda indicada; por ejemplo dado el nmero 130.25, devolver la cadena de texto "ciento treinta 'moneda' con veinticinco cntimos".
n | Nmero a transladar a su forma hablada. Debe ser positivo |
m | Nombre de la moneda |
QString FLUtilInterface::enLetraMonedaEuro | ( | double | n | ) | [inline, slot] |
Obtiene la expresin en texto de como se enuncia una cantidad monetaria, en castellano y en Euros.
Dado un nmero doble, devuelve su expresin en texto de como se enuncia de forma hablada en euros; por ejemplo dado el nmero 130.25, devolver la cadena de texto "ciento treinta euros con veinticinco cntimos".
n | Nmero 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 segn el patrn 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 bsqueda |
filter | Patrn 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 patrn indicado, termina la bsqueda y devuelve el nombre de ese fichero |
Formatea una cadena de texto ponindole separadores de miles.
La cadena que se pasa se supone que un nmero, convirtiendola con QString::toDouble(), si la cadena no es nmero 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 mtodo toma como parametros los metadatos del campo definidos con FLFieldMetaData. Adems de TRUE y FALSE como posibles valores de un campo lgico tambin acepta los valores S y No (o su traduccin 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 maysculas 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 cdigo 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 definicin corresponde con las soportadas por AbanQ.
Este mtodo no sirve para los scripts, slo para los ficheros de definicin; mtd, ui, qry, xml, ts y kut.
head | Cadena de caracteres con la cabecera del fichero, bastara con las tres o cuatro primeras linea del fichero no vacas |
Devuelve la longitud de una cadena
srt. | Cadena |
QString FLUtilInterface::letraDni | ( | long | n | ) | [inline, slot] |
Calcula la letra asociada a un nmero de DNI
n | Nmero de DNI |
QVariant FLUtilInterface::nextCounter | ( | const QString & | name, |
FLSqlCursorInterface * | cursor_ | ||
) | [inline, slot] |
Este mtodo devuelve el siguiente valor de un campo tipo contador de una tabla.
Este mtodo 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 ms aconsejable es que el tipo del campo sea 'String' porque as se le puede dar formato y ser usado para generar un cdigo de barras. De todas formas la funcin 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 numeracin 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 nmero.
Dado un nmero devuelve la parte decimal correspondiente, es decir, cifras en la parte derecha de la coma decimal.
n | Nmero del que obtener la parte decimal. Debe ser positivo |
QVariant FLUtilInterface::partInteger | ( | double | n | ) | [inline, slot] |
Obtiene la parte entera de un nmero.
Dado un nmero devuelve la parte entera correspondiente, es decir, cifras en la parte izquierda de la coma decimal.
n | Nmero del que obtener la parte entera. Debe ser positivo |
bool FLUtilInterface::quickSqlDelete | ( | const QString & | t, |
const QString & | w, | ||
const QString & | connName = "default" |
||
) | [inline, slot] |
Versin rpida de sqlDelete. Ejecuta directamente la consulta sin realizar comprobaciones y sin disparar seales de commits. Usar con precaucin.
QVariant FLUtilInterface::quickSqlSelect | ( | const QString & | f, |
const QString & | s, | ||
const QString & | w, | ||
const QString & | connName = "default" |
||
) | [inline, slot] |
Versin rpida de sqlSelect. Ejecuta directamente la consulta sin realizar comprobaciones. Usar con precaucin.
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 instalacin 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 funcin de la precisin especificada para un campo tipo double de la base de datos
n. | Nmero 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 botn de un formulario en un ficher png. Utilizado para documentacin
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 descricpcin 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 nmero a su correspondiente secuencia de Letras.
number | Nmero a convertir |
void FLUtilInterface::setFastRandSeed | ( | uint | seed | ) | [inline, slot] |
Generacin "casi-aleatoria" de nmeros aleatorios por el mtodo rpido xorshf96
void FLUtilInterface::setLabelText | ( | const QString & | l | ) | [inline, slot] |
Cambia el texto de la etiqueta del dilogo
l | Etiqueta |
void FLUtilInterface::setProgress | ( | int | p | ) | [inline, slot] |
Establece el grado de progreso del dilogo
p | Grado de progreso |
void FLUtilInterface::setTotalSteps | ( | int | tS | ) | [inline, slot] |
Establece el nmero total de pasos del dilogo
ts | Nmero 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 descricpcin del formulario. |
bool FLUtilInterface::sqlDelete | ( | const QString & | t, |
const QString & | w, | ||
const QString & | connName = "default" |
||
) | [inline, slot] |
Borra uno o ms 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 insercin 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 ms 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 modificacin de uno o ms 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 |
Traduccin de una cadena al idioma local
Se hace una llamada a la funcin tr() de la clase QObject para hacer la traduccin. 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 nmero.
n | Nmero a tratar. Debe ser positivo |
QString FLUtilInterface::unidadesmillar | ( | long | n | ) | [inline, slot] |
Enunciado de las unidades de millar de un nmero.
n | Nmero a tratar. Debe ser positivo |
Pasa una cadena a codificacin 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 instalacin de AbanQ
key. | Clave identificadora del setting |
Valor | del setting |