Inserting an RTF Object Hot Text Interaction Knowledge Object

The RTF Object Hot Text Interaction Knowledge Object inserts an interaction icon in the flowline with hot spot responses for your RTF object. These responses interact with the hot text in your RTF document. See Inserting a hyperlink (hot text) in an RTF document.

The hot spot responses created by the RTF Object Hot Text Interaction Knowledge Object use the rtfGetLinkCoor function to position themselves over the hyperlinks. When the user clicks a hot spot response, meaning when the user clicks an RTF object hyperlink, the Knowledge Object navigates to the IconTitle associated with the hyperlink. This is what is returned by the rtfGetLinkCode function. See RTF functions.

However, what you associate with the hyperlink in the RTF Objects Editor doesn't have to be an IconTitle. It could be something completely different. Basically, rtfGetLinkText returns the visible portion of the hyperlink, and rtfGetLinkCode returns the invisible portion of the hyperlink. The RTF Object Hot Text Interaction Knowledge Object assumes the invisible portion is an IconTitle and navigates to that IconTitle. However, you can modify what is inserted by the RTF Object Hot Text Interaction Knowledge Object, or bypass that Knowledge Object altogether, using the rtfGetLink functions in a calculation icon, and do something completely different when the user clicks a hyperlink.

By default, the RTF Object Hot Text Interaction Knowledge Object navigates to an icon, because in practice, this is what most of the users want it to do. That is why the RTF Objects Editor suggests associating an IconTitle with the hot text when inserting a hyperlink into the document.

To insert an RTF Object Hot Text Interaction Knowledge Object:

1. Create an RTF Knowledge Object. See Creating an RTF Object Knowledge Object.
2. Drag the Insert RTF Object Hot Text Interaction icon from the Knowledge Objects window to the flowline.

   If you have not saved your file, you will be prompted to do so. Click OK, then enter a filename.

   The Insert RTF Object Hot Text Interaction: Introduction screen is displayed.

3. Click Next, or select ID.

   The Insert RTF Object Hot Text Interaction: ID screen is displayed.

4. Enter name of the variable for the RTF Object ID in which you'd like to enter a hot spot interaction.

   The RTF Object ID variable name is identified by an equal sign at the beginning of your entry--for example, =MyVariable.

   This is the object ID for an RTF object previously created using the Create RTF Object Knowledge Object.

5. Click Next, or select Responses.

   The Insert RTF Object Hot Text Interaction: Responses screen is displayed.

6. Specify the number of hot spot responses for your hot text interactions.

   When your piece is running, the responses interact with the RTF object and navigate to the icon specified in your RTF object when the user clicks a hot text response.

7. Click Done, or select Finish.

   The Design window is displayed. An interaction icon, with calculation icons equal to the number of hot spots you specified, is created on the flowline.

8. Edit the interaction and calculation icons on the flowline with the appropriate hot text interaction and responses.

In order for this Knowledge Object to work, you must distribute RTFObject.u32 with your piece. When you click Done or Finish, this Knowledge Object copies the RTFObject.u32 file to the same location as your piece.

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/authorware/7/using_aw_en/05_wor74.htm

Add Comment