1# README --
2#
3# SCCS: @(#) README 1.2 97/07/30 14:45:44
4
5# Each "paragraph" describes an example application
6# most of which are explained in detail in the
7# SpecTcl User's Guide. Some are interesting in
8# themselves; others are only meant to complement
9# the explanation in the gude.
10
11# After you build the exAssemS.ui assembly, you should
12# run it's partner: exAssemM.ui. The exAssemM.ui
13# example loads exAssemS.ui twice to show the
14# widget name qualification that enables this to
15# work.
16
17# The exAssemM.ui example demonstrates how you
18# can develop some interfaces as subassemblies
19# and then load them at run-time into frames.
20# First you must do a build of exAssemS.ui so you
21# have the Tcl file exAssemS.ui.tcl. Then run
22# build and run exAssemM.ui.
23# The main point is that the scale assembly
24# exAssemS.ui.tcl is loaded twice. To see the name
25# qualification that makes this work, look at
26# the code generated for exAssemM.ui.tcl. And
27# note how the statements below load exAssemS_ui
28# into frames.
29
30
31# The exButton.ui example demonstrates that a button
32# can display an image file instead of text.
33
34# The exCheckbutton.ui example demonstrates the
35# way a script determines which checkbutton was clicked.
36
37# The exEntry.ui example shows how to bind an
38# individual entry widget to a Key-Return event
39# and how to use a bindtag (Entry) that bind
40# all entry widgets to a Key-Return event.
41
42# The exFrame.ui example is used to show how to
43# select the frame and elements within the frame.
44# It also demonstrates how the frame can pass on
45# application-window space to its children, and how
46# this is under your control as design time.
47
48# The exHello.ui example shows how to call a proc from
49# a button's command property
50
51# The exLabel1.ui example shows a label displaying text
52# to identify another widget
53
54# The exLabel2.ui example toggles between showing a
55# long and short strings to show how the interface
56# adjusts.
57
58# The exListbox.ui example demonstrates the working
59# of a listbox. After, displaying four items in the
60# listbox, the script displays text and an image when
61# any of the listbox items is clicked.
62
63# The exLong1.ui example shows:
64# -- How to capture text from an entry widget
65#    when the user presses the Return key.
66# -- How to use the Button command property to
67#    call a proc.
68#
69
70# The exMenubutton.ui example shows how a script
71# builds menus and how menubuttons communicate with
72# the script.
73
74# The exMessage.ui example demos the message widget.
75# When you enter a long string of text in the entry widget
76# and press the Return key, the message widget adds
77# newline characters and displays the message. When you
78# click on a button, you change the aspect property of
79# the message widget.
80
81# The exRadiobutton.ui example shows the way
82# a script can determine which radiobutton
83# was "pushed".
84
85# The exRadiobutton2.ui example demonstrates the way
86# labels can resize themselves to accommodate the text
87# or image that they are currently displaying
88
89# The exRelief.ui example demonstrates each of the options
90# for the relief property: plain, raised, sunken,
91# ridge, and groove.
92
93# The exResize.ui example shows the affect of
94# setting resizeability on and off for rows and
95# columns. After building and running this application,
96# resize the application window and notice which
97# widget change size and which stay the same.
98
99# The exScale.ui example shows the following:
100# -- That moving the scale changes the value.
101# -- That changing the value (by clicking on the
102#    +5 or -5 buttons) causes the scale to move.
103# -- That when you tie the scale value to a widget
104#    (the width of the "resizable" label), that
105#    a width of 0 (which means "resize yourself" is
106#    actually wider than, say a width of 5.
107
108# The exScrollbar.ui example show how the scrollbar
109# widget interacts with the text widget.
110
111# The exSize1.ui example has a default sticky property
112# so that the widgets are self-sized. Contrast this with
113# exSize2.ui.
114
115# The exSize2.ui example has a sticky property of ew
116# so that the widgets are aligned. Contrast this with
117# exSize1.ui.
118
119# The exSticky.ui example shows the various positions
120# a widget takes in its grid cell with different
121# sticky properties
122
123# The exText.ui example shows how the text and
124# scrollbar widgets work and interact.
125