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