PDFlib Text Extraction Toolkit (TET) Manual

3.11 REALbasic Binding
Installing the TET edition for REALbasic. TET for REALbasic (TET.rbx) must be copied to a
folder called Plugins in the same folder where the REALbasic application lives. TET for
REALbasic is delivered in a single package and contains the following variants:
> OS X Carbon (PowerPC and Intel)
> Windows
> Linux
This means that you can use the OS X or Windows version to build applications for all
supported platforms. When a stand-alone application is generated, REALbasic selects
the appropriate parts of TET and includes only the platform-specific portion(s) in the
generated application.
Additional REALbasic classes. TET adds two new classes to REALbasic’s object hierarchy:
> The TET class contains all TET API methods.
> The TETException class, which is derived from RuntimeException, can be used to deal
with exceptions thrown by TET (see below).
TET can be used to create GUI applications as well as console applications. Since TET is
not a control it does not install a new icon in REALbasic’s control palette. However,
when TET is available, REALbasic will be aware of the TET class and its associated methods.
For example, statement completion and parameter checking fully work for TET API
methods.
Error handling in REALbasic. In case of an exception TET will throw a native REALbasic
exception of the class TETException. TET Exceptions can be handled with standard REALbasic
techniques: either use a try/catch block (this is recommended, but requires REALbasic
5.5 or above), or handle them in an Exception block. The latter is demonstrated in
the following code fragment:
Exception err As TETException
MsgBox("TET exception occurred in extractor sample: [" + _
Str(err.get_errnum()) + "] " + err.get_apiname() + ": " + err.get_errmsg())
As shown in this example, REALbasic developers can access detailed error information
by using the TETException methods for retrieving error number, error message, and the
name of the API function which raised the exception.