Tcl/Tk, Second Edition: A Developer's Guide (The Morgan Kaufmann Series in Software Engineering and Programming)

TeamLiB......Page 1
Cover......Page 2
Foreword......Page 7
Contents......Page 9
Tcl/Tk: GUI Programming in a Gooey World......Page 27
Acknowledgments......Page 29
Introduction......Page 31
Where to Get More Information......Page 32
1 Tcl/Tk Features......Page 35
Tcl Overview......Page 36
The Standard Tcl Distribution......Page 37
Tcl As a Glue Language......Page 40
Tcl Scripts Compared to UNIX Shell Scripts......Page 42
Tcl As a General-Purpose Interpreter......Page 43
Tcl/Tk Compared to Visual Basic......Page 44
Tcl/Tk Compared to Python......Page 45
Tcl/Tk Compared to Java......Page 46
Tcl As a Rapid Development Tool......Page 47
Shipping Products......Page 49
Problems......Page 50
The tclsh and wish Interpreters......Page 53
Starting the tclsh and wish Interpreters......Page 54
Errors Caused by Improper Installation......Page 55
Starting tclsh or wish Under Microsoft Windows......Page 56
Exiting tclsh or wish......Page 57
tclsh As a Command Shell......Page 58
Evaluating Scripts Interactively......Page 59
Evaluating Tcl Script Files......Page 60
The Tcl Script File......Page 61
Evaluating a Tcl Script File Under UNIX......Page 62
Evaluating a Tcl Script File Under Microsoft Windows......Page 63
Bottom Line......Page 67
Problems......Page 68
3 Introduction to the Tcl Language......Page 71
Syntax......Page 72
Comments......Page 74
Data Representation......Page 75
Errors......Page 76
and the Backslash......Page 77
Steps in Command Evaluation......Page 79
Assigning Values to Variables......Page 80
Strings......Page 82
String Processing Commands......Page 83
String and Format Command Examples......Page 89
Lists......Page 90
List Processing Commands......Page 91
Associative Arrays......Page 96
Associative Array Commands......Page 97
Binary Data......Page 100
Math Operations......Page 103
Conditionals......Page 106
The if Command......Page 107
The switch Command......Page 108
The for Command......Page 111
The foreach Command......Page 112
Procedures......Page 114
Bottom Line......Page 115
Problems......Page 117
Navigating the File System......Page 121
Properties of File System Items......Page 125
Input/Output in Tcl......Page 128
Input......Page 129
Creating a Channel......Page 131
Closing Channels......Page 133
Using a Client Socket......Page 134
Controlling Data Flow......Page 137
Server Sockets......Page 139
Bottom Line......Page 142
Problems......Page 144
Converting a String into a List......Page 147
Examining the List with a for Loop......Page 148
Using the foreach Command......Page 151
Using lsearch......Page 152
Basic Regular Expression Rules......Page 154
Minimum and Maximum Match......Page 156
Character Classes, Collating Elements, and Equivalence Classes......Page 157
Tcl Commands Implementing Regular Expressions......Page 158
Back to the Searching URLs......Page 161
The proc Command......Page 163
A findUrl Procedure......Page 164
Variable Scope......Page 165
Global Information Variables......Page 166
The Executable Script......Page 167
Speed......Page 169
Bottom Line......Page 170
Problems......Page 171
6 Building Complex Data Structures with Lists and Arrays......Page 175
Manipulating Ordered Data with Lists......Page 176
Manipulating Data with Keyed Lists......Page 179
Using the Associative Array......Page 181
Exception Handling in Tcl......Page 183
Loading Code from a Script File......Page 187
Tree Library Description......Page 188
Tree Library Naming Conventions......Page 189
Procedures Using Call-by-Name Arguments......Page 192
Creating a New Tree......Page 195
Creating a New Child Node......Page 196
Tree Library As a Container Class......Page 199
Generating Unique Names......Page 202
Using the Tree Library......Page 203
Speed Considerations......Page 206
Bottom Line......Page 207
Problems......Page 209
Arguments to Procedures......Page 213
Variable Number of Arguments to a Procedure......Page 214
Default Values for Procedure Arguments......Page 215
Renaming or Deleting Commands......Page 216
Getting Information About Procedures......Page 218
Performing Variable Substitution on a String......Page 220
Evaluating a String as a Tcl Command......Page 221
Working with Global and Local Scopes......Page 223
Global and Local Scope......Page 224
Making a Tcl Object......Page 230
An Object Example......Page 231
Creating a Tree Object......Page 232
Defining the Objects Method......Page 234
Bottom Line......Page 242
Problems......Page 243
8 Namespaces and Packages......Page 247
Namespace Scope......Page 248
Accessing Namespace Entities......Page 250
The namespace and variable Commands......Page 251
Creating and Populating a Namespace......Page 256
Namespace Nesting......Page 258
Packages......Page 262
Internal Details: Files and Variables Used with Packages......Page 263
Package Commands......Page 264
Version Numbers......Page 266
Using a Tcl Package......Page 267
Adding Namespace and Package to treetcl......Page 268
The Tree Object in a Namespace......Page 270
Nesting Packages......Page 271
Loading the tree Module into the treeObject......Page 272
Procedures and Namespace Scopes......Page 274
Namespaces and Packages......Page 276
Bottom Line......Page 278
Problems......Page 279
9 Introduction to Tk Graphics......Page 283
Creating a Widget......Page 284
Widget Naming Conventions......Page 285
Common Options......Page 286
Determining and Setting Options......Page 287
The Basic Widgets......Page 290
Introducing Widgets: label, button, and entry......Page 291
Widget Layout: frame, place, pack, and grid......Page 296
The frame Widget......Page 297
The place Layout Manager......Page 298
The pack Layout Manager......Page 299
The grid Layout Manager......Page 305
Working Together......Page 306
radiobutton......Page 307
checkbutton......Page 309
Pull-Down Menus: menu, menubutton, and menubars......Page 311
Menubars......Page 320
Selection widgets: listbox......Page 322
The Basic scrollbar......Page 327
scrollbar Details......Page 330
Intercepting scrollbar Commands......Page 332
The scale Widget......Page 336
New Windows......Page 338
Interacting with the Event Loop......Page 339
Scheduling the Future: after......Page 340
Canceling the Future......Page 343
Bottom Line......Page 344
Problems......Page 345
Overview of the canvas Widget......Page 349
Binding......Page 350
Creating a canvas Widget......Page 351
Creating Displayable Canvas Items......Page 352
The Arc Item......Page 353
The Polygon Item......Page 354
The Bitmap Item......Page 355
The Image Item......Page 356
More canvas Widget Subcommands......Page 357
Modifying an Item......Page 358
Changing the Display Coordinates of an Item......Page 359
Moving an Item......Page 361
Finding, Raising, and Lowering Items......Page 363
Fonts and Text Items......Page 368
Using a Canvas Larger Than the View......Page 371
The bind Command......Page 372
Event Def inition Examples......Page 374
The canvas Widget bind Subcommand......Page 375
Focus......Page 378
Creating a Widget......Page 379
A Help Balloon: Interacting with the Window Manager......Page 387
The image Command......Page 397
Bitmap Images......Page 399
Photo Images......Page 400
Revisiting the delayButton Widget......Page 404
Bottom Line......Page 409
Problems......Page 410
11 The text Widget and htmllib......Page 413
Text Location in the text Widget......Page 414
Index Examples......Page 415
Tag Overview......Page 416
Window Overview......Page 417
Creating a text Widget......Page 418
Text Widget Subcommands......Page 420
Inserting and Deleting Text......Page 421
Searching Text......Page 423
The mark Subcommands......Page 425
Creating and Destroying Tags......Page 428
Finding Tags......Page 429
Using Tags......Page 433
Inserting Images and Widgets into a text Widget......Page 436
Displaying HTML Text......Page 440
Hypertext Links......Page 442
Interactive Help with the text Widget and htmllib......Page 448
Bottom Line......Page 452
Problems......Page 454
Standard Dialog Widgets......Page 457
tk_optionMenu......Page 458
tk_chooseColor......Page 459
tk_getOpenFile......Page 460
tk_messageBox......Page 463
tk_dialog......Page 465
tk_popup......Page 466
Display in Application Window or Main Display?......Page 469
Widget Frames......Page 470
Naming Convention......Page 471
Functionality That Makes Megawidgets Possible......Page 472
The option Command......Page 473
Building a Megawidget......Page 475
scrolledListBox Description......Page 476
Using the scrolledLB......Page 479
Implementing the Scrollable ListBox......Page 480
The scrolledLB Code......Page 482
Namespaces and Tk Widgets......Page 488
Creating a Multiple-Language Megawidget......Page 489
Incorporating a Megawidget into a Larger Megawidget......Page 498
Making a Modal Megawidget: The grab and tkwait Commands......Page 507
The grab Command......Page 508
The tkwait Command......Page 509
The Modal Widget Code......Page 510
Building Megawidgets from a Skeleton......Page 515
Building Megawidgets from a Conguration File......Page 522
Another Technique for Building Megawidgets......Page 528
Bottom Line......Page 532
Problems......Page 533
13 Writing a Tcl Extension......Page 537
Functional View of a Tcl Extension......Page 538
Register New Commands with the Interpreter......Page 539
Accept Data from Tcl Interpreter......Page 541
Data Representation......Page 542
Obtaining the Data......Page 544
Returning Results......Page 545
Returning Status to the Script......Page 549
Dealing with Persistent Data......Page 550
Building an Extension......Page 554
Function Names......Page 555
File Names......Page 556
Directory Tree......Page 557
An Example......Page 558
demoInth......Page 560
demoInitc......Page 563
demoCmdc......Page 565
demoDemoc......Page 572
Demo_CreateCmd......Page 573
Demo_GetCmd......Page 577
Demo_DestroyCmd......Page 580
Demo_SetCmd......Page 582
Complex Data......Page 587
Bottom Line......Page 598
Problems......Page 601
14 Extensions and Packages......Page 603
[incr Tcl]......Page 605
expect......Page 609
TclX......Page 615
Sybtcl and Oratcl......Page 619
mysqltcl......Page 621
VSdb Package......Page 625
VSdb Example......Page 628
BWidgets......Page 630
BLT......Page 637
Graphics Extensions: img......Page 641
Bottom Line......Page 642
15 Programming Tools......Page 643
Code Formatter......Page 645
frink......Page 646
tclCheck......Page 650
ICEM ice_lint......Page 651
procheck......Page 652
debug......Page 653
Graphic Debuggers......Page 655
Tuba......Page 656
TclPro prodebug......Page 657
SpecTcl......Page 659
Visual GIPSY......Page 662
Tcl Compilers......Page 664
ICEM Tcl Compiler......Page 665
TclPro procomp......Page 666
freewrap......Page 667
Starkit and Starpack......Page 668
SWIG......Page 670
CriTcl......Page 673
ASED......Page 675
Komodo......Page 676
MyrmecoX......Page 677
Bottom Line......Page 679
Examine the Call Stack with the info level Command......Page 681
Examine Variables When Accessed with trace Command......Page 682
Run Script in Interactive Mode......Page 684
Use puts to Print the Value of Variables or Lines to Be Evaluated......Page 685
A Bitmapped Conditional......Page 686
Printing Every Line......Page 0
Attach a tkcon Session to Application......Page 688
Interact with Your Application......Page 689
Tcl As a Glue Language: The exec Command......Page 692
Creating a G-zipped tar Archive Under UNIX......Page 694
Common Mistakes......Page 695
The tclsh Shell Is Not COMMANDCOM......Page 696
Calculating the Time: Numbers in Tcl......Page 697
The incr Command Works Only with Integers......Page 698
Be Aware of Possible % Sign Reduction......Page 699
Use Procedures Instead of switch Statements to Parse Input......Page 700
Use eval to Set Command Line Arguments......Page 701
Declare Globals in a Single Location......Page 703
Handling Platform-Specific Code......Page 704
Bottom Line......Page 705
App A About the CD-ROM......Page 707
How Do I Find Those Extra Goodies?......Page 708
Installing Tcl/Tk on a Macintosh......Page 709
Installing Tcl/Tk on MS Windows......Page 714
Installing Tcl/Tk on UNIX/Linux Systems......Page 718
Installing ActiveTcl......Page 719
Installing Other Compiled Tcl/Tk Distributions......Page 723
Compiling Tcl/Tk......Page 724
Large Systems Installation......Page 726
Installing the BLT Extension......Page 729
Installing the expect Extension......Page 731
Installing the img Extension......Page 732
Building the img Extension Under UNIX......Page 733
Installing [incr Tcl] on a Macintosh......Page 734
Installing the 22 Release for Tcl Version 76......Page 735
Installing the MySqlTcl Extension......Page 736
Installing the 2.5 oratcl Extension Under MS Windows......Page 737
Installing the 4.0 oratcl Extension Under MS Windows......Page 738
Installing the sybtcl Extension......Page 739
Installing the sybtcl Extension Under UNIX......Page 740
Installing the TclX Extension on a Macintosh......Page 741
Installing the TclX Extension Under UNIX......Page 742
Installing the BWidget Package......Page 743
More Information......Page 745
Compiling frink Under MS Windows......Page 746
tclCheck......Page 747
Compiling tclCheck Under UNIX......Page 748
Installing the TclPro Suite on MS Windows......Page 749
Compiling tcl-debug Under UNIX......Page 750
Installing SpecTcl Under MS Windows......Page 751
Installing SpecTcl on a PPC- based Macintosh......Page 752
Installing Visual Gipsy Under MS Windows......Page 753
Installing Freewrap Under MS Windows......Page 754
Installing and Compiling Freewrap Under UNIX......Page 755
Installing SWIG Under MS Windows......Page 756
Installing SWIG on a Macintosh......Page 757
Unpacking the megaWidget Distribution......Page 758
Installing Komodo Under Linux......Page 759
Neatware MyrmecoX IDE......Page 760
Accessing the Tutorials......Page 761
Installing TclTutor Under UNIX......Page 762
Accessing the Extra Documentation......Page 763
Accessing the Extra Articles......Page 764
Index of Commands......Page 765
A......Page 767
B......Page 768
C......Page 769
D......Page 771
E......Page 772
F......Page 773
H......Page 775
I......Page 776
K......Page 777
L......Page 778
M......Page 779
O......Page 781
P.Q......Page 782
S......Page 784
T......Page 787
V......Page 791
W.Z......Page 792