Realbasic V5.5.5 Language Reference

REALbasic Language Reference Documentation by Dave Brandt, © 1998-2004 by REAL Software, Inc. WASTE text engine © 1993-2004 Marco Piovanelli All rights reserved. Printed in U.S.A. Mailing Address REAL Software, Inc. 1705 South Capital of Texas Highway Suite 310 Austin, TX 78746 Web Site http://www.realsoftware.com ftp Site ftp://ftp.realsoftware.com Support REALbasic Feedback at the REAL Software web site. Bugs/ Submit via REALbasic Feedback at the REAL Software Feature Requests web site. Database Plug- REALbasic CD-ROM; the most current versions at ins www.realsoftware.com Sales sales@realsoftware.com Phone 512-328-REAL (7325) Fax 512-328-7372 Version 5.5.3, August, 2004. 2 REALbasic Language Reference Introduction The Language Reference gives you fast access to information about all the REALbasic language elements: objects, keywords, operators, constants, error messages, runtime exceptions, built-in methods and functions, and so forth. Wherever applicable, the properties and methods belonging to an object are documented, along with cross- references to related objects. There is also a Quickstart, a Tutorial, and User’s Guide which teach REALbasic programming concepts. Your comments (both favorable and unfavorable) are welcome. Send them to docs@realsoftware.com. Conventions Property names in bold are read-only at runtime. This means that your code can read their values but cannot change their values. Optional Parameters in syntax statements are surrounded by brackets- [ ]. Items in blue underline (in the PDF version of the Language Reference) are hypertext links to other parts of the document. In some cases, code that is irrelevant to the example is omitted for sake of clarity. Omitted code is indicated by bullets. The Class Hierarchy Objects in REALbasic are arranged in a hierarchy. This means that an object inherits the properties, methods, and events of its super class (the classes above it in the hierarchy) and may contain properties, methods, and events that are unique to the object. A PushButton for example, is a subclass of a RectControl, which is a subclass of Control, which is a subclass of Object (the base class for all objects). You can only access their subclasses. The complete object hierarchy is presented in several pages. Object classes in bold are not directly accessible. The subclasses of Object are shown in alphabetical order and the subclasses of Control, RuntimeException, SocketCore, and the classes related to XML are shown in separate diagrams. REALbasic Language Reference …