.H 1 TitleBar widget
.sp 3
.P
The titlebar widget is made up of a label, two buttons, and
a geometry manager.  It allows an application to create
and display a rectangular titlebar. 
The titlebar size and location are arbitrary and are
specified by the application.  However, a titlebar is 
normally placed along the top of the window, and runs the
full length of the window.
.P
When an application creates a titlebar, some degree of 
customization is allowed.  The two gadget
boxes (buttons) are optional.  If not passed in, they will
not be displayed.  If only the text strings are passed in,
the gadget boxes are created for the user. (Passing in widget ids
for the gadget boxes is only possible in V11 of X where 
reparenting is possible.)
.DS

The three components of the titlebar are:
title string            The most common use for a titlebar is to
			display a string, which provides some 
			indication to the user as to what a window
			is being used for.  When specified, a title
			string will be displayed in the center of the
			titlebar, using the font specified by the
			application.

gadget buttons          Sometimes an application will wish to provide
			a means for allowing a user to easily and
			quickly request some frequently used action.
			Two gadget buttons are provided for just this 
			purpose (one in the left corner and one in the
			right corner).  The application may specify any
			pair of valid command buttons, which will
			serve to describe what action will occur when
			the gadget button is selected.  For example, 
			if a program wanted to set one of the buttons up to
			produce help information when it is selected, 
			then it might choose to define the button 
			with a label of "HELP".  When a user selects
			one of the gadget boxes with the mouse,
			notification will be passed on to the application
			by means of a callback procedure.

.DE
.P
When creating a titlebar widget instance, the following argList values
(atoms) are available to the application.  The table is organized such 
that the atom name, the type of the value associated with the
atom name, and the default value are listed.

.LP
Table :  TitleBar Arguments
.ps 8
.TS H
l l l l .
_
.sp 6p
.TB
Name	Type	Default	Description
.sp 6p
_
.sp 6p
.TH
.R
XtNwindow	Window	NULL	Window for Titlebar
XtNborderWidth	int	NULL	Titlebar border width 
XtNwidth	int	0	Width of titlebar
XtNheight	int	0	Height of titlebar
XtNinternalHeight	int	4	An alternate way to specify height
XtNlabel	int	NULL	The titlebar string
XtNforeground 	int	BlackPixel	Foreground color
XtNbackground 	int	WhitePixel	Background color
XtNleftLabel	char *	NULL	Left gadget box label
XtNrightLabel	char *	NULL	Right gadget box label
XtNfunction	int (*proc)()	NULL	Callback for titlebar
XtNparameter	(caddr_t)	NULL	Argument to callback proc
XtNborder 	Pixmap *	BlackPixmap	border color
XtNfont 	FontInfo *	NULL	Title font
XtNreason 	int	NULL	reason for callback
XtNleftBox	Window	NULL	Left gadget box
XtNrightBox	Window	NULL	Right gadget box
.sp 6p
_
.TE
.P
The syntax for creating a titlebar widget is:

      XtTitleBarCreate(pw,arglist,argcount) ;
      Window pw ;         /* parent window */
      Arglist arglist ;   /* a variable length arglist */
      int argcount ;      /* number of args in arglist */
