The Bookmark Menu

Commands on the Bookmark menu create and remove bookmarks placed at specific Help topics. The Bookmark menu initially contains one command: Define. As users define bookmarks, they are added to the menu until a total of nine appear. Help then adds a More command to give the user access to the additional bookmarks.

Define

The Define command places a bookmark in the Help file at the current topic or removes a bookmark from a topic. Just as you can place bookmarks in a book to mark specific references, you can place bookmarks at Help topics you use frequently. When you place a bookmark at a topic, you can get that topic quickly from Help’s Bookmark menu.

In the Bookmark Define dialog box, you can type the name you want to assign to the bookmark, edit the suggested name, or delete a bookmark. When you define a bookmark, Help suggests the topic title as the bookmark name. You can use the default name or type your own name in the edit box. If the topic does not have a title, you must type your own bookmark name for it. When you save the bookmark, Help adds the bookmark name to the Bookmark menu and records the topic title and the user’s location within the topic for future reference. The Delete button in the dialog box lets you remove any bookmark that appears in the bookmark list box.

After you define a bookmark, you can choose the bookmark name from the Bookmark menu to move directly to the topic.

Help saves all user-defined bookmarks in the WINHELP.BMK file. Bookmarks are saved to a global file to make it easy for users to return to any marked location in any Help file. Help stores WINHELP.BMK in the user’s Windows directory. Bookmarks remain in effect between Windows Help sessions.

Bookmarks may or may not be compatible across different versions of a product. For example, if a user upgrades the Windows Help application from version 3.0 to version 3.1, all defined bookmarks will remain valid. However, if a user upgrades the Help file that uses the bookmarks, the bookmarks may become invalid. If the new Help file has many changes—added and removed topics—the bookmarks will go to the wrong places. Therefore, it is best to remove a user’s .BMK file when your setup program installs a new version of the Help file.

To place a bookmark at the current topic

1.1.From the Bookmark menu in Help, choose Define.

2.The Bookmark Define dialog box appears (Figure 1.19).

3.2.Type the name you want to give to the bookmark in the Bookmark Name box, and then choose OK.

Or just choose OK to use the topic title as the bookmark name.

The bookmark name now appears on the Bookmark menu in Help (Figure 1.20).

To remove a bookmark

1.1.From the Bookmark menu in Help, choose Define.

2.2.Select the bookmark you want to remove.

Or type the bookmark name in the edit box.

3.3.Choose the Delete button.

The bookmark name is removed from the bookmark list box and from the Bookmark menu.

Bookmark Names

After a user defines a bookmark, its name appears on the Bookmark menu so that the user can go directly to the bookmarked topic. The first nine bookmarks are listed on the Bookmark menu in the order that they are created. The number appearing to the left of the item name provides the keyboard access.

To go to a bookmarked topic

1.nFrom the Bookmark menu, choose the name of the bookmarked topic you want to view.

Underlined numbers precede the first nine bookmark names. You can press the corresponding number key to go quickly to a marked topic.

More

The More command appears as the last item on the Bookmark menu when you have defined more than nine bookmarks.

Choosing More displays the Bookmark dialog box, which contains a list of all the bookmarks you have defined in the current Help file. Help selects the first item in the bookmark list when the dialog box opens.

To choose from the complete list of bookmarked topics

1.1.From the Bookmark menu in Help, choose More.

The Bookmark dialog box appears (Figure 1.21).

2.2.In the Go To Bookmark box, double-click the name of the bookmarked topic you want to view.

Or select the bookmark name, and then choose OK.