Create or edit windows

note:    This procedure applies to Multiscreen HTML5, Adobe AIR, WebHelp, WebHelp Pro, FlashHelp, FlashHelp Pro, and HTML Help.

1)Do one of the following:

In the Output Setup pod (Output > Open > Output Setup), right-click the Windows folder. Select New Window and select the type of layout for which you want to create the window.

note:    The layout must be present in your project.

Click the Create a new window icon on the Output Setup toolbar and select the window type from the drop-down menu.

To create a window for the primary layout, click New Window under Windows in the Output Setup pod.

2)Type a name and caption in the text boxes.

3)Set options. Many of the options are common to all the output types.

Placement

To change placement visually, point and click inside the sample window. To change size visu­ally, point to a border in the sample window. To use exact measurements, in Placement, enter values in Top and Left for the position (percent of the browser window). To resize, enter values in Height and Width.

Windows To Display

Selected windows appear in the preview area of the upper-left corner.

4)Select the options specific to WebHelp Pro and FlashHelp Pro.

5)Click OK.

tip:   For JavaHelp and Oracle Help projects, set navigation pane options when you generate output.

WebHelp, WebHelp Pro, FlashHelp, FlashHelp Pro Options

In addition to the standard Window Properties options, WebHelp Pro provides the following options. In WebHelp Pro and FlashHelp Pro, you can view settings after the project is published to the server.

Buttons

Click the up and Down Arrows to change button order as the buttons appear in the browser. Select the buttons to include. You can customize these buttons or add new buttons using skins.

Set As Default

Click to set the selected button as the default. Contents is the default.

WebSearch

Displays the WebSearch button. This button is available only if enabled in the project.

Browse Sequences

Enables support of browse sequences if you created them. The window contains Previous and Next buttons. Use skins to customize them.

Search Input Field In Toolbar

Adds the Search button to the toolbar. Use skins to customize the Search Input Field.

Use Default Browser Settings

Select to use the user default browser size, toolbars, placement, and other properties. When deselected, the standard browser toolbar, menu, location bar, and status bar are available.

Resizable

Selecting this option lets users resize the window. This setting is available when used with the context-sensitive Help API.

View

Select One Pane to display the topic pane. Select Two Pane to also display the navigation pane.

HTML options

In addition to the standard Window Properties options, HTML Help provides the following options:

Buttons

(HTML Help) Select buttons to display.

Button

Description

Hide/Show

Opens and closes the navigation pane.

Back

Opens the previous topic.

Forward

Opens the next topic in a pre-viewed sequence.

Stop

Stops a web page form displaying.

Refresh

Updates the topic content.

Home

Shows the default web page.

Options

Opens menu access to Home, Show, Back, Stop, Refresh, Print, and Search Highlight On/Off.

Print

From the Contents tab, prints pages, headings, and subtopics or the entire TOC. From the Index or Search tab, opens the Print dialog box.

Locate

Click to synchronize books and pages in the Contents tab with the topics in the right pane. This option differs from Auto-synchronize TOC, which synchronizes books and pages with topics as users view topics.

Jump1

Opens a web page, intranet site (defined with a URL) or help topic (defined by its filename if included in the same file).

Jump 2

Opens a web page, intranet site (defined with a URL) or help topic (defined by its filename if included in the same CHM file).

Tri-pane Tabs And Windows

Select tabs to include in the navigation pane. If you select TOC And Index and the project does not include a TOC, the HTML help viewer does not display the Contents tab.

TOC And Index

Displays the Contents and Index tabs in the navigation pane. A navigation pane requires these tabs. If you do not select this option, the navigation pane options are unavailable.

Favorites

Displays the Favorites tab in the navigation pane.

Glossary

Displays the Glossary tab in the navigation pane.

Search

Displays the Search tab in the navigation pane.

Adv Search

Enables users to search for topics using Wildcard and Boolean characters.

Browse Sequences

Enables support if you have created browse sequences.

Default Tab

Select the tab to display when the HTML Help project opens.

Tab Position

Select a default location for the window tabs.

Tri-pane Options

Set properties for the onscreen appearance and behavior of the panes.

Hide Nav Pane On Startup

Hides the navigation pane. Click Show to open it.

Auto Synchronize TOC

Synchronizes books and pages in the Contents tab with the topic displayed in the right pane. (For this feature to work properly, the Always Show Selection option must be active. To check if it is active, open the single source layout and click Advanced Settings Edit. In TOC Styles, verify that Always Show Selection is selected.) Make sure that the filenames have underscores, not spaces.

Remember Window Size And Position

Notes the last size and position of the viewer.

Auto Show/Hide Nav Pane

Automatically hides the left pane when users switch focus from the HTML Help viewer to a program. The topic content remains visible but the left tabs are temporarily closed from view. These tabs appear as soon as the HTML Help viewer is clicked.

note:   If you select Auto Show/Hide Nav Pane, click Advanced Properties > Extended Styles, and select Top-Most window. This option prevents the right pane from being hidden behind the open application.

Nav Pane Width

Enter the width in pixels. The width to assign depends on the number of window tabs.

Advanced Properties

Specify advanced HTML windows properties on the Destinations, Styles, and Extended Styles tabs. Some options require coding in the application.

Advanced window Destinations properties

Default

Assign default topic.

Home

Define the URL to display when clicking Home.

Table Of Contents

Assign an alternate contents file (.HHC).

Index

Assign an alternate index file (.HHK).

Button 1 Label

Assign a label to Button 1.

Custom Button 1

URL defines the destination for Button 1.

note:   Custom 1 button does not reference external CHM files if Internet Explorer 5.5 is installed.

Button 2 Label

Assign a label to Button 2.

Custom Button 2

URL defines the destination for Button 2.

Advanced window Styles properties

System Menu

Includes a system menu. Window style ID is WS_SYSMENU.

Minimize Box

Includes a minimize box. Window style ID is WS_MINIMIZEBOX.

Maximize Box

Includes a maximize box. Window style ID is WS_MAXIMIZEBOX.

Clip Siblings

Specifies whether the window covers other sibling windows. Window style ID is WS_CLIPS­IBLINGS.

Clip Children

Specifies whether the window covers other children windows. Window style ID is WS_CLIP­CHILDREN.

Vertical Scroll

Includes a vertical scroll bar. Window style ID is WS_VSCROLL.

Horizontal Scroll

Includes a horizontal scroll bar. Window style ID is WS_HSCROLL.

Popup

Uses pop-up menu windows. Window style ID is WS_POPUPWINDOWSTYLE.

Minimize

Minimizes application when window is open. Window style ID is WS_MINIMIZE.

Maximize

Maximizes application when window is open. Window style ID is WS_MAXIMIZE.

Border

Displays border around window. Window style ID is WS_BORDER.

Dlg Frame

Displays window in a dialog frame. Window style ID is WS_DLGFRAME.

Visible

Creates a visible window. Window style ID is WS_VISIBLE.

Thick Frame

Displays window using a thick frame style. Window style ID is WS_THICKNESS.

Disabled

Disables a window so that it does not accept user input. Window style ID is WS_DISABLED.

Advanced window Extended Styles properties

Tool Window

Sets the window for use as a floating toolbar. Window style ID is WS_EX_TOOLWINDOW.

Client Edge

Creates a 3D border with a sunken edge. Window style ID is WS_EX_CLIENTEDGE.

Static Edge

Creates a 3D border for windows that does not accept input. Window style ID is WS_EX­_STATICEDGE.

Transparent

Makes the window transparent. Window style ID is WS_EX_TRANSPARENT.

Accept Files

Lets the window accept drag-and-drop files. Window style ID is WS_EX_ACCEPTFILES.

Control Parent

Lets users navigate among child windows using the Tab key. Window style ID is WS_EX_­CONTROLPARENT.

Context Help

Adds a clickable question mark to the title bar that changes the cursor to a question mark pointer. Clicking in a child window then displays a WM_HELP message. Window style ID is WS_EX_CONTEXTHELP

Right-to-Left Order

Displays window text using the right-to-left reading order properties. Window style ID is WS_EX_RTLREADING.

No Parent Notify

Specifies that a child window does not send the WM_PARENTNOTIFY message to its parent window when created or destroyed. Window style ID is WS_EX_NOPARENTNOTIFY.

Right -aligned Text

Specifies generic right-aligned properties. Window style ID is WS_EX_RIGHT.

Left Scroll Bar

Places a vertical scroll bar left of the client area. Window style ID is WS_EX_LEFTS­CROLLBAR.

Top-most Window

Places the window above all non-topmost windows, even when the window is deactivated. Applications can use the SetWindowsPos member function to change this position. Window style ID is WS_EX_TOPMOST.

To test this feature, generate and view the CHM file. When the HTML Help viewer opens, select a window. The viewer remains the topmost window.

Adding HTML buttons

You can add extra buttons that link to intranet, websites, and HTML pages. You can add a home button and two jump buttons to any URL. These buttons appear at the top of the HTML Help viewer.

Add a home button

1)In Windows Properties, click Buttons > Home.

2)Click Advanced Properties.

3)On the Destinations tab, in Home, enter the URL.

4)Click OK > OK.

Add a jump button

1)On the Windows Properties dialog box, select Button 1.

2)Click Advanced Properties.

3)On the Destinations tab, in the Button 1 label, enter label text for the icon displayed in the window (optional).

4)In Custom Button 1 URL, enter the link website address.

5)Click OK > OK.

Notes:

Custom windows without a navigation pane do not support custom buttons. If you select options such as Back, Forward, or Hide/Show, these buttons do not appear when you test Help topics.

Website links to custom windows must include the tri-pane design (navigation pane).

From the HTML Help viewer or window, Home buttons and URLs look like the following:

Home home_ico.png

Button 1 jump1_ico.png

Button 2 jump2_ico.png


September 30, 2016

Legal Notices | Online Privacy Policy