Visualage for Smalltalk Handbook Volume 1: Fundamentals
Total Page:16
File Type:pdf, Size:1020Kb
SG24-4828-00 VisualAge for Smalltalk Handbook Volume 1: Fundamentals September 1997 SG24-4828-00 International Technical Support Organization VisualAge for Smalltalk Handbook Volume 1: Fundamentals September 1997 IBML Take Note! Before using this information and the product it supports, be sure to read the general information in Appendix A, “Special Notices.” First Edition (September 1997) This edition applies to VisualAge for Smalltalk, Versions 2, 3, and 4, for use with OS/2, AIX, and Microsoft Windows 95/NT. Comments may be addressed to: IBM Corporation, International Technical Support Organization Dept. QXXE Building 80-E2 650 Harry Road San Jose, California 95120-6099 When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. Copyright International Business Machines Corporation 1997. All rights reserved. Note to U.S. Government Users — Documentation related to restricted rights — Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. Contents Preface . xv How This Redbook Is Organized ....................... xvi ITSO on the Internet ............................... xvii VisualAge Support on CompuServe ..................... xix About the Authors ................................ xix Acknowledgments . xx Comments Welcome . xxi Chapter 1. What Is VisualAge for Smalltalk? ................. 1 Description of VisualAge for Smalltalk ..................... 1 VisualAge for Smalltalk Technology ...................... 1 Description of Smalltalk ............................. 2 Description of ENVY ................................ 2 Stability and Maturity ............................... 2 Openness . 3 Team or Professional Version .......................... 3 Advantages of VisualAge ............................. 3 Advantages of Smalltalk ............................. 4 VisualAge for Smalltalk and VisualAge Generator .............. 5 VisualAge for Smalltalk and C++ ....................... 5 Visualizer . 6 Team Connection . 6 Supported Platforms . 6 Smalltalk Strategy . 7 Smalltalk and Java ................................ 7 Configuration Management . 7 Packaging Support . 8 Database Support . 8 Communication Protocol Support ........................ 8 Legacy Code . 9 Runtime Distribution Fees ............................ 9 Distributing Smalltalk Compiler ......................... 9 Source Code Availability ............................. 9 Upward Compatibility . 10 Common User Access Compliance ....................... 10 Multiple Inheritance . 10 Porting Smalltalk Applications .......................... 10 Sources of Support ................................ 11 TalkLink . 11 CompuServe . 12 Usenet . 12 Copyright IBM Corp. 1997 iii Resource Catalog . 12 Learning Courses . 13 New Features in Version 3 ............................ 13 New Features in Version 4 ............................ 14 Chapter 2. General Information . 23 Cleaning Up the Image .............................. 23 Creating a New Image .............................. 23 Reducing Image Size ............................... 24 Preventing Image Growth ............................ 25 AbtScrubImage . 25 Ghosts . 26 Image Growth after Packaging ......................... 26 Keeping Multiple Versions on the Same System ............... 26 Replacing the Default Icon ............................ 27 Escaping an Infinite Loop ............................. 27 File-In and File-Out ................................ 28 Separate Threads . 28 Capturing Stack Information ........................... 28 Renaming a Class ................................. 29 Environment Variable . 29 Registered Connection . 30 Loading Different Image ............................. 30 Deferred Update Part ............................... 30 Renaming a Visual Part ............................. 31 Hover Help for Buttons .............................. 32 Customizing Connection Menu ......................... 33 Live Updating of Images ............................. 33 Passing Parameters Between Windows .................... 34 Generating Archival Code ............................ 34 Deleting Parts with Instances .......................... 35 Change Table Format ............................... 36 Error Messages . 36 Removing Archival Code ............................. 37 Apply Push Button ................................. 38 Inspector . 38 Multimedia . 38 Default Memory . 39 Storing Settings . 39 Extending Classes . 40 Running VisualAge from External SCSI Drive ................. 40 Damaged Classes . 40 Extending Classes . 41 Modifying the System Menu ........................... 41 iv VisualAge for Smalltalk Handbook − Fundamentals Organizer Views . 42 File in Use ...................................... 43 OS/2 Shutdown . 43 BRW Format Generator .............................. 43 Loaded Method . 44 Missing Character Set .............................. 44 Event Triggering . 44 Part not Visible ................................... 45 Removed Class . 45 Synchronizing Attributes . 45 Keeping the Packaged Image Small ...................... 46 Including Classes in a Package ......................... 46 Packaging for AIX from OS/2 .......................... 47 Loading Application in a Run-time Image ................... 47 Packaging an Application for Windows .................... 48 Icons and DLLs ................................... 48 Packaging a Workspace ............................. 48 Image Reduction . 48 Ensuring that Needed Classes are Packaged ................. 49 Class Modifications and Packaging ....................... 49 Merging Application Files into Run-time Image ............... 49 Missing Icons . 50 Required .CAT Files ................................ 50 Packaging Pool Dictionaries ........................... 51 Application Prerequisites . 52 Missing Classes in the Run-time Image .................... 52 Missing Method in Package ........................... 53 Run-time Image Packaging Problem ...................... 54 Generating Getters and Setters ......................... 54 High Performance Trace Logging ........................ 54 Closing a DLL from Smalltalk .......................... 55 Unloading When Instances Exist ........................ 56 Testing When Looping Walkbacks Occur ................... 56 Quickly Disabling Methods ............................ 56 Specifying Public or Private with TrailBlazer ................. 57 Browse and Find in the Pop-Up Menu ..................... 57 Versioning Applications Not Owned ...................... 61 Client Not Supported ............................... 61 AbtRecord . 62 Indexed Message Editor ............................. 62 Corrupted MRI File ................................ 63 Class Naming Convention ............................ 63 Category Naming . 66 Archival Code is Missing ............................. 68 Contents v Meaning of Application Errors .......................... 68 Error: ′Undefined Object does not understand messageString′ ...... 69 Error on Saving a Part .............................. 69 Inappropriate VisualAge Icon .......................... 70 Double Execution of Script ............................ 70 Error 203 ....................................... 71 Removing Elements from a View ........................ 71 Class EmLibraryStatistics . 71 Error: rc=12 . 72 Error: SYS317x . 72 Error: Primitive Error Codes 52 through 55 .................. 73 Error: Does Not Understand Format ...................... 73 Menu on Windows NT 4.0 ............................ 74 Back-tabbing in Container Details Views ................... 74 Properties Views and Notebook Settings Views ............... 75 Code Page Conversion Errors .......................... 75 Determining Required ICs ............................ 75 Required CAT and MPR Files for an IC Run-time Image .......... 76 Required CAT and MPR Files for a Reduced Run-time Image ....... 78 Format Change for CTLs ............................. 80 Unloading the Visualization Feature ...................... 82 Manager Access . 82 Opening Multimedia Devices .......................... 84 Using Digital Video Player on OS/2 ....................... 84 Video Disk Player ................................. 84 Crystal Wave and MWave Audio Cards .................... 85 AVA Playback Windows .............................. 85 Lotus Notes . 85 Chapter 3. Graphical User Interface ...................... 87 GUI Architecture . 87 Mapping Widgets Across Systems ....................... 87 Motif Documentation . 88 Interface to Windows 95 ............................. 88 Applications with Multiple Windows ...................... 89 Exit Dialog Message Box ............................. 89 Window Location . 90 Positioning Window at Cursor .......................... 90 Maximizing a Window ............................... 91 Opening Window Maximized ........................... 92 Display Resolution . 92 Opening Window Centered ............................ 93 Window Space Planning ............................. 93 Iterating over Widgets ............................... 94 vi VisualAge for Smalltalk Handbook − Fundamentals Modal Dialog . 94 Capturing the Minimize Request ........................ 94 Window Synchronization . 95 Closing a Window ................................. 95 Resolution-Independent Screen . 95 Setting Minimum Window Size ......................... 96 Closing a Widget from a Script ......................... 96 Removing the Close Menu Option ......................