Show/Hide Navigation Button for WebWorks Help 5.0

Abstract

This page outlines a Format override for a Show/Hide navigation button for WebWorks Help 5.0.

Usage Notes

Download the attached zip file and extract the contents to an existing WebWorks Help 5.0 project.

NOTE: The format override uses icons from the Classic skin. To replicate these icons for another skin, open the wwhelp/wwhimpl/common/images/shownav.gif in a Graphics Editor. Save it over the one in Formats/WebWorks Help 5.0/Files/wwhelp/wwhimpl/common/images as show.gif. Then in your Graphics Editor, flip the image 180 degrees and save it over the one in Formats/WebWorks Help 5.0/Files/wwhelp/wwhimpl/common/images.

Download

ShowHideButton.zip

Fix Needed

(BrentGossett, 2007.11.28) The show and hide images were reversed as implemented in the download. To make this override work properly, I had to make the following changes:

1. In Targets\WebWorks Help 5.0\Files\wwhelp\wwhimpl\common\scripts\controls.js, swap all show.gif and hide.gif references (lines 298, 784, and 805). Here's the fix on line 298:

// Create control entries
//
this.fAddControl("WWHShowHideIcon", (!this.fSansNavigation()), false,
                 "Show/Hide Navigation",
                 "hide.gif", "hide.gif", "fClickedShowHide", "WWHControlsLeftFrame");

(By the way, if you want to make the tooltip reference the value in the message.xml file where it can be localized, change the string "Show/Hide Navigation" above to "WWHFrame.WWHHelp.mMessages.mShowNavigationIconLabel" (no quotes). Then in Targets\WebWorks Help 5.0\Files\wwhelp\messages.xml, change the value attribute of all the StaticString elements whose key attribute is ShowNavigationIconLabel to "Show/Hide Navigation". Would be better if you could use two independent strings, one to say "Show Navigation" and another "Hide Navigation", but that would require changes to the logic.)

2. Make sure your Targets\WebWorks Help 5.0\Skins\<skin_name>\Files\wwhelp\wwhimpl\common\images\shownav.gif file is the same as the Targets\WebWorks Help 5.0\Files\wwhelp\wwhimpl\common\images\show.gif. The shownav.gif file is the image that's used when the window opens in topic-only view (i.e. via a context-sensitive call), not the show.gif file.