Referencia de la Clase FLFieldDB

#include <FLFieldDB.h>

Diagrama de herencias de FLFieldDB

Lista de todos los miembros.

Slots públicos
void	openFormRecordRelation ()
void	searchValue ()
void	searchPixmap ()
void	setPixmap (const QString &filename)
void	emitLostFocus ()
void	setNoShowed ()
void	setMapValue (const QString &v)
void	emitKeyF2Pressed ()
void	emitLabelClicked ()
void	emitTextChanged (const QString &t)
void	emitActivatedAccel (int id)
Señales
void	lostFocus ()
void	keyF2Pressed ()
void	labelClicked ()
void	textChanged (const QString &)
void	activatedAccel (int)
void	keyF4Pressed ()
void	keyReturnPressed ()
Métodos públicos
	FLFieldDB (QWidget *parent=0, const char *name=0)
QString	actionName () const
void	setActionName (const QString &aN)
QString	fieldName () const
void	setFilter (const QString &f)
QString	filter () const
void	setFieldName (const QString &fN)
QString	tableName () const
void	setTableName (const QString &fT)
QString	foreignField () const
void	setForeignField (const QString &fN)
QString	fieldRelation () const
QString	fieldAlias () const
QWidget *	editor () const
void	setFieldRelation (const QString &fN)
void	setFieldAlias (const QString &alias)
void	setTextFormat (const int &f)
int	textFormat () const
void	setValue (const QVariant &v)
QVariant	value ()
void	selectAll ()
FLSqlCursor *	cursor ()
bool	showAlias () const
void	setShowAlias (const bool value)
int	insertAccel (const QString &key)
void	removeAccel (int id)
void	setKeepDisabled (const bool keep)
bool	showEditor () const
void	setShowEditor (const bool show)
void	setPartDecimal (int d)
Slots protegidos
void	refresh (const QString &fN=QString::null)
void	refreshQuick (const QString &fN=QString::null)
void	initCursor ()
void	initEditor ()
void	updateValue (const QString &t)
void	updateValue (const QDate &d)
void	updateValue (const QTime &t)
void	updateValue (bool b)
void	updateValue ()
void	toggleDatePicker ()
void	clearPixmap ()
void	savePixmap (int f)
void	toggleAutoCompletion ()
void	autoCompletionUpdateValue ()
Métodos protegidos
bool	eventFilter (QObject *obj, QEvent *ev)
void	showEvent (QShowEvent *e)
Propiedades
QString	fieldName
QString	tableName
QString	foreignField
QString	fieldRelation
QString	fieldAlias
QString	actionName
bool	showAlias
bool	showEditor
int	textFormat
Amigas
class	FLFieldDBInterface
class	FLFormDB
class	FLFormRecordDB
class	FLFormSearchDB

---

Descripción detallada

PLUGIN que enlaza con el campo de una tabla.

Esta clase es utilizada como plugin y solo debe insertarse como componente en una ventana (widget) que sea de la clase FLFormDB, o que uno de sus padres sea un objeto FLFormDB. Es decir solo tiene sentido insertarlo en una ventana que est� enlazada con una tabla de la base de datos.

Este componente es utilizado en los formularios y se autoconfigura, a partir de los metadatos. Adem�s de servir de edici�n de un campo del registro actual del cursor, permite mediante el bot�n de b�squeda buscar su valor en la tabla de b�squeda asociada, o en un fichero del disco (como por ejemplo un pixmap) seg�n corresponda.

La tabla de busqueda asociada viene a ser la tabla con la que se relaciona la tabla origen de este campo y que precisamente esta relacionada por dicho campo.

Por ejemplo; si el campo es el de DIVISA de la tabla CLIENTES, el valor de DIVISA se deber� buscar en la tabla de DIVISAS, ya que la tabla CLIENTES est� relacionada con la tabla DIVISAS, y la cardinalidad de la relacion ser�a

CLIENTES <-M----1-> DIVISAS,

(un cliente tiene una divisa y una divisa puede estar en muchos clientes). Cuando queramos asignar una divisa a un cliente no vale cualquier valor si no uno de los que tenemos en la tabla divisa, entonces con el bot�n de busqueda del componente se nos abre la tabla divisas donde podemos escoger el valor oportuno.

Autor:

InfoSiAL S.L.

---

Documentación del constructor y destructor

FLFieldDB::FLFieldDB	(	QWidget *	parent = 0,
		const char *	name = 0
	)

constructor

---

Documentación de las funciones miembro

QString FLFieldDB::actionName

(

)

const

Para obtener el nombre de la accion.

Devuelve:

Nombre de la accion

void FLFieldDB::activatedAccel

(

int

)

[signal]

Cuando se pulsa una combinaci�n de teclas de aceleraci�n se emite esta se�al indicando el identificador de la combinaci�n de teclas pulsada

void FLFieldDB::autoCompletionUpdateValue

(

)

[protected, slot]

Actualiza el valor del campo a partir del contenido que ofrece el asistente de completado autom�tico.

void FLFieldDB::clearPixmap

(

)

[protected, slot]

Borra imagen en campos tipo Pixmap.

FLSqlCursor * FLFieldDB::cursor

(

)

Devuelve el cursor de donde se obtienen los datos. Muy util para ser usado en el modo de tabla externa (fieldName y tableName definidos, foreingField y fieldRelation en blanco).

QWidget* FLFieldDB::editor

(

)

const [inline]

Para obtener el widget editor.

Devuelve:

Objeto con el editor del campo

void FLFieldDB::emitActivatedAccel

(

int

id

)

[slot]

Emite la se�al activatedAccel( int )

void FLFieldDB::emitKeyF2Pressed

(

)

[slot]

Emite la se�al de keyF2Pressed.

La se�al key_F2_Pressed del editor (s�lo si el editor es FLLineEdit) est� conectada a este slot.

void FLFieldDB::emitLabelClicked

(

)

[slot]

Emite la se�al de labelClicked. Se usa en los campos M1 para editar el formulario de edici�n del valor seleccionado.

void FLFieldDB::emitLostFocus

(

)

[slot]

Emite la se�al de foco perdido

void FLFieldDB::emitTextChanged

(

const QString &

t

)

[slot]

Emite la se�al de textChanged.

La se�al textChanged del editor (s�lo si el editor es FLLineEdit) est� conectada a este slot.

bool FLFieldDB::eventFilter	(	QObject *	obj,
		QEvent *	ev
	)		[protected]

Filtro de eventos

QString FLFieldDB::fieldAlias

(

)

const

Devuelve:

Alias del campo, es el valor mostrado en la etiqueta

QString FLFieldDB::fieldName

(

)

const

Para obtener el nombre del campo.

Devuelve:

Nombre del campo

QString FLFieldDB::fieldRelation

(

)

const

Para obtener el nombre del campo relacionado.

Devuelve:

Nombre del campo

QString FLFieldDB::filter

(

)

const

Para obtener el filtro del cursor.

QString FLFieldDB::foreignField

(

)

const

Para obtener el nombre del campo for�neo.

Devuelve:

Nombre del campo

void FLFieldDB::initCursor

(

)

[protected, slot]

Inicia el cursor segun este campo sea de la tabla origen o de una tabla relacionada

void FLFieldDB::initEditor

(

)

[protected, slot]

Crea e inicia el editor apropiado para editar el tipo de datos contenido en el campo (p.e: si el campo contiene una fecha crea e inicia un QDataEdit)

int FLFieldDB::insertAccel

(

const QString &

key

)

Inserta como acelerador de teclado una combinaci�n de teclas, devociendo su identificador

Parámetros:

key	Cadena de texto que representa la combinaci�n de teclas (p.e. "Ctrl+Shift+O")

Devuelve:

El identificador asociado internamente a la combinaci�n de teclas aceleraci�n insertada

void FLFieldDB::keyF2Pressed

(

)

[signal]

Se�al emitida si se pulsa la tecla F2 en el editor

void FLFieldDB::keyF4Pressed

(

)

[signal]

Se�al emitida si se pulsa la tecla F4 en el editor

void FLFieldDB::keyReturnPressed

(

)

[signal]

Se�al emitida si se pulsa la tecla Return

void FLFieldDB::labelClicked

(

)

[signal]

Se�al emitida si se hace click en el label de un campo M1

void FLFieldDB::lostFocus

(

)

[signal]

Se�al de foco perdido

void FLFieldDB::openFormRecordRelation

(

)

[slot]

Abre un formulario de edici�n para el valor seleccionado en su acci�n correspondiente

void FLFieldDB::refresh

(

const QString &

fN = QString::null

)

[protected, slot]

Refresca el contenido del campo con los valores del cursor de la tabla origen.

Si se indica el nombre de un campo s�lo "refresca" si el campo indicado coincide con la propiedad fieldRelation, tomando como filtro el valor del campo fieldRelation de la tabla relacionada. Si no se indica nig�n nombre de campo el refresco es llevado a cabo siempre.

Parámetros:

fN	Nombre de un campo

void FLFieldDB::refreshQuick

(

const QString &

fN = QString::null

)

[protected, slot]

Refresco r�pido

void FLFieldDB::removeAccel

(

int

id

)

Elimina, desactiva, una combinaci�n de teclas de aceleraci�n seg�n su identificador.

Parámetros:

id	Identificador de la combinaci�n de teclas de aceleraci�n

void FLFieldDB::savePixmap

(

int

f

)

[protected, slot]

Guarda imagen en campos tipo Pixmap.

Parámetros:

fmt	Indica el formato con el que guardar la imagen

void FLFieldDB::searchPixmap

(

)

[slot]

Abre un dialogo para buscar un fichero de imagen.

Si el campo no es de tipo Pixmap no hace nada

void FLFieldDB::searchValue

(

)

[slot]

Abre un dialogo para buscar en la tabla relacionada

void FLFieldDB::selectAll

(

)

Marca como seleccionado el contenido del campo.

void FLFieldDB::setActionName

(

const QString &

aN

)

Para establecer el nombre de la accion.

Parámetros:

aN	Nombre de la accion

void FLFieldDB::setFieldAlias

(

const QString &

alias

)

Para establecer el alias del campo, mostrado en su etiqueta si showAlias es true

Parámetros:

alias

Alias del campo, es el valor de la etiqueta. Si es vacio no hace nada.

void FLFieldDB::setFieldName

(

const QString &

fN

)

Para establecer el nombre del campo.

Parámetros:

fN	Nombre del campo

void FLFieldDB::setFieldRelation

(

const QString &

fN

)

Para establecer el nombre del campo relacionado.

Parámetros:

fN	Nombre del campo

void FLFieldDB::setFilter

(

const QString &

f

)

Para a�adir un filtro al cursor.

void FLFieldDB::setForeignField

(

const QString &

fN

)

Para establecer el nombre del campo for�neo.

Parámetros:

fN	Nombre del campo

void FLFieldDB::setKeepDisabled

(

const bool

keep

)

Establece la capacidad de mantener el componente deshabilitado ignorando posibles habilitaciones por refrescos. Ver FLFieldDB::keepDisabled_ .

Parámetros:

keep	TRUE para activar el mantenerse deshabilitado y FALSE para desactivar

void FLFieldDB::setMapValue

(

const QString &

v

)

[slot]

Establece el valor de este campo seg�n el resultado de la consulta cuya cla�sula 'where' es; nombre campo del objeto que env�a la se�al igual al valor que se indica como par�metro.

S�lo se pueden conectar objetos tipo FLFielDB, y su uso normal es conectar la se�al FLFieldDB::textChanged(cons QString&) a este slot.

Parámetros:

v

Valor

void FLFieldDB::setNoShowed

(

)

[slot]

Establece que el control no est� mostrado

void FLFieldDB::setPartDecimal

(

int

d

)

Establece el n�mero de decimales

void FLFieldDB::setPixmap

(

const QString &

filename

)

[slot]

Carga una imagen en el campo de tipo pixmap

Parámetros:

filename,:

Ruta al fichero que contiene la imagen

void FLFieldDB::setShowAlias

(

const bool

value

)

Establece el estado de la propiedad showAlias.

void FLFieldDB::setShowEditor

(

const bool

show

)

Establece el valor de la propiedad showEditor.

void FLFieldDB::setTableName

(

const QString &

fT

)

Para establecer el nombre de la tabla for�nea.

Parámetros:

fT	Nombre de la tabla

void FLFieldDB::setTextFormat

(

const int &

f

)

Establece el formato del texto

Parámetros:

f	Formato del campo

void FLFieldDB::setValue

(

const QVariant &

v

)

Establece el valor contenido en elcampo.

Parámetros:

v	Valor a establecer

bool FLFieldDB::showAlias

(

)

const

Devuelve el valor de la propiedad showAlias. Esta propiedad es usada para saber si hay que mostrar el alias cuando se est� en modo de cursor relacionado.

bool FLFieldDB::showEditor

(

)

const

Devuelve el valor de la propiedad showEditor.

void FLFieldDB::showEvent

(

QShowEvent *

e

)

[protected]

Captura evento mostrar

QString FLFieldDB::tableName

(

)

const

Para obtener el nombre de la tabla for�nea.

Devuelve:

Nombre de la tabla

void FLFieldDB::textChanged

(

const QString &

)

[signal]

Se�al emitida si se cambia el texto en el editor, s�lo si es del tipo FLLineEdit

int FLFieldDB::textFormat

(

)

const

Devuelve:

El formato del texto

void FLFieldDB::toggleAutoCompletion

(

)

[protected, slot]

Muestra/Oculta el asistente de completado autom�tico.

void FLFieldDB::toggleDatePicker

(

)

[protected, slot]

Muestra/Oculta el seleccionador de fechas.

void FLFieldDB::updateValue

(

)

[protected, slot]

Actualiza el valor del campo con un texto, si el componente es del tipo QTextEdit

void FLFieldDB::updateValue

(

const QTime &

t

)

[protected, slot]

Actualiza el valor del campo con una hora.

Parámetros:

t	Hora para actualizar el campo

void FLFieldDB::updateValue

(

const QString &

t

)

[protected, slot]

Actualiza el valor del campo con una cadena de texto.

Parámetros:

t	Cadena de texto para actualizar el campo

void FLFieldDB::updateValue

(

bool

b

)

[protected, slot]

Actualiza el valor del campo con un valor logico.

Parámetros:

b	Valor logico para actualizar el campo

void FLFieldDB::updateValue

(

const QDate &

d

)

[protected, slot]

Actualiza el valor del campo con una fecha.

Parámetros:

d	Fecha para actualizar el campo

QVariant FLFieldDB::value

(

)

Obtiene el valor contenido en el campo.

---

Documentación de las funciones relacionadas y clases amigas

friend class FLFieldDBInterface [friend]

friend class FLFormDB [friend]

friend class FLFormRecordDB [friend]

friend class FLFormSearchDB [friend]

---

Documentación de propiedades

QString FLFieldDB::actionName [read, write]

QString FLFieldDB::fieldAlias [read, write]

QString FLFieldDB::fieldName [read, write]

QString FLFieldDB::fieldRelation [read, write]

QString FLFieldDB::foreignField [read, write]

bool FLFieldDB::showAlias [read, write]

bool FLFieldDB::showEditor [read, write]

QString FLFieldDB::tableName [read, write]

int FLFieldDB::textFormat [read, write]

---

La documentación para esta clase fue generada a partir de los siguientes ficheros:

• src/flbase/FLFieldDB.h
• src/flbase/FLFieldDB.cpp