*****************************
* VDK Gnome support classes *
*     VDK version 1.0.4     *
*****************************
General notes:
Version 1.0.4 has an incomplete but working gnome-aware
application support. Gnome support consists in a shared lib
named libvdkgnome-1.0.0.so and several header files.

=========================
class VDKGnomeApplication
<vdk/vdkgnomeapp.h>
=========================
Inherits from VDKApplication

Description
-----------
This class encapsulate most of behaviours of a gnome-aware
application. Initialize gnome libs as well.

Methods
-------
VDKGnomeApplication(char* app_id,char* title,int* argc,	char** argv);
  Constructor

Note: if your application uses one of gnome widgets you must
use this class. Normal VDKApplications using a gnome widget
don't work.



====================
class VDKGnomeForm
<vdk/vdkgnomeform.h>
====================
Inherits from VDKForm

Description
-----------
This class encapsulate most of behaviour of a gnome-aware application
main form. We stronlgly recommend to use this class as your
application main form.

Methods
-------
VDKGnomeForm(VDKGnomeApplication* app, char* title = (char*) NULL,
		 int mode = v_box);
  Constructor


=====================
class VDKGnomeAppBar
<vdk/vdkgnomeappbar.h>
=====================
Inherits from VDKObject

Description
-----------
This class wraps gnome_application_bar widget. It works like
VDKStatusbar but having an optional inner progress bar.
Furthermore status bar can be interactive
(planned in gnome future).

Properties
----------
char* Default
float Progress

Methods
------
void Push(char* msg)
     Pushes a <msg> on status bar
void Pop()
     Pops status bar
void Clear()
     Clear status bar
void Refresh()
     Refreshes status bar stack
void SetDefault(char* default_status)
     Set default msg appearing on status bar
void SetProgress(float value)
     Set progress bar value in percentage (0 <= p <= 1)
float GetProgress()
     Get progress value.

Using properties
----------------
Default
Sets/gets default displayed msg into status bar

Progress
Sets/gets progress bar value in percentage (0 <= p <= 1)



=======================
class VDKGnomeDateEdit
<vdk/vdkgnomededit.h>
=======================
Inherits from  VDKObject

Description
-----------
VDKGnomeDateEdit acts like a normal entry widget, but
can show a "time" field as well.
A button is added to the widget that can be used to pop
up a calendar widget. Actually support english date format
only (mmddyyyy), there are plans to support also european
format in the next future.

Properties
----------
time_t AbsoluteTime;
calendardate Date;

Methods
-------

VDKGnomeDateEdit(VDKForm* owner,
		  time_t the_time = NULL,
		  bool show_time = false,
		  bool format24 = true,
		  int mode = mmddyyyy);
Constructor, makes a VDKGnomeDateEdit initializing it with
a date passed in time_t format. Widget can show also time entry
in both AM/PM or H24 format pending on args value.

VDKGnomeDateEdit(VDKForm* owner,
		  char* the_date = NULL,
		  bool show_time = false,
		  bool format24 = true,
		  int mode = mmddyyyy);

Constructor, makes a VDKGnomeDateEdit initializing it with
a date passed in "mm/dd/yyyy" format.
Widget can show also time entry in both AM/PM or H24 format
pending on args value.

Note:
<mode> arg is unused for the moment and forced to be mmddyyyy in
any case.

void SetAbsoluteTime(time_t t)
 Sets absolute time
time_t	GetAbsoluteTime()
 Gets absolute time
void SetDate(calendardate d)
 Sets date
calendardate GetDate()	
 Gets date as calendardate object.

Using properties
----------------

AbsoluteTime
 Sets/gets absolute time in time_t format
Date
 Sets/gets date as calendardate object.


=====================
class VDKGnomeEntry
<vdk/vdkgnomeentry.h>
=====================
Inherits from VDKCombo

Description
-----------
VDKGnomeEntry acts like a VDKCombo with an "history" list
filled with user entries.

Properties
----------
char* History;
unsigned int MaxSaved;

Methods
-------
VDKGnomeEntry(VDKForm* owner,
		  char* def = (char*) NULL,
		  char* history = NULL,
		  );
 Constructor, setting history to NULL reset any previous
 history data.

void SetHistory(char* history)
 Sets history id, setting history to NULL clears any previous
 history data

void SetMaxSaved(unsigned int max)
 Sets max number of history items. (defaults to 10)

Using properties
----------------
History
 Sets/gets history id, setting history to NULL clears any previous
 history data

SetMaxSaved
 Sets/gets max number of history items. (defaults to 10)