Empress GUI Examples
====================


The utility mkexdb in this directory creates a GUI database called examp_db.
Run the utility from your own directory as follows:

	$EMPRESSPATH/rdbms/gui/examples/mkexdb

It will create the example database in your current directory.


The database contains 7 example applications.  Two of them are written using
the Script Language, and the other 5 use the C API:


Script Examples		Description
-----------------------------------
DataDictionary		Displays the definitions of tables and their attributes.
ObjectBrowser		Displays lists of objects in a GUI database.


C API Examples		Description
-----------------------------------
SimpleApp		Allows selecting, inserting, deleting, updating records
			in table employee.
Images_c_api		Displays images from pictures table.  Has automatic
			slide mode.
ListApp			Displays a list of records in table employee.  Calls
			another module to insert, delete, or update a selected
			record.
ExamResults		Uses a User-Defined-Object to display a bar chart
			representing the distribution of exam results.
FlatFileApp		Displays a list of records after reading them from a
			flat file. The flatfile is copied into your own directory.



Script Examples
===============


The script examples are executed as follows:

	empgui examp_db DataDictionary

	empgui examp_db ObjectBrowser



C API Examples
==============


The C program files for the C API examples need to be compiled to executable
before running the examples. (read the Empress GUI C API manual for more
information).  For this purpose, the utility mkexgui is provided.

Run the utility as follows

	$EMPRESSPATH/rdbms/gui/examples/mkexgui

It creates an executable called ex_gui in your current directory.


Run this executable, with the database and application name as arguments:

	ex_gui examp_db SimpleApp

	ex_gui examp_db Images_c_api

	ex_gui examp_db ListApp

	ex_gui examp_db ExamResults

	ex_gui examp_db FlatFileApp
