A-Link/Shg Work-Around

Subject: A-Link/Shg Work-Around
From: "Wing, Michael J" <mjwing -at- INGR -dot- COM>
Date: Sat, 13 Jul 1996 09:22:54 -0500

A couple of weeks ago I posted a message asking if anyone had
successfully executed A-Links from a SHG file. After many variations, I
have not been able to execute an ALink from the SHG macro call; however,
I have a work-around.

My situation is as follows:

The main help window contains the topic's description. Directly to the
right is a hypergraphic (SHG) depicting a hierarchy hierarchy (I
document O-O automation so a hierarchy may be
Application-Documents-Document). Each of the items displayed in the
diagram is linked to display the selected topic description in the main
window. In turn, the main window has a start-up macro that puts the
correct hypergraphic into the secondary window.

My need for an ALink in the hypergraphic arose when an item in the
hierarchy could branch to two or more topics (such as the Document
object extending to a MSWord file, Excel file, or a PowerPoint slide).
Furthermore, the number of objects that branch from the hyperlink
depends on the user's configuration. They may have 3, 4, or more
applets (each with their own help file) which branch from this link and
could add others later. Thus, the need for a dynamic link instead of
creating links for each branch.

To resolve this, I created a dummy topic which invoked an A-Link
start-up macro. This worked except that the main window resized (about
half of its designed size). Also, if the user decide to opt out of
following the link, the main topic and hypergraphic were blank.
Therefore, I strung four macros together in the dummy topic. The first
two reloaded the secondary and main windows with their original topics,
the third performed the Alink, and the forth sized the main window to
its designed settings. The syntax is as follows:

Alink(`MultipleBranchTopicALinkTerm', 1, "IfNotFoundTopic", main);

Mike Wing
_/ Michael Wing
_/ Principal Technical Writer
_/ Jupiter Customization and Educational Services
_/ Intergraph Corporation
_/ 730-7250
_/ mjwing -at- ingr -dot- com

TECHWR-L List Information
To send a message about technical communication to 2500+ list readers,
E-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send administrative commands
ALL other questions or problems concerning the list
should go to the listowner, Eric Ray, at ejray -at- ionet -dot- net -dot-

Previous by Author: Re: Frame Deficiencies
Next by Author: Re: Who "owns" design documentation?
Previous by Thread: Re: TECHWR-L Digest - 11 Jul 1996 to 12 Jul 1996
Next by Thread: Tips for setting up internships with industry

What this post helpful? Share it with friends and colleagues:

Sponsored Ads