Adding a Help Menu ItemGeneral RemarkThe easiest way to integrate a helpset is via JHelpAction. Almost always you might want to add a help menu item to your application's menubar to invoke the help viewer. This is just a suggestion, how you could do that. Code ExampleThis example assumes, that you have created a helpset
import javax.help.*; import javax.swing.*; import java.net.*; private static HelpBroker mainHelpBroker = null; private static CSH.DisplayHelpFromSource csh = null; private static final String mainHelpSetName = "helpset/Help.hs"; private JMenuItem helpItem = null; . . public void initialize(){ helpItem = new JMenuItem("Help"); // add the helpItem to the menubar . . // try to find the helpset and create a HelpBroker object if (mainHelpBroker == null){ HelpSet mainHelpSet = null; try { URL hsURL = HelpSet.findHelpSet(null, mainHelpSetName); if (hsURL == null) System.out.println("HelpSet " + mainHelpSetName + " not found."); else mainHelpSet = new HelpSet(null, hsURL); } catch (HelpSetException ee) { System.out.println("HelpSet " + mainHelpSetName + " could not be opened."); System.out.println(ee.getMessage()); } if (mainHelpSet != null) mainHelpBroker = mainHelpSet.createHelpBroker(); if (mainHelpBroker != null) // CSH.DisplayHelpFromSource is a convenience class to display the helpset csh = new CSH.DisplayHelpFromSource(mainHelpBroker); } // listen to ActionEvents from the helpItem if (csh != null) helpItem.addActionListener(csh); . . . } |