There is no embeddedHandler part. Rather, a topic describes use of a
variable (named embeddedHandler in the example). That variable is based
on another Rich UI handler.

Here is the most recent content, from
http://www.ibm.com/software/rational/cafe/docs/DOC-2689 .

Regards, Saul Ben Margolis


You can use multiple Rich UI handler parts to compose a single
application. However, we do not mean to say that you embed one handler
part in another. Instead, the handler part declares variables that are
each based on another handler part. A variable based on an Rich UI handler
part is called an embedded handler, as in the following example:

embeddedHandler AnotherHandlerPart{}; // declared Rich UI handler
(based on part
The embedding Rich UI handler can access the global widgets and public
functions declared in an embedded Rich UI handler. In particular, the
embedding handler can add widgets to its own initialUI and children
arrays. Also, you can embed a handler that invokes services or otherwise
handles business processing. A reasonable practice is to use one handler
to present the UI and to use other handlers to oversee the backend,
business processing.
You access widgets and functions with a dot syntax. In the following
outline, the Handler part AnotherHandlerPart is assumed to have declared a
button named itsButton, which is attached to the DOM tree only when that
button is included in the initialUI array of the embedding handler:

handler SimpleHandler type RUIHandler { initialUI = [
embeddedHandler.itsButton ] }
embeddedHandler AnotherHandlerPart{};
Similarly, you can add an embedded widget to a children array.
You can access a function or property in an embedded widget by extending
the a dot syntax. For example, the following statement retrieves the
displayed text of the embedded Button itsButton:

myString STRING = embeddedHandler.itsButton.text;
The initialUI array of the embedded handler has no effect at run time.
That array is used only when the embedded handler is the basis of a Rich
UI application and is not embedded at all.

Sent by: egl-i-bounces@xxxxxxxxxxxx
01/22/2009 01:00 PM
Please respond to


EGL-i Digest, Vol 2, Issue 6

Send EGL-i mailing list submissions to

To subscribe or unsubscribe via the World Wide Web, visit
or, via email, send a message with subject or body 'help' to

You can reach the person managing the list at

When replying, please edit your Subject line so it is more specific
than "Re: Contents of EGL-i digest..."

Today's Topics:

1. embeddedHandler question (tim)


message: 1
date: Thu, 22 Jan 2009 11:17:40 -0500
from: "tim" <tim2006@xxxxxxxxxxx>
subject: [EGL-i] embeddedHandler question

Has anyone used this part yet. Im looking for a why and how on this. I am
creating rui projects with multi RUIHandler's. Should I be using the
embeddedhandler instead?


EGL-i mailing list

End of EGL-i Digest, Vol 2, Issue 6

As an Amazon Associate we earn from qualifying purchases.

This thread ...


Follow On AppleNews
Return to Archive home page | Return to MIDRANGE.COM home page

This mailing list archive is Copyright 1997-2022 by midrange.com and David Gibbs as a compilation work. Use of the archive is restricted to research of a business or technical nature. Any other uses are prohibited. Full details are available on our policy page. If you have questions about this, please contact [javascript protected email address].

Operating expenses for this site are earned using the Amazon Associate program and Google Adsense.