button={ label="Dismiss" action=QUIT }
menubutton={ label="More help topics=>" 
 action="SYSTEM xtpanel -name ""$(val)"" -file help/$(val) &"
item={ label="About xtpanel" value="about" }
item={ label="message object" value="message" }
item={ label="text object" value="text" }
item={ label="button object" value="button" }
item={ label="dialog object" value="dialog" }
item={ label="slider object" value="slider" }
item={ label="choice object" value="choice" }
item={ label="list object" value="list" }
item={ label="menubutton object" value="menubutton" }
item={ label="item subobject" value="item" }
item={ label="Actions" value="actions" }
item={ label="Boxes" value="boxes" }
item={ label="Script syntax details" value="syntax" }
}
text={ value='

Welcome to the xtpanel script generator.

Using this generator, you can construct panels without having
to learn the xtpanel script language or command line interface.
The generator builds a script file for you, letting you add
any xtpanel object (button, slider, message, dialog, etc.) and
specify its attributes, including what should happen when the
object is modified.

The upper part of the main generator panel pertains to the script
file being built. You can name the script file, view it (a good
way to learn the scripting language, by seeing a script as it
is built) or delete the script. You can also run xtpanel on the
script file to see what you have built.

In the middle section are buttons for each xtpanel object;
click on any of these to add an object to the panel that you are
building. Clicking on these buttons brings up another panel where
you see all the attributes that apply to each object. You
can modify each attribute, or allow it to default.
Multi-item objects such as choices, lists, and menubuttons let
you add items. When you have finished designing an object, you are
back at the main panel, where you may add other objects, or examine 
or try out the script.

xtpanel supports the following objects:

     message   Displays a single line of text.

     text      Displays multiple lines of text  in  a  scrollable
               area.

     button    A single button.

     dialog    Provides an editable text field.

     slider    Allows the user to choose a value from a range  of
               integer or floating point values.

     choice    A group of buttons,  only  one  of  which  may  be
               selected at a time.

     menubutton
               A button with a menu attached.

     list      A list of character strings, only one of which may
               be selected at a time.


Clicking on an object type brings up a panel where you can
specify parameters for that object. Most objects have four basic 
parameters:

label	This is annotation that appears on the screen, such as the
	name on a button, or text above a slider or choice.
	For the read-only objects message and text, this is the
	text that they display on the screeen.

action	This is a string that dictates what happens when an object
	wants to output its value. Objects can write their value to
	standard out, make a call to system(), save their value in
	a string for use by other objects, or quit xtpanel.

name	You can give a name to an object if you want other objects
	to be able to access its value in their output strings. If
	no other objects are interested in an object's value, then it
	need not be given a name.

value	This is the starting value for an object. For sliders, the
	slider is positioned to this value. For dialogs, this text
	appears in the dialog field at startup. For multi-item
	objects such as choices, lists, and menubuttons, if this
	value matches the value of one of the items, then that item
	will be selected and highlighted when the panel comes up.

In an xtpanel script, you need not specify a value for each attribute;
defaults are provided. The same is true in the generator.

The box options at the bottom of the main panel allow you to construct
boxes in which objects are grouped together, and laid out horizontally
or vertically. Using boxes gives you more control over the layout
of a panel.

Most of the panels brought up by the generator have help buttons
from which you can learn more.

'
height=300 width=750 }
