Класс aWidget

Базовый класс для визуальных объектов. Наследует QWidget. Подробнее...

#include <awidget.h>

Граф наследования:aWidget:

Полный список членов класса

Открытые слоты
virtual QVariant	value (const QString &name)
virtual QString	value () const
virtual QString	textValue ()
virtual void	setValue (const QString &)
virtual int	setValue (const QString &name, const QVariant &value)
virtual int	setObjValue (const QString &nameWidget, aObject *value)
virtual void	SetReadOnly (bool)
virtual int	Refresh ()
QWidget *	Widget (QString name, bool onlyMyWidgets=true)
virtual aDataField *	getAttribute (const QString &name)
virtual int	setAttribute (const QString &name, const aDataField *value)
Сигналы
void	setData (QWidget *, aCfg *)
void	getData (QWidget *)
void	getMd (aCfg **)
void	valueChanged (const QString &, const QVariant &)
void	valueChanged (const QString &, const QVariant &, const QString &)
void	changeObj (const QString &)
void	changeObjId (const Q_ULLONG)
void	keyPressed (QKeyEvent *e)
Открытые члены
	aWidget (QWidget *parent=0, const char *name=0, WFlags fl=0)
	aWidget (const QString &oname, aDatabase *adb, QWidget *parent=0, const char *name=0, WFlags fl=0)
	aWidget (aCfgItem context, aDatabase *adb, QWidget *parent=0, const char *name=0, WFlags fl=0)
virtual bool	checkStructure ()
virtual void	initObject (aDatabase *adb)
virtual void	widgetEditor ()
virtual QDialog *	createEditor (QWidget *parent)
virtual QToolBar *	createToolBar (QMainWindow *parent)
virtual aObject *	createDBObject (aCfgItem obj, aDatabase *)
virtual QString	displayString ()
void	init (aDatabase *adb)
bool	getOpenEditor () const
void	setOpenEditor (bool)
bool	isInited ()
virtual bool	isContainer ()
void	setInited (bool flag)
aCfgItem *	getMDObject ()
void	setMDObject (aCfgItem object)
aSQLTable *	table (const QString &name="")
void	setObjectData (QWidget *object, aCfg *md)
void	getObjectData (QWidget *object)
aCfg *	getMd ()
virtual Q_ULLONG	uid ()
virtual ERR_Code	New ()
virtual ERR_Code	Update ()
virtual ERR_Code	TurnOn ()
virtual ERR_Code	Select (Q_ULLONG id)
aObject *	dataObject ()
virtual Q_ULLONG	docId ()
int	formMode () const
virtual void	setFormMode (int mode)
virtual QString	getFieldName () const
int	getId () const
void	setId (int fn)
Открытые статические члены
static void	widgetEditor (QWidget *object, QDialog *editor)
static aWidget *	parentContainer (QWidget *w)
static aForm *	parentForm (QWidget *w)
static QString	widgetName (QWidget *w)
static QWidget *	Widget (QWidget *owner, QString name)
Открытые атрибуты
aDatabase *	db
aCfg *	md
aEngine *	engine
Защищенные члены
virtual void	updateProp ()
virtual void	keyPressEvent (QKeyEvent *e)
Защищенные данные
aObject *	dbobj
Свойства
int	Id
bool	openEditor
int	FormMode

---

Подробное описание

Базовый класс для визуальных объектов. Наследует QWidget.

От него наследуют свойства и методы такие визуальные объекты как контейнеры wDocument, wJournal, wCatalog, wDocument, wReport и виджеты wField, wDBField.

---

Конструктор(ы)

aWidget::aWidget	(	QWidget *	parent = 0,
		const char *	name = 0,
		WFlags	fl = 0
	)

Конструктор, создающий абстрактный объект. Абстрактность в данном случае означает отстутствие привязки к базе данных.
Вызывает конструктор базового класса QWidget.

Аргументы:

	parent	- указатель на родительский виджет.
	name	- имя создаваемого объекта.
	fl	- флаги используемые при создании виджета. Передаются в конструктор базового класса.

aWidget::aWidget	(	const QString &	itemname,
		aDatabase *	adb,
		QWidget *	parent = 0,
		const char *	name = 0,
		WFlags	fl = 0
	)

Конструктор, использующий для создания объекта имя элемента метаданных.
У класса есть также конструктор, использующий для создания объекта ссылку на объект с описанием элемента метаданных.

Аргументы:

	itemname	- имя элемента метаданных.
	adb	- ссылка на объект доступа к базе данных.
	parent	- указатель на родительский виджет (передается в конструктор базового класса).
	name	- имя создаваемого объекта (передается в конструктор базового класса).
	fl	- флаги, используемые конструктором базового класса.

Перекрестные ссылки aDatabase::cfg, aCfg::find() и init().

aWidget::aWidget	(	aCfgItem	context,
		aDatabase *	adb,
		QWidget *	parent = 0,
		const char *	name = 0,
		WFlags	fl = 0
	)

Конструктор, использующий для создания объекта ссылку на объект элемента метаданных.
У класса есть также конструктор, использующий для создания объекта имя элемента метаданных.

Аргументы:

	context	- ссылка на объект элемента метаданных.
	adb	- ссылка на объект доступа к базе данных.
	parent	- указатель на родительский виджет (передается в конструктор базового класса).
	name	- имя создаваемого объекта (передается в конструктор базового класса).
	fl	- флаги, используемые конструктором базового класса.

Перекрестные ссылки init().

---

Методы

bool aWidget::checkStructure

(

)

[virtual]

Ничего не делает. Возвращает false.

Переопределяется в wDocument и wJournal.

void aWidget::initObject

(

aDatabase *

adb

)

[virtual]

Инизиализирует созданный объект. Необходимо выполнить setId(id), где id идентификатор обекта в конфигурации.

Аргументы:

adb

- объект доступа к базе данных.

Переопределяется в wDBField, wDocument и wJournal.

Перекрестные ссылки aDatabase::cfg, createDBObject(), aCfg::find() и aLog::print().

Используется в aEditorFactory::createEditor(), init(), wJournal::initObject(), wDocument::initObject() и wDBField::initObject().

QDialog * aWidget::createEditor

(

QWidget *

parent

)

[virtual]

Возвращает значение свойства vName.

Устанавливает значение свойства vName.

Ничего не делает. Возвращает 0.

Переопределяется в wDBField, wDocument, wField и wJournal.

QToolBar * aWidget::createToolBar

(

QMainWindow *

parent

)

[virtual]

Пока ничего не делает. Возвращает 0;

Переопределяется в wJournal.

Используется в aForm::init() и aForm::initContainer().

aObject * aWidget::createDBObject	(	aCfgItem	obj,
		aDatabase *
	)			[virtual]

Пока ничего не делает. Возвращает 0;

Переопределяется в wDocument и wJournal.

Используется в initObject().

void aWidget::init

(

aDatabase *

adb

)

Если объект не был проинициализирован, вызывает initObject(adb).

Перекрестные ссылки initObject().

Используется в aWidget() и aForm::initContainer().

void aWidget::setOpenEditor

(

bool

fn

)

Вызывает редактор свойств, если значение передаваемого параметра равно true. Редактор свойств предоставляет пользователю диалог задания значений свойств виджета. Например, для такого виджета как wDBField редактор свойств позволяет выбрать элемент метаданных описывающий поле базы данных, значение которого будет редактироваться с использованием виджета. То есть осуществить привязку данных (data bindings).

Аргументы:

fn

- параметр, значение которого должно быть равно true, для того чтобы был вызван редактор свойств.

Переопределяется в wDBField.

void aWidget::setObjectData	(	QWidget *	object,
		aCfg *	md
	)

Посылает сигнал setData( object, md ).

void aWidget::getObjectData

(

QWidget *

object

)

Посылает сигнал getData( object ).

aCfg * aWidget::getMd

(

)

Возвращает объект конфигурации для виджета верхнего уровня.

Используется в wDBTable::init() и wDBField::init().

Q_ULLONG aWidget::uid

(

)

[virtual]

Возвращает id объекта базы данных. Возвращает id текущей записи в базе данных или 0 если обект для работы с базой не создан. Id является уникальным и идентифицирует конкретный экземпляр обекта.

Возвращает:

id текущей записи в базе данных.

Перекрестные ссылки aObject::getUid() и aLog::print().

Используется в wDBTable::init(), wDocument::New(), aForm::SelectByCurrent() и aForm::SetTabValue().

ERR_Code aWidget::New

(

)

[virtual]

Создает новый объект для работы с записями базы данных. Объект создается испоьлзуя виртуальную функцию aObject::New() объекта aObject и его потомков.

Возвращает:

код ошибки.

Переопределяется в wDocument.

Перекрестные ссылки aObject::New() и aLog::print().

Используется в wDocument::New().

ERR_Code aWidget::Update

(

)

[virtual]

Обновляет данные по данному виджету в базе

Переопределяется в wDocument.

Перекрестные ссылки getFieldName(), aLog::print(), aObject::SetValue(), aObject::Update() и value().

Используется в aForm::Update() и aForm::UpdateDB().

ERR_Code aWidget::Select

(

Q_ULLONG

id

)

[virtual]

Выбирает объект в базе данных.

Аргументы:

id

- id объекта в базе данных.

Возвращает:

код ошибки.

Переопределяется в wDocument.

Перекрестные ссылки aLog::print() и aObject::select().

Используется в wDocument::Select().

QVariant aWidget::value

(

const QString &

nameWidget

)

[virtual, slot]

Возвращает значение поля. Возвращает значение поля с именем name.

Аргументы:

name

- имя поля в конфигурации.

Возвращает:

значение поля.

Перекрестные ссылки aLog::print() и value().

Используется в Update(), value() и aForm::Value().

void aWidget::setValue

(

const QString &

value

)

[virtual, slot]

Функция установки значения виджетов формы. Должна быть реализована в наследующем классе.

Аргументы:

value

- Значение виджета. Имя у виджета уже есть в момент вызова этой функции.

Переопределяется в wField.

Используется в aForm::SetValue().

int aWidget::setValue	(	const QString &	nameWidget,
		const QVariant &	value
	)			[virtual, slot]

Установка значения виджетов формы. Поддерживаемые типы виджетов: wField, wDBField, QPushButton, QLabel, QLineEdit, QCheckBox.

Аргументы:

	nameWidget	- Имя виджета.
	value	- Значение виджета.

Перекрестные ссылки aLog::print().

int aWidget::setObjValue	(	const QString &	nameWidget,
		aObject *	value
	)			[virtual, slot]

Установка значения виджетов формы сложного типа. Поддерживаемые типы виджетов: wField, wDBField.

Аргументы:

	nameWidget	- Имя виджета.
	value	- Значение виджета.

Перекрестные ссылки aObject::getUid() и aLog::print().

Используется в aForm::SetObjValue().

void aWidget::SetReadOnly

(

bool

status

)

[virtual, slot]

Устанавливает флаг толко чтение. Когда установлен этот флаг, запрещается редактирование полей виджета, и сохранение изменений в базу.

Аргументы:

status

- Новое значение флага только чтение.

Переопределяется в wField.

Используется в aForm::SetReadOnly().

void aWidget::keyPressEvent

(

QKeyEvent *

e

)

[protected, virtual]

Обрабатывает события при нажатии кнопок клавиатуры.

---

Объявления и описания членов классов находятся в файлах:

• awidget.h
• awidget.cpp