*********************
VDKCustomButton class
********************
Inherits from VDKObject

Description
-----------
This class provides an unified wrapper for: GtkButton and GtkToggleButton.
Substitutes previous:
VDKLabelButton, VDKPixmapButton, VDKToggleLabelButton,VDKTogglePixmapButton.
This classes should be considered obsolete, its use is deprecated since them
will be cancelled in future vdk versions.

PUBLIC MEMBERS
--------------
None

PROPERTIES
----------
VDKBox		*ButtonBox (read-only)
VDKLabel	*Label	   (read-only)
VDKPixmap	*Pixmap	   (read-only)
char		*Caption
bool		 CaptionWrap
bool		 Checked
GtkReliefStyle	 Relief

METHODS
-------
VDKCustomButton(VDKForm* owner, char* label,  bool isToggled = false)
	Makes a labeled button, a toggle button if <isToggled> arg is
	set to <true>

VDKCustomButton(VDKForm* owner, char* pixfile,  char* label,
		  GtkPositionType position = GTK_POS_RIGHT,
		  bool isToggled = false);
	Makes a pixmapped  button, a toggle button if <isToggled> arg is
	set to <true>. Pixmap will be loaded from <pixfile>,
	<label> can be NULL.

VDKCustomButton(VDKForm* owner,  char** pixdata, char* label,
		  GtkPositionType position = GTK_POS_RIGHT,
		  bool isToggled = false);
	Makes a pixmapped  button, a toggle button if <isToggled> arg is
	set to <true>. Pixmap will be loaded from <pixdata>,
	<label> can be NULL.

~VDKCustomButton();
	Destructor


USING PROPERTIES
----------------

Label

Permits to access embedded VDKLabel.
Tip:
// this code permits to change label justification
VDKCustomButton *button = new VDKCustomButton(this, "A label");
VDKLabel* label = button->Label;
if(label)
	label->Justify = GTK_JUSTIFY_RIGHT;


Pixmap

Permits to access embedded VDKPixmap.
Tip:
// this code permits to change button pixmap
VDKCustomButton *button = new VDKCustomButton(this, "A label");
VDKPixmap* pixmap = button->Pixmap;
if(pixmap)
	pixmap->SetPixmap("pixmap.xpm");

ButtonBox
Permits to access embedded VDKBox that contains a VDKLabel and a VDKPixmap.


Caption
Permits to set/get label caption

CaptionWrap
Permits to set/get label caption wrap mode

Checked
Permits to set/get cheked state. (Meaningless if button isn't
a toggle button)

Relief
Permits to set/get button relief mode. (Meaningfull if button isn't
a toggle button)



